用途:为项目生成结构化规格文档,包括 requirement.md、design.md、tasks.md,以及完整流程下的 test.md(验收测试计划)。文档输出到 .specs/[项目名]/,项目名转为英文 kebab-case。
主要能力:按阶段生成文档,阶段包括 init、design、tasks、full;使用 [REQ-XXX]、[NFR-XXX]、[CON-XXX]、[ASM-XXX]、[T-XXX]、[T-AXX] 等 ID 保持可追踪性;可读取 docs/coding-rules.md 作为设计约束;支持 Mermaid 图、任务估算、Epic/Story/Task 层级等选项;完整流程会依次读取前一份文档生成下一份;生成后进行投影一致性自检并清理工具调用残留。
使用方式:调用后先执行上下文检查(pwd、ls -la、检测源码、检查 .specs/ 与 coding-rules.md),再通过 AskUserQuestion 或文本提问收集信息;常用选项有 --quick、--auto --issue <n>、--deep、--personas、--analyze、--visual、--estimate、--hierarchy。语言自动检测,输入日文输出日文并使用 *.ja.md 参考文件。auto 模式用 gh issue view <n> 获取需求,全程不提问,未知点写为 ASM-XXX 假设。
适用场景:新项目需求梳理、既有项目补充设计或任务拆解、从已有代码库反向分析、从 GitHub Issue 自动生成完整规格、将对话内容整理为需求文档。
限制:auto 模式依赖足够具体的 GitHub Issue,且面向编排流水线;部分行为依赖 references 目录下的参考文件与可用技能,缺失时会报告并回退;价格、平台支持等信息暂未提供。