用途:该技能负责 SDD(规格驱动开发)流程中的 Specify(编写规格)阶段,将新功能、组件或系统的需求、模糊票据或研究材料,转化为正式且机器可读的规格文档 SPEC.md。规格是所有下游产物(任务计划、架构、实现、测试)的唯一事实来源,其歧义会传导为后续各阶段的缺陷。
主要能力:产出遵循制品金字塔结构的规格文档。L1 为执行摘要(范围、关键干系人、总体成功标准),写入 00-index.md 作为入口;L2 为按维度拆分的规格,包括用户故事、Gherkin 场景、边界情况、非功能需求、范围外内容与数据契约,分散在各自的 *.spec.md;L3 为每条故事的详细档案,含完整验收标准、接口定义、数据模式与示例,置于 dossiers/ 目录;各文件页脚附 SOURCES 导航索引,链接 L2 维度与其 L3 来源。提供参考文档:交付前的规格质量门禁(7 个质量维度)、Gherkin 模式(Given/When/Then 写法)、验收标准设计(边界条件枚举);提供 SPEC.md 模板,以及作者完成后运行 scripts/spec-quality-check.sh 校验必需章节是否齐备。
输出契约:每份 SPEC.md 必须包含问题陈述、范围边界(明确在范围内与范围外)、按优先级排列且链接验收标准的用户故事、按故事给出的验收标准(Given/When/Then 或通过/不通过条目)、显式枚举的边界情况(错误状态、非法输入)、非功能需求(性能、安全、可观测性、合规、可访问性),以及数据契约/接口(可用桩,后续阶段细化)。规格仅在自动化质量检查通过后才算完成。
适用场景:在实现开始前为新功能/组件/系统编写正式规格;对已有规格做细化或缺口分析;把粗略需求或研究、竞品分析、用户访谈记录蒸馏为工程需求。该技能在框架层面与方法论无关,可对接 GitHub Spec Kit 的 Specify 阶段、GSD 的 PROJECT.md/REQUIREMENTS.md、BMAD 的 PRD 与架构层、Taskmaster AI 的 PRD、以及原生 Claude Code 的 CLAUDE.md 搭配规格文件。
理念与限制:强调精确优先于易读、完整优先于简洁、可测试优先于描述性,每条验收标准必须能产生通过/不通过的二元判定。文档未提供具体安装命令、收费或平台信息,暂未提供。