plan-audit

计划审计

概述

根据计划（WI + 验收标准 + 测试）审计已完成的工作，并报告差距、逻辑错误和测试覆盖缺失，同时附上文件和行号。

工作流（审计）

1. 定位计划

   • 优先查找 dev-docs/plans/<plan>.md。
   • 如果无法确定，请询问计划路径或 WI 列表。

2. 提取审计清单

   • 对于每个 WI，列出：
     • 目标
     • 验收标准
     • 必需的测试
     • 涉及的区域（文件/符号）

3. 将实现映射到 WI

   • 使用 git log、git show --stat、rg 和文件检查。
   • 记录满足各 WI 的文件/提交。

4. 差距与正确性分析

   • 对照实际行为检查每一项验收标准。
   • 找出逻辑错误、边缘情况失效和流程不完整之处。
   • 根据“先写测试”部分验证测试覆盖情况。
   • 如果计划引用了规范，验证实现是否符合这些规范。
   • 如果计划缺少验收标准/测试，将其记录为计划质量问题。

5. 报告发现

   • 按严重程度排序：Critical → High → Medium → Low。
   • 每项发现必须包含：
     • WI 引用
     • 文件路径 + 行号
     • 违反计划之处及原因
     • 计划要求的预期行为

输出格式（必需）

• 发现（按严重程度排序）
  • 文件:行号 和 WI 引用
  • 影响和建议的修复方案
• 计划差距摘要
  • WI‑### → 缺失/部分缺失的验收项
• 测试覆盖差距
  • 缺失的测试、失效的测试或“未编写测试”
• 备注 / 风险
  • 任何假设或未经验证的区域
• 证据
  • 为每项发现引用具体证据（文件/行号/提交 ID）。

审计规则

• 除非用户明确要求，否则不要在此处运行测试；这只是一次检查。
• 严格检查规范偏差：如果行为与计划文本不一致，请标记。
• 如果找不到计划，请停止并索取计划。