SuperAPI AI 工具集

trace-validate

测试与质量

查看项目

更新于 10-15 23:42

技能介绍

用途:为单个工作项生成可追溯性报告,回答“该工作的每个验收标准是否都有测试覆盖”。追踪对象以用户故事(US-XXX)的验收标准为主,也适用于任何带标识符的标准(AC-001、1.1、R-3 等),标识符按原文逐字使用,不做规范化。

主要能力:读取并映射工作项标准、测试用例与测试产物;通过委托 quality-check 获取测试结果(复用其新鲜的 test-run.json 缓存,或调用其 tests-only 模式);输出 coverage.md 报告,包含摘要、按标准的覆盖状态、可追溯性矩阵与观察项,并给出最终裁决。报告具有幂等性:若代码、测试与标准均未变化,则直接返回既有报告。

使用方式:按工作项类型确定标准来源(US 读取其 README.md 的验收标准章节;WI、FT 读取各自 README.md 的验收标准章节;其他产物读取用户指定文档的标准章节)。支持的调用修饰符 revalidate 可强制重新生成报告(同义词:revalidar、forzar)。执行前必须读取 ${PLUGIN_ROOT}/references/language.md 与 escalation.md,并按 verdicts.md 使用裁决与状态值。

适用场景:验收标准齐全且带标识符的工作项,尤其适合需要验证规格与测试之间追溯关系的场景;已实现功能的覆盖核查也适用。

限制:本身不执行测试、不编写或修改应用代码、不写新测试、不编辑产品规格;无法从来源确定的覆盖或结果一律不编造。若工作项没有任何带标识符的标准,则阻断。执行前还须阅读 references/flow.md 并遵循 ${PLUGIN_ROOT}/references/asking.md 的提问机制。覆盖状态分为 COVERED、PARTIAL、UNCOVERED;测试用例状态为 Draft/Ready/Obsolete(不翻译)。报告保存在对应类型的位置,并记录指纹供下次新鲜度检查。