用途:当功能规格已存在但需要在规划前做针对性澄清时使用。输入为 specs/<feature>/spec.md 中的当前规格,以及用户请求中的澄清意图或约束;若请求为空或规格缺失,应先提出一个针对性问题再继续。该流程预期在 speckit-plan 之前完成,若用户明确跳过澄清,可继续但需警告下游返工风险增加。
主要能力:从仓库根目录运行 .specify/scripts/bash/check-prerequisites.sh --json --paths-only 一次,解析 FEATURE_DIR、FEATURE_SPEC 等字段;若 JSON 解析失败则中止并提示重跑 speckit-specify 或检查功能分支环境。随后加载规格,按功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界与失败处理、约束与权衡、术语一致性、完成信号、杂项占位符等分类做结构化歧义与覆盖扫描,标记 Clear/Partial/Missing,并生成内部覆盖图用于排序。
使用方式:内部生成最多 5 个候选澄清问题,每次只呈现一个;多选题给出推荐选项与理由并以 Markdown 表格列出选项,短答题要求不超过 5 个词。用户回答 yes、recommended 或 suggested 时采用先前建议;回答模糊时先消歧。每个被接受的答案立即追加到 ## Clarifications 下的 ### Session YYYY-MM-DD 中,并同步更新最合适的规格章节,每次写入后保存文件。
限制:整个会话最多 10 个问题、最多询问 5 个;不提前透露后续问题;不询问已答、纯风格偏好或计划级执行细节;避免推测技术栈,除非缺失会阻碍功能清晰度;尊重用户提前终止信号。完成后报告问题数量、更新路径、涉及章节、覆盖摘要表,并建议是否进入 speckit-plan 或稍后再次运行 speckit-clarify。