测试驱动的技能写作
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/qodex-ai-ai-agent-skills-capability-documentation。
技能介绍
要解决什么问题
给 Agent 写 SKILL.md 时,很多人凭直觉堆砌规则,结果模型在压力情境下仍会找借口绕过——你没见过「没有技能时的基线失败」,就说不准文档到底教对了没有。本技能把测试驱动开发映射到流程文档:技能是可复用的手法、模式或参考,而不是某次攻坚的故事。
技能如何工作
核心循环与 TDD 一致:RED 用子 Agent 跑压测场景(时间、沉没成本、权威、疲劳等可组合),在无技能前提下记录选择与辩解原文;GREEN 只写针对这些违例的最小 SKILL.md,再跑同场景验证服从;REFACTOR 发现新借口就显式封堵并复测。不同类型技能测法不同:纪律类考学术题 + 重压合规,技法类考应用与缺口,模式类考识别与反例,参考类考检索与应用。
目录与写作上采用扁平命名空间,重物与可复用脚本拆文件;交叉引用其它技能用名称 + REQUIRED BACKGROUND,避免 @ 强载烧上下文。流程图仅用于非显然分支,示例追求「一条可跑、说清 WHY」而非多语言稀释。
边界与注意
使用前须理解 superpowers:test-driven-development。铁律:未先测就写技能或改技能,应删掉重来——「简单增补」「只加一节」不算例外。每完成一个技能必须走完部署清单,不得批量连写不测。项目独有约定应放在 CLAUDE.md,不要做成技能。
使用场景
- 新建纪律类技能(如先测后写代码)前,要用子 Agent 无文档跑重压,收集违例借口再动笔
- 技法类 SKILL 写完后,用变体场景检查 Agent 能否在无缺口说明下正确套用步骤
- 发现 Agent 总说「按精神执行」绕过条文时,补原则段、辩解表与红旗自检再复测
- 参考类技能上线前,用检索+应用场景验证常见 API 用法是否找得到、用得对
适合人员
- 维护 Claude/Codex 个人技能目录、需把可复用模式沉淀成文档的工程师
- 给团队写 Agent 纪律规范、担心高压对话下模型仍会跳过的技能作者
- 从 Qodex/SkillHub 分发能力说明、要保证文档可被其它实例稳定复现的维护者
- 已掌握 TDD 红绿重构、想把同一套流程迁到文档质量上的平台内技能编辑