用途:在调用 /speckit-plan 之前,对当前功能规格说明进行结构化歧义与覆盖度扫描,识别未充分说明之处,并通过最多 5 个澄清问题把答案直接写入规格文件。
主要能力:按分类法逐项标注 Clear/Partial/Missing 状态(功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界与失败处理、约束与权衡、术语一致性、完成信号、杂项占位符);生成最多 5 个候选澄清问题的优先级队列;多选题每道给出推荐选项与理由,短答题给出建议答案;每次接受答案后增量更新规格,并在 ## Clarifications 下记录 ### Session YYYY-MM-DD 与 Q→A 条目;如存在 checklists/requirements.md,会重新评估其中的复选框并统计通过数变化。
使用方式:需在仓库根目录运行一次 .specify/scripts/bash/check-prerequisites.sh --json --paths-only,解析 FEATURE_DIR 与 FEATURE_SPEC;加载 .specify/memory/constitution.md(若存在)与规格文件;支持读取 .specify/extensions.yml 中的 hooks.before_clarify / hooks.after_clarify 扩展钩子。
限制:一次会话总共最多提问 5 个;规格文件缺失时须先运行 /speckit-specify;若无可澄清项则提示继续;若配额用尽仍有高影响类别未决,会列为 Deferred。