harness-audit

harness-audit — 测试套件与测试框架质量检查器

领域评估标准

1. 审计层级

按渐进式架构层级检查目标测试套件：

1. 测试框架锚点与基础层：
   • 检查权威项目测试框架锚点 .agents/harness-anchor.md，并按照其中的 Governing Testing SSOTs 路径读取项目测试标准。
   • 如果文件缺失：检查旧版测试指南（test/AGENTS.md、tests/AGENTS.md）。如果找到，则将其用作临时 SSOT，并建议运行 /zenforge-init，以建立规范的 .agents/harness-anchor.md。如果没有找到，则将锚点标记为 UNGROUNDED，并转交 /zenforge-init。
   • 验证已注册的隔离式基础组件是否实际存在于磁盘上（确定性时钟、存储沙箱、夹具 / 工厂、传输 / 网络模拟、生命周期 / 清理）。
2. 异味与不稳定性陷阱：
   • 根据 references/test-smells.md 中详述的反模式和不稳定性陷阱评估测试。
3. 不变量维度盲点：
   • 根据 references/invariant-dimensions.md 中详述的不变量维度审计测试覆盖情况。

2. 强制参考资料核对

执行审计前，Agent 必须阅读以下资料，并以此为依据：

• references/test-smells.md，了解具体的异味定义与修复方法。
• references/invariant-dimensions.md，了解不变量测试向量。

3. 审查结论与引用规则

• PASS：测试框架锚点已启用；隔离式基础已验证；不存在不稳定性异味；不变量维度覆盖均衡。
• WARN：基础设施已具备，但存在维护债务（重复设置、缺少断言消息）。
• CRITICAL：测试框架锚点缺失、基础设施缺失（没有虚拟时钟 / 临时存储），或检测到不稳定性异味（时钟泄漏、休眠）。
• 双重引用规则：每个缺陷都必须同时引用问题代码位置（file:///path/to/test#L<N>）和被违反的不变量 / 修复方法。

规范输出约定

# Harness Audit Report: <Target Scope>

## 1. Executive Verdict
- **Verdict**: <PASS | WARN | CRITICAL>
- **Target Inspected**: <Directory or Test Files>
- **Harness Anchor (SSOT)**: <Cited anchor pointer or 'UNGROUNDED (Missing .agents/harness-anchor.md)'>
- **Flakiness Risk**: <LOW | MEDIUM | HIGH>
- **Summary**: <Single-sentence technical judgment>

## 2. Infrastructure & Anchor Gaps
*(If clean: 'Harness anchor verified; foundational hermetic primitives active.')*
- **[<Anchor / Primitive>] <Gap Title>**: <Deficit description>
   - Impact: <Why this causes flakiness or maintenance debt>
   - Recommendation: <Architecture fix or seed anchor pointer>

## 3. Findings & Invariant Blind Spots
- **[<Smell / Dimension>] <Title>**: <Defect description>
   - Offending Code: [<file>#L<N>](file:///path/to/test#L<N>)
   - Remediation: <Exact architectural correction required>

路由

• 缺少测试框架锚点，需要进行设置 →（通过 /zenforge-init）。
• 缺少基础隔离组件，需要权衡架构方案 →（通过 /clarify）。
• 已发现差距或不变量盲点，可开始制定修复计划 →（通过 /changeset）。
• 已批准的 changeset 授权进行局部测试修复，并规定验收标准 / 验证方式 →（通过 /forge）。

执行流程

1. 依据核对与范围收集：
   • 如果 .agents/harness-anchor.md 存在，则检查该文件。
   • 阅读 references/test-smells.md 和 references/invariant-dimensions.md。
2. 自适应规模的审计调度：
   • 当前轮执行（少于 10 个测试文件或局部测试套件）：在当前轮直接根据审计层级检查测试套件。
   • 子 Agent 分派（范围较广、涉及多个包的测试套件）：启动 1–3 个 research 子 Agent，按目录划分任务，并提供锚点和参考资料路径。
3. 综合与本轮终止关卡（汇总）：
   • 将发现的问题去重后纳入规范输出约定。
   • 将完整报告呈现在对话中，并立即结束本轮。