用途:指导编写、拆分、重命名或修复一个 agent skill,使其在应当触发时被正确激活,并且可被证明有效,而非仅凭信任。核心原则:不激活的技能等于无效,没有人观察过其失败的技能无法证明任何东西。已有但表现不佳的技能属于 optimising-skills 处理范围,本技能负责其结构修复与撰写。
主要能力:通过一张“门禁表”按信号定位需阅读的规则文件(如 activation-surface、gate-not-checklist、one-rule-one-decision、readable-in-one-pass、prove-it-with-checks、prove-a-measure、order-and-strength、name-and-scope、states-carry-licenses、portable-by-default)。规定 skill 构成:SKILL.md 承载 frontmatter、核心原则与门禁;rules/<name>.md 每文件一个决策,含 Decision、Use when、Do、Avoid、Verify 五个块;evals/*.scenarios.mjs 承载正负激活场景。允许三种结构:routed、flat、multi-topic。给出预算限制:单条规则正文 450 词内、阅读 600 内、24 至 70 行;入口少于 160 行且门禁行数不少于规则数;描述接近 500 字符、上限 700。
使用方式:按门禁表匹配信号后进入对应规则,先读全部行再按最难撤销者优先行动;默认先修激活面。验证命令包括 node tools/verify-skill.mjs skills/<name>、node tools/mutate-skill.mjs skills/<name>、node tools/readability.mjs --skill skills/<name>、node tools/check-yaml-parity.mjs。
限制:缺失场景套件应报告为 UNPROVEN,而非通过;检查须亲眼看到因自身原因失败才可称良好;用户直接指令优先于本技能;任务是否需要 skill 不由本技能决定。部分工具细节与依赖环境资料未提供。