用途:在编写功能规格后、进入规划阶段前,检测并减少当前功能规格中的歧义与缺失决策点,将澄清结果直接记录到规格文件中。
主要能力:按功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界与失败处理、约束与权衡、术语一致性、完成信号、杂项占位符等分类做结构化歧义与覆盖扫描,标记 Clear/Partial/Missing;生成最多 5 个高优先级澄清问题,逐个交互提问,每题可用 2–5 个互斥选项或不超过 5 个词的短答;每次接受答案后增量更新规格,写入 ## Clarifications 与 ### Session YYYY-MM-DD,并同步到功能需求、用户故事、数据模型、成功标准、边界情况等章节;若存在 FEATURE_DIR/checklists/requirements.md,会重新评估并仅切换复选框状态,输出通过数对比。
使用方式:从仓库根目录运行 {SCRIPT}(--json --paths-only 模式)解析 FEATURE_DIR、FEATURE_SPEC;如存在 /memory/constitution.md 则加载项目原则;读取当前规格文件后开始提问。用户可用“yes”“recommended”“suggested”接受推荐,或回复选项字母、自定短答;说“done”“stop”等可提前结束。
限制:整个会话最多 5 个问题;规格文件缺失时需先运行 SPECKIT_COMMAND_SPECIFY,本技能不新建规格;不提前透露后续问题;若无可澄清项则报告无关键歧义。执行前后会检查 .specify/extensions.yml 中的 before_clarify 与 after_clarify 钩子,YAML 无法解析时需告知用户并继续。本技能内容源自 GitHub Spec Kit 官方模板,采用 MIT 许可。