用途
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,指出搜索的范围与空路径,并给出路由建议。
- 写入报告文件前必须确认。
- 关于具体收费、价格、平台支持等信息,资料中暂未提供。