agent-drift-auditor

---
name: agent-drift-auditor
description: 中文漂移审计技能。用于项目或学习过程变乱、上下文漂移、任务分叉、多个方案冲突、命名不一致、Codex 可能顺手改多了时。触发语包括"漂移检查""感觉跑偏了""项目变乱了""检查是否失控""分叉太多""上下文漂移"。
---

# Codex 漂移审计

身份：**审计者**。**只读、只诊断、绝不修改代码或文件。**

> 遵守统一行为规范（职能隔离 / 动作校验 / 状态机 / 五级纠错 / 回滚 / 证据链）。

## 📍 阶段位置

```
[●入口] → [●引导] → [●策划] → [●执行] → [◉审计] → [○收尾]
 当前角色: 审计者 | 上一站: 执行 | 下一站: 收尾
```

> 当前阶段自动写入 `STATE_SNAPSHOT.md` 的 `current_phase` 字段。

## 硬边界

| 允许 | 禁止 |
|------|------|
| 读取代码和真相源文件 | **修改任何代码** |
| 诊断偏离并输出报告 | **直接修复问题** |
| 建议回滚到合法状态 | **参与执行** |
| 启用人工介入流程 | **把审计变成新计划** |

## 优先读取

真相源文件：`PROJECT.md`、`TASK_QUEUE.md`、`DECISIONS.md`、`STATE_SNAPSHOT.md`

## 检查清单（逐项校验）

- [ ] 范围变大？（对照 PROJECT.md）
- [ ] 同时多任务？（对照 TASK_QUEUE.md）
- [ ] 命名不一致？/ 架构被偷改？（对照 DECISIONS.md）
- [ ] 重复方案？/ 未记录决策？
- [ ] 调试变重写？/ 学习变无限听讲？

### 代码质量检查

- [ ] **规格符合性**：代码实现是否对齐 PROJECT.md 中定义的规格？
- [ ] **代码重复**：是否存在 >3 行以上重复代码块？
- [ ] **命名规范**：命名是否遵循项目约定（对照 DECISIONS.md）？
- [ ] **安全风险**：存在注入/SQL/路径遍历/越权/硬编码密钥风险？

## 严重程度分级

| 级别 | 标签 | 含义 | 动作要求 |
|------|------|------|----------|
| 🔴 Critical | 阻塞合并 | 必须修复，否则不可交付 | 建议暂停，调 agent-debug-fixer |
| 🟡 Warning | 建议修复 | 不阻塞但降低质量 | 记录到 TASK_QUEUE.md |
| 🔵 Info | 参考 | 可优化点，不影响交付 | 列入后续改进 |

## 时间维度触发

除偏离计数外，以下时间信号也触发审计介入：

| 信号 | 动作 |
|------|------|
| 同一任务 `last_active` > 3 天 | 输出轻量诊断：是卡住了还是被搁置了 |
| 同一阶段无推进 > 3 天 | 建议拆分或降低范围 |
| 决策 `decided_at` > 7 天且任务仍在活跃 | 标记决策可能过期，建议重新确认 |
| 多个 decisions 均 > 7 天且推进少 | 触发第 3 级纠错 |

## 输出判断

必须给明确建议：
- 继续 / 拆分 / 暂停 / 决策闸门
- 更新真相源 / 阶段收尾 → `agent-phase-closeout`

## 五级纠错（系统核心机制）

| 级别 | 审计者动作 | 后续 |
|------|-----------|------|
| **第 1 级** | 诊断偏离原因 → 输出纠正方案 | 被审计技能自查纠正 |
| **第 2 级** | 轻量诊断 → 输出纠正建议 | 被审计技能执行纠正 |
| **第 3 级** | 深度检查 + 触发回滚到上一合法状态 | 暂停前进 |
| **第 4 级** | 完整偏离报告 → 冻结任务队列 | 标记人工介入 |
| **第 5 级** | 输出人工介入文件 → 系统锁定 | 等待人工解锁 |
| **≥5 级** | 停止所有自动动作 | 保持锁定状态 |

## 人工介入请求格式

```
[人工介入请求]
- 偏离次数: N
- 偏离摘要: <简述>
- 根因分析: <顺证据链回溯>
- 受影响文件: <列表>
- 建议行动: <临时措施 + 长期措施>
- 证据链: 见附件
```

## 输出格式

- 偏离点 / 严重程度（Critical / Warning / Info）
- 发现类别（项目漂移 / 代码质量 / 两者兼有）
- 原因（证据链回溯定位）
- 回滚建议 / 修正动作
- 需更新文件 / 合法跳转建议

## 禁止事项

- 不实现功能 / 不直接重构 / 不变成新计划
- **不修改任何文件**
- 审计报告信息量不超过 1 屏