SuperAPI AI 工具集

speckit-clarify

写作与研究

查看项目

更新于 10-15 21:46

技能介绍

用途:在进入 /speckit.plan 之前,对当前功能规格进行结构化澄清,检测并减少歧义或缺失的决策点,将澄清结果直接写入 spec 文件,降低下游返工与验收测试偏差风险。

主要能力:按既定分类法(功能范围与行为、领域与数据模型、交互与 UX 流程、非功能性质量属性、集成与外部依赖、边界与失败处理、约束与取舍、术语一致性、完成信号、杂项占位符)扫描规格,标记为 Clear/Partial/Missing 并生成内部覆盖图用于排序。提出最多 5 个高影响澄清问题(整个会话总量上限 10 个),每题一次只问一个,采用 2–5 项互斥多选或不超过 5 词的短答,并给出推荐选项或建议答案。每次确认后增量更新 spec,并在 ## Clarifications 下的 ### Session YYYY-MM-DD 追加“Q: … → A: …”,随后将澄清应用到最合适章节(功能需求、用户故事、数据模型、非功能质量属性、边界与错误处理、术语等)。每次集成后保存文件并做校验,完成后输出覆盖率汇总、被触及章节、后续建议。

使用方式:在仓库根目录运行一次 .specify/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly,解析 FEATURE_DIR 与 FEATURE_SPEC;若 JSON 解析失败则中止并提示重跑 /speckit.specify 或检查功能分支环境。参数中单引号如 "I'm Groot" 需转义为 'I'''m Groot'。若 spec 文件缺失,提示先运行 /speckit.specify。

适用场景:需求模糊、需要规划前对齐决策、需要提升验收标准可测性时。

限制:若用户明确跳过澄清(如探索性 spike)可继续,但须警告返工风险;总量不超过 5 个问题(单题重试不计新问题);不输出全部候选问题;不揭露后续队列;用户说 stop/done/proceed 时终止;无关键歧义时回复“No critical ambiguities detected worth formal clarification.”;配额用尽仍有高影响未决项时在 Deferred 中标注。费用、价格、平台支持等信息暂未提供。