用途:在 better-skills 工具包中从零构建新的 agent 技能,是“构建工具的元技能”。它强制完整生命周期:理解问题、检查是否已有可引用的上游技能、从模式库选择模式、起草 SKILL.md、编写测试提示、运行校验、通过 4 道审核门并注册到 skills.json。
主要能力与硬性规则:校验前不得输出最终 SKILL.md;必须从 docs/patterns/README.md 引用至少两个模式并注明依据与来源;深度层级只能取 deep、standard、lightweight;每个技能必须带至少 3 条测试提示(正常路径、边界、对抗);任何校验失败都要向用户明确报告,不得静默跳过;validate.sh 零失败前不得注册。采用 TDD:RED(先写测试提示并确认无技能时失败)→ GREEN(写技能、校验、确认提示通过)→ REFACTOR(收紧约束、补边界)。命名须检查冲突,自研技能 ID 和目录以 bs- 前缀,外部引用保留原名。
使用方式:按步骤执行。Step 0 查 external/sources.yaml 做“引用还是自建”判断;Step 1 依次询问问题、触发条件、交付物、边界;Step 2 选择层级;Step 3 选 3-5 个模式;Step 4 起草 SKILL.md,含 Hard Rules、Red Flags、Purpose、Boundaries、Workflow、Patterns、Dependencies、Platform Degradation、Test Prompts、Registration;Step 5 写测试提示(参考 references/tdd-for-skills.md);Step 6 运行 bash tools/validate.sh skills/<skill-name>,最多 5 次,超限需停下询问用户;Step 7 过 4 道审核门(自审、同伴评审、模式对齐、基线测试),记录到 docs/reviews/<skill-name>/YYYY-MM-DD-review.md;Step 8 更新 skills.json 并移除脚手架。
适用场景:需要新建符合 better-skills 约定的技能时。
限制:不修改已有技能、不做部署后质量评估、不策展或同步外部技能、不替代 4 道审核门;仅对确认的工具缺陷可豁免校验门。batch 归属等细节资料未提供。