Task Drift Guard
只读漂移检测。不修改任何文件,发现偏差后 STOP 并报告,等用户决策。
触发条件(命中任一即调用)
- 连续 ≥3 次工具调用后未回读计划
- 完成 Todo 条目后 / 切换模块/文件前
- 用户反馈同一问题 ≥2 次
- 执行超过 10 分钟无阶段性产出
- 用户明确说"检查漂移"等关键词
执行步骤
Step 1: 找计划源
| 线索 | 计划源 |
|---|---|
plans/<当前目录>/task_plan.md 存在 |
读它 |
文章管线(有 data/{site}/{id}/) |
读 .execution-plan.json |
批量处理(plans/batch-xxx/plan.json) |
读它 |
| comet change 活跃 | 读 .comet.yaml 的 phase/tasks 字段 |
| 无以上线索但有明确用户指令 | 以用户原话为锚点 |
无计划源 → 输出 WARNING 后 STOP。
Step 2: 读取计划,提取信息
只读。提取:目标(Goal)、VC 条目、执行范围限制、当前 Phase。
Step 3: 获取当前状态证据
git status --short && git diff --stat
TaskList # 如有
结合会话上下文回顾已做操作。
Step 4: 比对,判态
| 状态 | 含义 | 动作 |
|---|---|---|
| ✅ ALIGNED | 与计划一致 | 继续 |
| ⚠️ DRIFT | 偏离但未阻塞 | 询问用户 |
| 🔴 BLOCKED | 严重偏离,关键路径被跳过 | STOP 等决策 |
漂移判定三原则(任一命中):改计划外文件 / 做的事与 VC 不符 / 跳过关键路径做低优先级。
Step 5: 输出报告(不写文件)
模板见 EXAMPLES.md。用 markdown 直接输出,不做任何写入。
Step 6: 按结果行动
- ✅ → 继续
- ⚠️ → 问用户:纠正/继续/STOP
- 🔴 → STOP 所有写入,等用户决策
铁律
- 只读。不改任何文件,不写日志,不 commit
- 证据优先:结论必须来自
git diff/Read/TaskList 输出,不用推测 - 范围最小化:只检查当前任务的 VC 条目,不扫描全项目