SuperAPI AI 工具集

test-evidence-review

测试与质量

查看项目

更新于 10-15 14:30

技能介绍

用途

test-evidence-review 用于对测试文件与证据文档进行质量审查。按照技能说明,/smoke-check 只验证测试文件是否存在并通过,而本技能更进一步,审查这些测试与证据文档的质量:一个存在且通过的测试文件仍可能遗漏关键行为,一个存在的手工证据文档也可能缺少关闭故事所需的签核。

主要能力

  • 按范围加载故事:支持单个故事路径、sprint(读取 production/sprints/ 中最近修改的文件并提取故事路径列表)、系统/史诗(匹配 production/epics/[system-name]/story-*.md)。无参数时会询问范围。
  • 定位证据文件:优先使用故事 ## Test Evidence 中声明的证据路径;未声明或找不到时,按故事类型回退搜索(Logic 查单元测试根目录,Integration 查集成测试根目录,Visual/Feel 与 UI 查 production/qa/evidence/ 中的保留图片,Config/Data 查 production/qa/smoke-*.md)。
  • 审查自动化测试质量(Logic / Integration):评估断言覆盖(每个测试函数 3+ 断言为正常,1-2 为可能偏薄,0 断言标记为 BLOCKING,qa.level: minimal 时为 ADVISORY)、边界用例覆盖、命名质量(按引擎命名规范,通用命名如 test_1 会被标记)、公式可追溯性。
  • 审查手工证据质量(Visual/Feel / UI):检查标准关联、签核完整性、截图/产物完整性、日期覆盖(可能过时则标记 POTENTIALLY STALE)。
  • 生成审查报告:逐故事给出判定,并汇总 BLOCKING 与 ADVISORY 条目数量。

判定词汇

  • ADEQUATE:测试/证据存在,通过质量检查,所有标准均被覆盖。
  • INCOMPLETE:测试/证据存在但有质量缺口(断言偏薄、缺少签核等)。
  • MISSING:在该 qa.level 下需要测试/证据的故事类型未找到任何测试或证据。
  • NOT ASSESSED:无法执行审查(故事类型无法确定、证据路径不可读或超出范围、故事文件无法解析)。
  • WAIVED(qa.level: minimal):Logic、Integration 或 Config/Data 故事在 qa.level: minimal 下无测试证据,因不要求测试而视为豁免。

整体 sprint/系统判定取范围内最差的故事判定;NOT ASSESSED 优先于 ADEQUATE,但不优先于 INCOMPLETE 或 MISSING;仅当范围内所有故事都被豁免时整体判定才为 WAIVED。

使用方式

  • /test-evidence-review [story-path]:审查单个故事证据
  • /test-evidence-review sprint:审查当前 sprint 中所有故事
  • /test-evidence-review [system-name]:审查某个史诗/系统中的所有故事
  • 无参数:询问范围(单个故事 / 当前 sprint / 某个系统)

报告先在对话中呈现,随后询问是否写入 production/qa/evidence-review-[date].md(可选)。

适用场景

  • QA 交接签核前(/team-qa Phase 5)
  • 任何测试质量存疑的故事
  • 作为里程碑审查的一部分,用于 Logic 与 Integration 故事的质量审计

限制与约束

  • 该技能只读取和评估,不修改测试文件或证据文档;报告质量问题而不修复。
  • 判定规则受 qa.level 与 testing.strict 配置影响:qa.level: minimal 会豁免测试;testing.strict 按故事类型决定门禁级别(true → BLOCKING,false → ADVISORY,未设置则回退到 coding-standards.md 的默认门禁级别)。
  • 若范围内故事数为零,会停止并报告 NOT ASSESSED,指出搜索的范围与空路径,并给出路由建议。
  • 写入报告文件前必须确认。
  • 关于具体收费、价格、平台支持等信息,资料中暂未提供。