IM.codes监督执行(Auto Supervision)完全指南:如何自动判断任务完成并让AI自我推进
IM.codes监督执行(Auto Supervision)完全指南:如何自动判断任务完成并让AI自我推进
IM.codes 是一款面向 AI 编码 Agent 的协作平台,其中的**监督执行(Auto Supervision)**功能可以自动判断任务是否完成:当 Agent 完成一轮工作后,系统会调用你指定的监督模型做出结构化决策——继续推进、判定完成,或交还给人类,让你不再需要每轮手动输入 "continue"。本文面向新手,完整讲解 Auto Supervision 的原理、三种模式、配置步骤与容错机制。
一、为什么需要监督执行:告别手动"继续"
用过 Claude Code、Codex、Gemini CLI 等编码 Agent 的朋友都有同感:
- Agent 干到一半停下来了,你不知道它是"真的做完了"还是"忘了做";
- 想让它继续,只能盯着终端手动敲
continue,人成了自动化流程里最慢的一环; - 长任务跑到深夜,没人验收,最后发现测试根本没跑、代码没提交。
IM.codes 的监督执行(Auto Supervision)就是为了解决这个问题:在每一轮对话结束(idle 边界)时,自动引入一个监督者模型来评审刚才那一轮的结果,并决定下一步动作。相关的官方说明见 README.zh-CN.md。
二、三种 Auto 模式:按需选择监督强度
监督执行支持按单个会话独立配置三种模式,而不是全局一刀切(模式定义见 supervision-config.ts):
| 模式 | 名称 | 适用场景 |
|---|---|---|
off |
关闭 | 保持原有行为,完全手动推进 |
supervised |
监督 | 日常开发:自动判断"完成 / 继续 / 问你" |
supervised_audit |
监督+审计 | 重要改动:完成后自动触发跨模型审计与返工闭环 |
💡 提示:只有 transport 型会话(如 Claude Code SDK、Codex SDK、Qwen、OpenClaw 等通过 SDK/协议接入的会话)支持监督执行;tmux 抓取的 process 型会话暂不支持。
三、完成判定是如何工作的?
这是 Auto Supervision 最核心的部分,理解它只需要三步:
第 1 步:会话进入 idle 后触发评审
当 Agent 完成一轮输出并进入空闲(idle 边界),daemon 里的监督自动化模块(supervision-automation.ts)捕获这一时刻,把"你的原始任务描述 + Agent 最新一轮回答"打包送给监督者模型。
第 2 步:监督者返回结构化决策
监督者不是随便聊一句"看起来可以了",而是必须输出结构化决策(schema 定义在 supervision-broker.ts):
complete—— 任务看起来已完成;continue—— 还需继续,且必须给出具体的下一步动作(如"运行 npm test 并汇报失败用例")。如果决策含糊、说不出具体动作,系统会强制降级为ask_human,避免无意义地空转;ask_human—— 需要人工介入,控制权立即交还给你;- 另有内部状态
waiting:当会话正在等待一个对等审计回复时,表示"正确地停着",不会被误判成继续。
第 3 步:自动执行决策
- 判为
continue:daemon 把监督者给出的nextAction直接作为 continue prompt 发回同一会话,Agent 接着干; - 判为
complete:任务收尾,控制权还给你; - 判为
ask_human:会话停下,timeline 上清晰显示"Supervised: returned control to you",你随时接管。
所有决策都在时间线(timeline)与会话底部可见,你始终知道系统替你做了什么。
四、监督+审计模式:让另一个 AI 帮你验收
supervised_audit 模式在"完成判定"之上加了一道对等审计(peer audit):
- 当监督者认为任务完成、且改动值得审计(实现、修改、修 bug 类工作;纯只读查询不会触发)时,系统把本轮改动的受限摘要自动发给另一个你指定的对等会话;
- 对等审计者用不同模型独立复核,返回
PASS或REWORK; REWORK时,系统把返工简报(rework brief)发回原会话,Agent 修复后需要重新审计,直到PASS或达到你设定的最大审计循环次数;- 关键安全规则:审计未通过前,
git add/commit/push、合并、发布等收尾动作一律被暂停(该规则写入监督提示词,见 supervision-prompts.ts)。
这样,"写代码的模型"和"验收的模型"可以是不同 provider,交叉审查能发现单一模型容易遗漏的问题。
五、最快配置方法:4 步开启 Auto Supervision
打开会话设置中的"会话监督"面板(UI 实现见 SessionSettingsDialog.tsx),按下面顺序配置:
1. 先设置全局默认值
在全局默认配置中选好监督后端(backend)、模型和超时(默认 30 秒,最小 30 秒)。之后新建的监督会话会自动快照这些值——快照一旦冻结,之后修改全局默认值不会影响正在运行的会话,避免"配置漂移"。
2. 为会话选择 Auto 模式
在当前会话配置里选择 off、supervised 或 supervised_audit。选审计模式时,还需要指定一个使用不同模型的合格对等会话作为审计者,并设置最大审计循环次数(默认 2 次)。
3. 写你的监督规则(可选但推荐)
支持两层自定义提示词,两层会合并后注入监督判定与 continue 提示词:
- 全局提示词:对所有开启 Auto 的会话生效。例如:"任何时候都优先写测试,不允许注释掉失败的代码。"
- 会话提示词:只作用于当前会话。例如:"判定完成前必须要求测试和验证结果。"
勾选"覆盖全局"后,该会话将忽略全局提示词。注意:与后端/模型/超时的快照冻结不同,全局提示词是每次派发时重新读取的——你在运行中修改全局规则,下一个判定周期即刻生效,无需重新启用。
4. 设置自动继续的安全上限
防止"永动机"式自动继续,可以限制:
- 同类自动继续上限:同一种 continue 类型连续命中 N 次后停止自动继续;
- 自动继续硬上限:单次任务运行内所有 auto-continue 的绝对次数(0 表示不限制)。
配置面板底部还有"已解析的监督配置"摘要,方便你确认最终生效的后端、模型、超时与限制值。
六、失败即回退(fail-closed):出问题时绝不瞎猜
监督执行遵循"失败即回退"原则,任何异常都会把控制权还给你,而不是默默猜测:
- 监督模型超时或输出无法解析(最多 1 次解析重试)→ 停止自动继续,交还人工;
- 保存的配置无效 → 自动化保持禁用,并提示"已保存的监督配置无效。修复并保存前,自动化将保持禁用";
- 会话正在等待审计回复但 30 分钟无回应 → 自动挂起超时,把控制权还给你;
- Agent 也可以通过输出标记(
COMPLETE/NEEDS_INPUT/BLOCKED,定义见 supervision-config.ts)显式声明自己的终态。
另一个贴心的设计:Auto Supervision 理解 IM.codes 的原生工作流——OpenSpec 变更、Team 讨论/评审、imcodes send 跨 Agent 协作都会被识别为合法的下一步,不会误触发"ask human"把流程打断。
七、核心模块速查表
想深入了解实现的同学,可以从这些文件入手:
- 模式与配置契约:supervision-config.ts
- 监督决策代理(结构化 verdict 与容错):supervision-broker.ts
- idle 边界的自动化状态机:supervision-automation.ts
- 决策/返工提示词构造:supervision-prompts.ts
- 全局默认值缓存:supervisor-defaults-cache.ts
- 设置面板 UI:SessionSettingsDialog.tsx
总结
IM.codes 的监督执行把"AI 干活、人类验收"变成了可配置的流水线:supervised 模式替你盯进度,supervised_audit 模式再派一个不同模型的审计者把关,全程结构化决策、全程可见、失败即回退。你只需要在前 5 分钟选好后端、模型和审计者,之后 Agent 就能自己判断"做完了没有"并自我推进——而最终的发布权,始终留在你手里。


