SuperAPI AI 工具集

dev-test-gaps

测试与质量

查看项目

更新于 10-15 21:37

技能介绍

用途:在实现任务完成后(/dev 工作流的 Phase 5.5),对照需求验证测试覆盖情况,并为缺失的需求补写新测试。

主要能力:从 .planning/SPEC.md 提取可测试需求(含需求 ID、描述、范围、验收标准),从 .planning/PLAN.md 提取测试策略与任务映射;扫描测试基础设施(框架、配置、目录、运行命令、既有测试模式);将每个需求映射到测试并分类为 COVERED / PARTIAL / MISSING;对 MISSING 需求并行派生 test-gap-auditor 代理补写测试;最终生成 .planning/VALIDATION.md 覆盖映射表。

核心约束(Iron Law):绝不修改实现代码,只写测试或上报。允许读取实现代码、新建测试文件、更新测试文件、创建测试夹具;不允许编辑实现文件、为让测试通过而“快速修复”、为可测试性改动生产代码。若测试因实现缺陷失败,必须上报(escalated),不得自行修复。

使用方式:按流程读取需求与计划、扫描测试设施、映射覆盖、分类、补缺、产出 VALIDATION.md。补缺时以 subagent_type="workflows:test-gap-auditor" 派生代理,并传入 allowed_tools=["Read", "Glob", "Grep", "Bash", "Write", "Edit"];每个审计代理最多 3 次调试迭代,仍失败则上报。需监控上下文:剩余 >35% 正常继续,25-35% 完成当前审计后写 draft 状态并调用 dev-handoff,≤25% 立即写 VALIDATION.md 并调用 dev-handoff。

适用场景:需要按需求粒度(而非任务粒度)核查测试覆盖、发现任务之间隐藏的覆盖缺口时。

限制:无法在不重构实现的情况下测试的需求,标记为“untestable without refactor”并上报;退出前需运行完整测试套件,全部通过且无上报才能置为 validated,否则为 gaps_found。具体命令与配置需按项目实际检测结果确定。