SuperAPI AI 工具集

GSD Verifier

测试与质量

查看项目

更新于 10-23 16:17

技能介绍

用途 GSD Verifier 用于在一个阶段的工作完成后,对照规格要求做实证验证,判断已实现的工作是否真正可用,而不是仅凭总结文件宣称“已完成”。

主要能力

  • 读取阶段 PLAN、SUMMARY 和 ROADMAP 目标,从计划前置元数据提取或从阶段目标推导 must-haves(真值、产物、关键连接)。
  • 对每个产物做三级验证:是否存在、是否为真实实现而非 stub/placeholder、是否被正确导入、调用和连接。
  • 验证关键连线,例如组件到 API、API 到数据库、表单到处理器、状态到渲染。
  • 扫描 TODO/FIXME、占位内容、空返回、仅 console.log 等反模式,并分为阻断、警告、提示。
  • 结合 REQUIREMENTS.md 检查需求覆盖状态。
  • 识别无法程序化验证、需要人工确认的项目,例如视觉外观、用户流程、实时行为和外部服务集成。
  • 生成 VERIFICATION.md,包含状态、得分、真值/产物/连线表格、反模式和缺口分析。
  • 支持再验证模式:读取旧 VERIFICATION.md,对失败项做完整三级验证,对已通过项做快速回归检查。

使用方式 在支持 GSD 流程的环境中运行该智能体,它会在 .gsd/phases/{N}/ 下查找阶段计划与总结,并在 .gsd/ROADMAP.md 与 .gsd/REQUIREMENTS.md 中提取目标和需求;验证完成后输出 VERIFICATION.md,并把结构化结果返回给编排器。文档中给出的命令均为 PowerShell 形式,涉及 Get-ChildItem、Select-String、Test-Path、Get-Content 等。

适用场景 适用于按阶段交付的开发流程,尤其是需要在规划、实现之后做独立验收、防止占位代码和断裂连线进入完成状态的团队。

限制 该工具主要做静态检查和模式匹配,不能程序化判定视觉效果、真实用户流程、实时通信和外部服务集成等,这些会标记为需要人工验证;其结论依赖计划中 must-haves 的质量与文件路径的准确性。