skill-sublation
技能扬弃 Sublation V5.0 完整版。把执行经验沉淀为观测、候选、验证、多 Agent 协作面板、默认关闭的受控唤醒意图、Skill 分类与 shadow 精准建议、用户批准、晋升和观察窗的可审计治理链路;仅在用户明确说出 sublation 或扬弃技能时触发。
Sven-Mirana · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Sven-Mirana/sublation --skill skill-sublation技能说明
name: skill-sublation description: 技能扬弃 Sublation V5.0 完整版。把执行经验沉淀为观测、候选、验证、多 Agent 协作面板、默认关闭的受控唤醒意图、Skill 分类与 shadow 精准建议、用户批准、晋升和观察窗的可审计治理链路;仅在用户明确说出 sublation 或扬弃技能时触发。 license: MIT metadata: version: "5.0.0" slug: skill-sublation displayName: "技能扬弃 Sublation V5.0" release_profile: full-public language: zh-CN
Skill Sublation v5.0
Sublation 是技能治理宪法,不是自动改技能的捷径。
V5.0 在既有治理链上增加三项能力:项目本地、可限缩或拓展的多 Agent 协作面板;默认关闭且带受控关窗的 Agent 自动唤醒意图层;晋升后随 Skill 携带、由 central router 统一解释的分类画像与精准建议 shadow。三项能力都不改变权限边界:面板席位不等于治理复核授权,唤醒意图或 claim 不等于 Agent 已运行或已回复,路由建议不等于宿主选择,更不等于 Skill 已被调用。V5 候选不安装真实 host adapter、launchd 或 cron;没有另行集成和授权时始终保持关闭。
它处理的核心矛盾是:Agent 会在执行中发现技能缺陷、边界裂缝和可吸收经验,但正式技能不能被即时、静默、无证据地改写。因此所有改进必须先进入候选层,用证据证明价值,再由用户守住生产门。
标准链路:
Observation -> Candidate -> Validation -> Review-seat reports
-> Coordinator unified brief -> User decision
-> Promotion -> Observation window -> Closure
1. 宪法
1.1 三条根本原则
-
所有 skill 开发都必须走 sublation 全链路 创建、修改、吸收、合并、拆分、删除、发布前清理,都必须留下观测、候选、审计、复核、用户决策、回滚和观察窗证据。小改动可以批处理,但不能绕过账本。
-
sublation 必须自我扬弃 sublation 不是只管别人的治理工具。它自身也是被治理的对象。每次流程暴露裂缝,都要回流为框架改进,并记录在
references/sublation-self-evolution.md。 -
不是管别人,是先被管 参与治理的 agent 在要求其他 skill 接受治理前,先接受同一套约束。默认本地席位是 Hermes、Codex、Claude Code;其他部署可以换成自己的 agent,但 builder、independent verifier、reviewer 默认必须是三个不同 actor。只有用户对当前 run 显式授权,才允许单代理模式,并且必须在
review_policy中披露证据密度下降。自报“已完成”不算证据;grep、read-back、diff、hash、audit、fixture 才算证据。
1.2 扬弃的判定
扬弃不是“又多一个候选”,而是旧能力被保留,同时出现可证明的正向增量:
- 能力更强或覆盖更广;
- 边界更清;
- 稳定性、安全性或可维护性更高;
- 治理质量提升;
- 旧 workflow 有 fallback 或明确的用户批准。
没有正向增量,最多记录 observation;退化不叫扬弃。
1.3 经验不是权威
任何 agent、外部评估器、benchmark、scorecard 都只能提供证据,不能替代用户决策。晋升权只属于用户,除非用户在当前任务中明确委托 Agent 执行已批准的低风险合入。
2. 硬边界
2.1 正式技能默认只读
Agent、cron、外部评估器不得自行修改 active skill path 下的 SKILL.md、scripts/、schemas/、references/。正式路径只能在用户明确批准晋升或回滚后被写入。
2.2 候选层自由
候选副本放在:
~/.hermes/sublation/candidates/<skill>/<candidate-id>/
候选目录不得出现在 active profile 的技能搜索路径中。候选可以自由实验,但必须声明 scope/out_of_scope,并保持可回滚。
2.3 合法晋升模式
validation.promotion_mode 只允许:
human_patch:用户手工合入;user_delegated_agent_patch:用户在当前任务中明确授权 Agent 合入;rollback:按 rollback point 或 manifest 恢复。
cron 最多创建观测、候选、报告和提醒;不能自动晋升。
2.4 删除和吸收
删除 donor skill、改 alias、改变 active profile、或把 donor 能力吸收到 umbrella skill,都必须有用户批准。候选层可以提出删除或吸收计划,但不能直接执行。
2.5 禁止的外部能力
外部评估器默认只读。发现以下能力必须阻断或隔离:
- optimizer 自动改写正式技能;
- iterative loop 写原始文件;
- sync/pull 覆盖本地正式目录;
load_skill或 active profile 注入;- 读取、保存或转发用户凭据。
外部评估只进入报告,不进入 authority。
2.6 Central Router 不是授权或执行面
跨技能分类由正式 skill-sublation 单点持有、版本化的 central router 负责;普通 Skill 只携带自己的 routing.json,不得私带或覆盖 router。central router 生成的索引只是基于元数据的治理路由画像,不是 Hermes、Claude Code、Codex 或其他宿主的 active catalog,也不决定某个 Skill 已安装、可用或有权执行。
当前路由候选严格 shadow-only:只允许构建 shadow 索引、给出可解释建议和写入脱敏观测,不改变宿主原有选择,不加载或调用被推荐 Skill,不授予文件、网络、凭据、安装、晋升或执行权限。schema 或内部函数中保留的 live 值只是未来兼容位;没有单独候选、宿主集成复核和用户明确批准,不得使用或解释为已启用。
fallback_target=legacy_catalog 或 fallback_used=true 只是交给宿主的控制信号,不等于旧 catalog 已被真正调用。每个宿主必须有自己的 adapter 捕获缺失、损坏、漂移、超时、崩溃和低置信结果,实际回到该宿主原有 catalog;adapter 还必须继续执行宿主自身的 disabled/platform/dependency/quarantine/precedence/permission/safety 规则。没有 adapter 的 CLI/fixture 结果只能算离线证据,不能称为运行闭环。完整边界见 references/skill-routing-shadow.md。
默认关闭的最小 host-shadow 适配层见 scripts/host_shadow_adapter.py 与 references/host-shadow-adapter.md。它拒绝原始提示词,只接受已复核索引派生的封闭词表特征 ID 或冻结的 39 条合成样本 ID;无论建议如何都必须保持宿主原选择,且不得执行 Skill。该适配层仍是隔离候选,没有写入或挂接任何正式宿主。
2.10 Screening Conservatism Trap
The most common screening failure mode is premature closure — declaring "only N candidates are worth it" after only one pass through the skill list. The user may push back with "多筛选几批" (screen more batches), which is a signal that the screening was too conservative.
Pitfalls:
- Skipping skills because they "look well-maintained" without checking if they already have sublation artifacts (PORT_NOTES.md, inventory.md, observability)
- Dismissing skills as "already consolidated" without verifying that the consolidation went through the sublation governance framework
- Filtering out skills with moderate script counts (5-15) that have extractable governance patterns
- Stopping at the first pass instead of re-scanning with relaxed criteria
Correct pattern:
- First pass: strict scoring (scripts + API + tests)
- Second pass: relaxed — include moderately-scored skills, check for consolidation status
- Third pass: any skill with ≥1 actionable improvement (PORT_NOTES gap, inventory gap, observability gap)
- Present the expanded pool; let Claude Code/Codex weigh in
- User's "多筛选几批" is authoritative — keep going until they're satisfied
Reference: references/quantitative-skill-screening.md
2.10a Lane-Based Batch Screening For Tool Clusters
When the user asks to screen a specific tool cluster (e.g., crawlers, browsers, media tools), quantitative script-density scoring alone produces too many false positives. Skills within the same cluster are not competitors — they occupy different layers or platforms. The correct approach is lane-based grouping before any merge proposal.
Method:
- Scan the cluster: list all installed skills in the tool class (e.g., all crawler/browser/downloader skills)
- Cross-check across all agent roots:
.hermes/skills,.codex/skills,.claude/skills,.agents/skills - Group into lanes by function layer, not by script count:
- Example crawler lanes: browser/anti-bot lane (scraping, obscura, browser-harness, agent-browser) vs media download lane (douyin-batch, universal-downloader, media-toolkit) vs social capture lane (twitter-monitor, wechat-article-fetch, canghe-x-to-markdown)
- For each lane, decide treatment:
- Merge: skills are functional duplicates at the same layer → propose superset merge
- Donor boundary: one skill already absorbs others by byte-identical copy → make it main entry, keep donors as backends
- Keep distinct: skills at differ