SuperAPI AI 工具集

doc-tspec-reviewer

测试与质量

查看项目

更新于 10-16 03:37

技能介绍

doc-tspec-reviewer 是面向 TSPEC(Test Specification,测试规范)文档的内容审查与质量保证技能,位于第 10 层(TSPEC Quality Assurance),上游依赖 doc-tspec-autopilot 或 doc-tspec 生成的 TSPEC,下游无,作为实现前的最终 QA 关卡。

用途:在 TSPEC 生成后、手工修改 TSPEC 后、开始测试实现前、评估覆盖率、周期性质量检查时使用。不适用于 TSPEC 尚不存在(先用 doc-tspec 或 doc-tspec-autopilot)、只需结构与 schema 校验(用 doc-tspec-validator)、或生成新 TSPEC 内容(用 doc-tspec)的场景。

主要能力(共十项检查):0. 结构合规(BLOCKING):TSPEC 必须置于嵌套文件夹,如 docs/10_TSPEC/UTEST/UTEST-NN_{slug}/UTEST-NN_{slug}.md,错误码 REV-STR001–STR004。1. 覆盖率目标:UTEST≥80%、ITEST≥70%、STEST 关键路径、FTEST≥85%(REV-TC001–TC004)。2. SPEC 对齐:每个 SPEC 方法、接口、错误场景、阈值均有测试(REV-SA001–SA004)。3. 用例完整性:含 Test ID、描述、前置条件、步骤、预期结果、后置条件(REV-TCC001–TCC004)。4. 测试数据定义(REV-TD001–TD004)。5. 测试环境要求(REV-TE001–TE004)。6. 边界与异常覆盖(REV-EC001–EC004)。7. 占位符检测(REV-P001–P003)。8. 命名合规:元素 ID 须为 TSPEC.NN.xxxx,类型码 40–45(REV-N001–N003)。9. 上游漂移检测:基于强制缓存文件 docs/10_TSPEC/.drift_cache.json(schema 2.0),三阶段算法(初始化、检测、更新),用 sha256sum、yq 计算哈希,禁止占位哈希值,错误码 REV-D001–D009。

评分与阈值:按覆盖率 19%、SPEC 对齐 19%、用例完整性 19%、测试数据 9%、环境 5%、边界 9%、占位符 5%、命名 10%、漂移 5% 加权,满分 100;PASS≥90,WARNING 80–89,FAIL<80。

使用方式:/doc-tspec-reviewer TSPEC-03、/doc-tspec-reviewer <路径> 或 /doc-tspec-reviewer all。报告命名 TSPEC-NN.R_review_report_vNNN.md,存放于 TSPEC 嵌套文件夹内,支持版本自增与增量对比;doc-tspec-audit 可输出 TSPEC-NN.A_audit_report_vNNN.md 作为修复输入。该技能在 doc-tspec-autopilot 的 Phase 5 被调用。

限制:结构检查不通过会阻断后续检查;漂移缓存缺失或损坏报 REV-D006;评审分数低于阈值仅标记而非直接阻断。安装命令与具体平台信息暂未提供。