SuperAPI AI 工具集

cmd-speckit-clarify

编程与开发

查看项目

更新于 10-15 21:55

技能介绍

用途:在进入规划阶段前,检测并减少当前功能规格中的歧义与缺失决策点,将澄清结果直接记录到规格文件中。

主要能力:按功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界与失败处理、约束与取舍、术语一致性、完成信号、杂项占位等分类做结构化覆盖扫描,标记 Clear/Partial/Missing;生成最多 5 个候选问题,逐个交互提问,支持多选或不超过 5 词的短答;每个答案被接受后立即增量更新规格对应章节,并保存文件;若存在 FEATURE_DIR/checklists/requirements.md,会重新校验规格质量清单并统计通过数变化。

使用方式:从仓库根目录运行 {SCRIPT}(--json --paths-only 模式)解析 FEATURE_DIR、FEATURE_SPEC;加载规格文件与 /memory/constitution.md;按分类扫描后逐个提问;答案写入 ## Clarifications 下的 ### Session YYYY-MM-DD 小节,并同步更新功能需求、用户故事、数据模型、成功标准、边界情况等章节。支持 .specify/extensions.yml 中 hooks.before_clarify 与 hooks.after_clarify 扩展钩子。

适用场景:功能规格已创建、准备进入规划前的澄清阶段。

限制:总提问不超过 5 个;规格文件缺失时需先运行 SPECKIT_COMMAND_SPECIFY;用户可提前终止;若无可澄清项则报告无关键歧义;未提供具体安装命令、收费与平台信息。