qa-unit-tdd — 单元/TDD 方法学健康度门禁

「能跑的 E2E 再多，也补不上单测缺失的底层漏洞」。TDD 与测试金字塔（单元 >> 集成 >> E2E） 是行业公认的性价比之王。本技能把方法学指标做成一道可执行门禁：

⚠️ 治理门禁 · 不执行外部工具：本技能仅基于你提供的测试指标 JSON 做方法学健康度评估与门禁判定，不自行运行测试、不调用覆盖率工具（coverage.py/JaCoCo 等）；真实覆盖率采集由你的构建流水线执行。

覆盖率只是「跑没跑到」；本技能额外看「单测占比是否健康、测试是否真在写」——这两点才是方法学底线。

输入约定

--metrics 指向一份测试指标 JSON：

{
  "unit": 120, "integration": 30, "e2e": 20,
  "line_coverage": 0.85, "branch_coverage": 0.75,
  "failed_tests": 0, "test_loc": 2000, "code_loc": 4000
}

操作流程

python scripts/unit_health.py --metrics metrics.json --out unit_health.md \
       --signals-dir signals [--min-coverage 0.7] [--min-unit-ratio 0.6] [--fail-on]

门禁规则：

• 存在 critical/high → 产出 unit_health_low 阻断信号。
• 趋势分 = 1 − (高危项 / 4 个方法学维度)。
• --fail-on 时同时 sys.exit(1)。

与上下游衔接

• 输入：测试框架/覆盖率工具（pytest + coverage、jest、go test 等）聚合指标。
• 输出：健康度报告 + 信号 → 接入 qa-release-check 门禁，作为开发方法学横切门。

能力边界（诚实标注）

• 不直接跑测试，只评估指标（指标由上游工具产出）。
• 突变存活率本技能不重复计算，建议直接复用 qa-mutation 产出后并入门禁。
• 阈值（覆盖率/占比）可按项目成熟度下调，但不建议低于 50%。

参考资料

• 检查项、阈值、CLI 用法与常见坑：见 references/guide.md。