技能介绍

解决什么问题

Agent 技能文档常见的问题是写得“看起来清楚”，但代理在压力下仍会找理由绕过规则；一次性叙事、多语言示例和线性步骤流程图，也会让技能难检索、难执行。test2 把技能写作当作 TDD：先运行没有技能的基线场景，观察代理如何失败，再只写针对这些失败的最小文档，最后通过重复测试堵住新漏洞。

技能如何工作

RED：用 subagent 运行多个组合压力场景，例如时间、沉没成本、权威、疲劳；记录代理的原始措辞、选择路径和触发点。
GREEN：只覆盖已经暴露的问题，避免为假想场景堆内容；SKILL.md 需要清晰 description、触发条件、核心原则和可执行约束。
REFACTOR：每发现一个“我遵循精神”“只是简单补充”等借口，就加入显式反例、红旗清单和 CSO 症状说明。
按类型测试：规则型技能重点测纪律压力，technique 测应用与边缘，pattern 测识别与反例，reference 测检索和正确引用。

适用边界

适合给 Claude Code、Codex 等代理编写可复用技能，尤其是 TDD、验证、调试和流程约束类文档；不适合一次性项目约定、可用正则或校验自动化的机械规则，也不适合没有基线测试就批量产出。文档应以一个高质量示例优先，避免多语言稀释；重参考或可复用脚本可拆分文件，但不应引入无语义的流程标签。