用途:在生成计划(speckit.plan)之前,检测并减少活动功能规范中的歧义或缺失决策点,把澄清结果直接写入规格文件,降低下游返工风险。
主要能力:按分类法进行结构化歧义与覆盖扫描(功能范围、领域与数据模型、交互流程、非功能性质量属性、集成与外部依赖、边缘情况、约束与权衡、术语一致性、完成信号、占位符等),标记每类状态为清晰/部分/缺失;生成内部优先级问题队列,整个会话最多10个问题,实际提出最多5个;问题采用2-5个互斥选项的多项选择或不超过5个词的简短答案,一次只问一个,并给出推荐选项及理由。
使用方式:从仓库根目录运行前置检查脚本 once: sh: .specify/scripts/bash/check-prerequisites.sh --json --paths-only ps: .specify/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly 解析 JSON 中的 FEATURE_DIR 与 FEATURE_SPEC。解析失败需中止并提示重新运行 speckit-specify 或检查功能分支环境。加载当前规格文件并扫描;用户可回复选项字母、"yes"/"recommended" 接受推荐,或自行给出简短答案。每接受一个答案,即在 ## Clarifications 下创建 ### Session YYYY-MM-DD,追加 "- Q: … → A: …",并把澄清应用到最合适的章节,随后保存规格文件。
适用场景:功能需求仍存在影响架构、数据建模、任务拆分、测试设计、用户体验、运维或合规的模糊点时。限制:规格文件缺失时应先运行 speckit-specify;不创建新规格;不推测技术栈(除非阻塞功能清晰度);超出配额的高影响类别标记为推迟;若无疑义则报告未检测到关键歧义。