IM.codes监督执行(Auto Supervision)完全指南:如何自动判断任务完成并让AI自我推进

原创2026-10-22 19:23:281,396 阅读

IM.codes监督执行(Auto Supervision)完全指南:如何自动判断任务完成并让AI自我推进

IM.codes 是一款面向 AI 编码 Agent 的协作平台,其中的**监督执行(Auto Supervision)**功能可以自动判断任务是否完成:当 Agent 完成一轮工作后,系统会调用你指定的监督模型做出结构化决策——继续推进、判定完成,或交还给人类,让你不再需要每轮手动输入 "continue"。本文面向新手,完整讲解 Auto Supervision 的原理、三种模式、配置步骤与容错机制。

IM.codes 监督多个 AI Agent 会话执行的桌面界面

一、为什么需要监督执行:告别手动"继续"

用过 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)与会话底部可见,你始终知道系统替你做了什么。

IM.codes 多 Agent 会话与文件面板界面

四、监督+审计模式:让另一个 AI 帮你验收

supervised_audit 模式在"完成判定"之上加了一道对等审计(peer audit):

  1. 当监督者认为任务完成、且改动值得审计(实现、修改、修 bug 类工作;纯只读查询不会触发)时,系统把本轮改动的受限摘要自动发给另一个你指定的对等会话;
  2. 对等审计者用不同模型独立复核,返回 PASS 或 REWORK;
  3. REWORK 时,系统把返工简报(rework brief)发回原会话,Agent 修复后需要重新审计,直到 PASS 或达到你设定的最大审计循环次数;
  4. 关键安全规则:审计未通过前,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"把流程打断。

IM.codes 侧边栏多服务器会话管理仪表盘

七、核心模块速查表

想深入了解实现的同学,可以从这些文件入手:

总结

IM.codes 的监督执行把"AI 干活、人类验收"变成了可配置的流水线:supervised 模式替你盯进度,supervised_audit 模式再派一个不同模型的审计者把关,全程结构化决策、全程可见、失败即回退。你只需要在前 5 分钟选好后端、模型和审计者,之后 Agent 就能自己判断"做完了没有"并自我推进——而最终的发布权,始终留在你手里。

登录后查看全文
imcodes