SuperAPI AI 工具集

doc-tdd-audit

测试与质量

查看项目

更新于 10-16 05:46

技能介绍

用途:在 TDD 文档已存在、生成 IPLAN 之前,或 autopilot 的审计↔修复循环中,对 TDD 做统一审计——声明式结构检查加内容质量评审,一次运行产出单一合并报告,供 ../doc-tdd-fixer/SKILL.md 消费。不用于创建 TDD(应使用 ../doc-tdd/SKILL.md 或 ../doc-tdd-autopilot/SKILL.md)。每次审计均从零开始,不复用旧分数或缓存,独立计算 IPLAN-Ready 分数。

主要能力:结构检查为确定性执行,是门禁底线,任何模式下都不委派。Tier 1 阻断项包括:测试用例 ID 格式(TDD.NN.04.xxxx 四位十六进制哈希)、模板要求的必需章节齐全且非空、每个用例带有效类型(unit/integration/e2e/security)、BDD 场景映射到测试、累积标签 @brd @prd @ears @bdd @adr @spec 齐全、父 SPEC 有效且文件存在、IPLAN-Ready 分数达到阈值(默认 90)。Tier 2 为建议项,如输入/预期输出、边界与错误路径、e2e 的 bdd_ref、按类型阈值、frontmatter 元数据、链接解析、图表标签等。另有写作风格检查,违规达阈值时升级为阻断。合并状态仅在全部 Tier 1 通过、内容分达阈值且无阻断问题时为 PASS。

使用方式:输入 TDD 路径(docs/07_TDD/TDD-NN_*/...)与可选分数阈值。流程为:结构检查→记录发现→内容评审→合并归一化→写入 .aidoc/audit/07_TDD-audit.md→若存在可自动修复项则交给 doc-tdd-fixer。评审模式由 .aidoc/profile.yaml 的 review_mode 决定,未设置时按框架默认:门禁处(pre_promotion/pre_merge)为 team,写入时(on_author)为 single_pass。team 模式下按 REVIEW_CREWS.yaml 的评审组(qa_lead 35、tech_lead 25、chaos_engineer 10、security_engineer 10、operator 10、auditor 10)分派 Task 子代理,写入 .aidoc/review/07_TDD/<TDD-id>/ 黑板槽位,再由 synthesizer 生成 verdict.json 与 report.md;single_pass 模式在本技能上下文内顺序应用全部视角,不适用法定人数。

限制:框架不附带运行时代码,由 Claude 依据规范直接执行检查。评审视角不得读取、引用或加权作者自评字段(_ready_score、_score、readiness_score、audit_score),以避免锚定效应。若 coverage.quorum_met 为 false,结果标记为低置信度并转人工评审,绝不静默通过。断路上限 SOFT_DEADLINE 为 1500 秒,超时以 PARTIAL_TIMEOUT 干净退出;迭代上限 MAX_ITERATIONS=3 由 saga 驱动方执行,本技能不重试。独立调用且无 saga.json 时不初始化 saga 日志。其余细节(如 deliverable_type 等元数据字段的完整取值)资料未完整提供。