SuperAPI AI 工具集

specs-kit-spec-check

测试与质量

查看项目

更新于 10-27 10:54

技能介绍

用途

Spec Check 是规格工作流中的澄清与质量评估环节,位于 brainstorm 之后、technical-plan 之前,用于在生成任务前加固规格文档。它既可以处理头脑风暴阶段留下的待澄清标记,也可以在对抗性评审报告产生后,作为第二轮关闭评审发现项。

主要能力

  • 关闭评审发现项:当对抗性评审报告存在未关闭发现时,把每个未关闭的 BLOCKER/MAJOR 发现转成澄清问题,并将解决结果记录回报告。读取最近一份 adversarial-review/YYYY-MM-DD--adversarial-review.md,收集 Convergent findings、Singleton findings、Contested areas 中的条目,保留 id、严重级别、目标、主张、场景、建议修复及类别。已带非 OPEN 状态行的发现不会重复提问。
  • 解析 [NEEDS CLARIFICATION] 标记:扫描全文匹配 \[NEEDS CLARIFICATION:([^\]]+)\],提取问题文本与上下文,转为结构化问题(多选或短答),解决后从规格中移除标记并整合答案。最多处理 3 个标记,按影响范围 > 安全/隐私 > 用户体验 > 技术细节排序;超出部分标记为 deferred 留待下次会话。
  • 结构化模糊扫描:若无标记或配额剩余,则按质量分类法扫描规格,最多补足到 5 个问题。

质量维度

评估完整性/清晰度(模糊表述、未定义术语、内部矛盾、缺失章节)、需求可追溯性、验收标准(可测试性、可度量性、agent 可执行性)、边界情况覆盖、架构对齐(若存在 docs/specs/architecture.md)、本体一致性(若存在 docs/specs/ontology.md)。

使用方式

# 审查一个规格文件夹
/skill:specs-kit-spec-check docs/specs/001-hotel-search-aggregation/

# 审查特定规格文件
/skill:specs-kit-spec-check docs/specs/001-hotel-search-aggregation/2026-03-07--hotel-search.md

# 从当前目录自动检测
/skill:specs-kit-spec-check

参数 spec-path 可选,省略时从当前工作目录向上推断最近的包含规格类 Markdown 文件的文件夹;无法确定则停止并告知用户。

工作流程要点

  1. 发现阶段:解析参数、定位规格文件夹、识别规格文件、user-request.md、brainstorming-notes.md、tasks/、adversarial-review/ 及项目级架构/本体文档。
  2. 加载与提取:读取规格,先提取评审发现(仅当存在报告),按目标过滤——规格层面的由本技能处理,技术计划、任务、需求本身的问题指向对应技能并保留 OPEN 状态;再提取标记并与发现去重;最后按剩余配额执行扫描。
  3. 问题排序:评审问题按 convergent BLOCKER → singleton BLOCKER → convergent MAJOR → singleton MAJOR → contested → MINOR,然后追加标记问题、扫描问题,最终裁剪到最多 5 个,被裁掉的发现保持 OPEN 并在报告中点名。
  4. 逐题交互:显示进度与来源,给出推荐选项,评审问题必须提供拒绝该发现的选项(拒绝则以 REJECTED 关闭并记录理由)。
  5. 即时整合:创建或更新 ## Clarifications 下的会话小节,追加问答记录,移除已解决的标记,回写评审报告,并将澄清应用到相应章节后保存。

适用场景

规格起草后的模糊点清理、评审反馈闭环、任务生成前的质量把关、与头脑风暴和对抗性评审配合的多轮规格迭代。

限制

  • 只编辑规格文档,不写任务、计划或代码;非规格层面的发现会转交对应技能。
  • 每轮最多 5 个问题(评审发现 + 标记 + 扫描合计),最多处理 3 个标记。
  • 需账户、凭证、签名、购买、物理接触或人工决策的验收标准无法由循环自动关闭,归属任务文档的操作者前置条件。
  • 跳过标记问题时不移除标记,并在报告中注明。
  • 收费、价格与平台支持信息暂未提供。