编写技能 是做什么的?
一个4阶段流水线:收集 → 拷问 → 规划 → 实施。
阶段1:收集
使用AskUserQuestion进行领域分批提问,覆盖4个领域。每个领域调用1次,提供2-4个选项和一个推荐(第一个选项标记为(推荐))。
- 目的——该技能涵盖什么任务/领域?谁使用它?
- 用例——哪些具体场景会触发此技能?哪些关键词?
- 结构——是否需要脚本?参考文件?单一SKILL.md还是多文件?
- 工具——应调用或引用哪些工具或其他技能?
阶段2:拷问
调用grill-me技能,传入收集到的需求。指示其使用skill-grill-domains.md中针对技能定制领域(意图、范围、设计、边缘案例)。跳过不相关领域(数据流、依赖项、部署、测试)。
回退方案(grill-me不可用): 直接使用AskUserQuestion运行内联mini-grill。对于skill-grill-domains.md中的每个领域,每次调用批处理2-4个问题,并提供推荐和选项。
阶段3:规划
使用blueprint-template.md中的模板生成结构化的技能蓝图。在对话上下文中展示蓝图(不写入磁盘)。用户必须批准后才能继续。如果用户要求修改,则修订并重新展示。
阶段4:实施
按照批准的蓝图创建所有技能文件。完全自动化——代理编写所有内容。
然后运行阶段4b:审查,使用quality-criteria.md中的标准:
- 自动验证——检查可衡量标准(行数、描述长度、触发器、参考深度)。在继续之前修复任何失败。
- 主观审查——通过
AskUserQuestion向用户展示检查清单。如果用户指出问题,修订并重新验证。
技能结构
skill-name/
├── SKILL.md # 主指令(必需,<100行)
├── references/ # 支持文档(如果需要)
│ └── domain-ref.md
└── scripts/ # 实用脚本(如果需要)
└── helper.sh
回退方案(无AskUserQuestion)
如果AskUserQuestion不可用,则回退到基于文本的问题:
[标题] — [主题] 推荐: [您的推荐及原因] 备选: (A) [选项] — [权衡] | (B) [选项] — [权衡]
质量标准
参见quality-criteria.md以了解描述要求、自动验证标准、主观审查检查清单以及何时添加脚本或拆分文件的指导。