SuperAPI AI 工具集

speckit-clarify

编程与开发

查看项目

更新于 10-16 03:43

技能介绍

用途:在编写功能规格后、进入 /speckit-plan 之前,识别规格中欠明确的区域,通过最多 5 个澄清问题把决策补齐并直接记录到规格文件中。资料说明该流程预期在调用 /speckit-plan 之前完成;若用户明确跳过,需提示后续返工风险增加。

主要能力:按分类体系做结构化歧义与覆盖度扫描,涵盖功能范围与行为、领域与数据模型、交互与 UX 流程、非功能质量属性、集成与外部依赖、边界情况与失败处理、约束与取舍、术语一致性、完成信号及其他占位符。每个类别标记 Clear/Partial/Missing,并按影响与不确定性排序候选问题。一次只问一个问题,问题须可用 2–5 个互斥选项或不超过 5 词的短答回答。

使用方式:在仓库根目录运行 .specify/scripts/bash/check-prerequisites.sh --json --paths-only,解析 FEATURE_DIR 与 FEATURE_SPEC;解析失败时中止并提示重新运行 /speckit-specify。加载当前规格后进行扫描,逐题交互,用户回答 yes/recommended/suggested 时采纳推荐答案。每个答案被接受后立即增量写回规格:新增或更新 ## Clarifications 与 ### Session YYYY-MM-DD 小节,追加形如 - Q: <question> → A: <answer> 的条目,并同步修改对应章节(功能需求、用户故事、数据模型、成功标准、边界情况、术语等),每次写入后保存并校验。

扩展钩子:若项目根目录存在 .specify/extensions.yml,会读取 hooks.before_clarify 与 hooks.after_clarify;enabled 显式 false 的跳过,无 condition 视为可执行,含非空 condition 的交给 HookExecutor;命令名中的点替换为连字符,如 speckit.git.commit → /speckit-git-commit。可选钩子提示执行方式,强制钩子输出 EXECUTE_COMMAND 并等待结果。文件不存在或无效则静默跳过。

适用场景:已有规格文件、希望在规划与任务分解前消除关键歧义的项目。

限制:最多 5 个问题;规格缺失时应先运行 /speckit-specify;不创建新规格;无关键歧义时直接报告并建议继续;未提及收费、价格或平台信息,暂未提供。