用途:在功能规格(spec)阶段检测并减少歧义与缺失决策点,把澄清结果直接记录到规格文件中。官方说明该澄清流程应在调用 /speckit-plan 之前完成;若用户明确跳过,需提示下游返工风险增加。
主要能力:先运行 .specify/scripts/bash/check-prerequisites.sh --json --paths-only 获取 FEATURE_DIR、FEATURE_SPEC 等路径;若存在则加载 .specify/memory/constitution.md 作为项目原则与治理约束。随后按功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界与失败处理、约束与取舍、术语一致性、完成信号、杂项占位符等分类做结构化歧义与覆盖扫描,标记 Clear/Partial/Missing,并据此生成最多 5 个候选澄清问题。
使用方式:一次只提出一个问题,问题须以 Question: 开头并以问号结尾,可附需求编号;每题给出“Why it matters”说明。选择题会给出推荐选项与 Markdown 选项表,用户可回复选项字母、yes/recommended 或自定短答;短答题要求不超过 5 个词。用户回答后先记入内存,再增量写回规格:在 ## Clarifications 下创建 ### Session YYYY-MM-DD,追加 - Q: … → A: …,并按类型更新功能需求、用户故事、数据模型、成功标准、边界情况或术语。每次整合后保存规格文件,并校验澄清条目唯一、问题总数不超过 5、无遗留模糊占位符与矛盾表述。若存在 FEATURE_DIR/checklists/requirements.md,还会重新评估其中的复选框并只切换状态变化的标记,最后输出通过数量对比。
适用场景:Spec Kit 规格编写后的澄清环节,尤其适合需要降低返工风险、避免验收测试错位的功能开发。
限制:最多 5 个问题;不询问实现方法、技术栈比较或任务拆分;规格文件缺失时应先运行 /speckit-specify;无关键歧义时直接报告并建议继续。扩展钩子方面,会读取 .specify/extensions.yml 的 hooks.before_clarify 与 hooks.after_clarify,跳过 enabled: false 的钩子,命令名中的点替换为连字符,强制钩子需实际执行并等待完成。