skill-builder

name	skill-builder
description	为 creator.skill 创建或重构技能目录。用于扩展明确且不与现有技能重叠的能力边界；按统一 Prompt 契约、三层目录和行为用例构建可触发、可验证、可阻断的技能包。

技能构建技能 (skill-builder)

Purpose

建立职责明确、可触发、可验证并与三路由及风险门禁一致的可复用技能，而不是增加百科式说明。

Trigger

• 新能力无法由现有 Skill 合理承担。
• 现有 Skill 需要重构其触发边界、契约或验证方式。
• 纯文案调整或通用 Agent 行为不需要新 Skill。

Required context

• 当前 AGENTS.md。
• 1～2 个职责最接近的现有 Skill 及阶段契约。
• 新能力的触发/非触发场景、输入、输出、合格标准和红线。
• 至少一个正例、一个边界反例和可自动检查的行为用例。

Workflow

1. 先证明职责不与现有 Skill 重叠，并确定三路由中的位置。
2. 创建 SKILL.md、agents/openai.yaml 和必要的 references/stage-contract.md。
3. SKILL.md 使用 Purpose、Trigger、Required context、Workflow、Output、Stop or escalate、References 七个统一章节。
4. 将详细模板、检查表和 Examples 放入阶段契约，入口保持短而明确。
5. 更新 Prompt 用例集、YAML 展示信息和相关文档。
6. 运行结构校验、YAML 解析、Prompt 契约评测、构建与验证。

Output

• 完整技能目录和职责说明。
• 触发/非触发边界、阶段契约与 Examples。
• agents/openai.yaml 展示名、描述和显式引用 $skill-name 的默认提示。
• 新增或更新的行为用例和验证证据。

Stop or escalate

• 职责可由现有 Skill 承担：修改现有 Skill，不新增目录。
• 变更破坏三路由、风险分级、权限或发布边界：停止并请求确认。
• 没有可测试边界或只复制通用行为：打回。
• 变更降低交付、审查、隐私或发布标准：不得实施。

References

执行前读取 stage-contract.md。