浏览器步骤别派给 Codex:同一张卡三轮 blocked,拆开后一轮通过

1 阅读6分钟

结论先说:凡是要打开网页、登录、截图、上传、录屏的步骤,我不再派给 Codex。 这些步骤由负责验收的 Claude Code 用浏览器扩展做,或者写成“人工前置条件”交给我本人。Codex 只做本机能完成的制作和代码。

这条规则来自一条视频内容线。下面是两期节目的回执记录。

第一期:6 轮里 5 轮停在浏览器门口

10 月 26 日,一期节目要在某在线设计工具里生成素材并录屏。任务卡派给 Codex,阶段 A 一共跑了 6 轮,前 5 轮全部 blocked,每轮卡住的原因都不一样:

  1. 工具没登录,按卡里的前置检查停下,等我登录。
  2. 页面弹出“免费试用 30 天”。卡里写了“出现任何付费、升级或试用提示就停下”,于是停了。
  3. 账户页和设置页都报服务端错误,没法确认套餐和剩余额度。
  4. 录屏要用浏览器的调试协议,权限检查返回“用户未批准”,而且不允许绕过。
  5. 生成了一次图,第一张下载被浏览器自动存进了默认下载目录,违反了“只写本期目录”的边界,停下等我决定。

第 6 轮才通过。

每一次停下,Codex 都做对了:它没有猜,没有绕,也没有替我点“试用”。问题不在执行方,而在这张卡:它把五个只有人能解决的前置条件,藏在了一个执行任务里。每碰到一个,就消耗一整轮。

第二期:三轮同一句报错

10 月 29 日到 30 日,下一期要先在网页上做一次转写测试并截图。三轮回执的阻塞原因是同一句话:

The browser access host is unavailable

  • 第 1 轮:前置检查就失败,四项测试一项没跑。
  • 第 2 轮:本机能做的部分做完了,包括音频准备、一项转写测试和打分脚本,源码 +166 行。网页部分重试一次,还是同一句。
  • 第 3 轮:唯一一次浏览器检查失败,立即停下,本轮源码零新增。

10 月 31 日查明了根因:由脚本派出的 Codex 线程,拿不到 App 签发的浏览器插件凭据。 这和网络开关无关:第 1 轮派发时网络是开着的,照样不行。也就是说,这张卡从一开始就不可能在 Codex 那边完成,再派第 4 轮也一样。

拆开之后

同一天,这一期被拆成两部分:

  • 浏览器部分:打开网页、截图、上传,由 Claude Code 通过浏览器扩展执行,需要我先连一次扩展。
  • 本机制作部分:配音、字幕、合成、质检,新开一张卡派给 Codex。卡的授权节写明不开网络、不开 MCP,验收清单里写明“无浏览器访问”。

本机制作这张卡第 1 轮就是 done:成片 229.5 秒,源码 +447 行(预算 700 行),25 项自检通过,human_action: none。

规则生效后,后面两期一共 9 轮回执里有 3 轮 blocked,原因分别是引文出处对不上、读写范围冲突、配音被截断。没有一轮是因为浏览器。

规则落在哪里

文字规则只有一句,写在派发 skill 的“派出前自检”里:浏览器步骤不派。 打开网页、截图、上传、登录态操作,一律写成验收方的步骤,或写成人工前置条件。

光靠这一句会被忘,所以有三处由脚本兜底:

  1. 任务卡自检脚本 check_card.py 要求卡里必须有 ## 人工前置条件 这一节,缺了就不让派。这一节要写清楚登录、浏览器或录屏权限、付费档位、下载目录这些事我是否已经做完、确认过。没有就写“无”,但不能不写。逼着写卡的人在派之前想一遍:这张卡有没有只有人能做的步骤。
  2. 同一个脚本拒绝第 3 轮。 卡里记到“第 3 轮”时直接报错:拆卡,或者带证据交给我。按这条规则,第二期那张卡不会有第 3 轮。
  3. 派发脚本 codex_thread.py 默认关闭插件、App 和 MCP。 想打开得显式加参数,而且仍然拿不到浏览器凭据。这样“开个插件试试”这条路也就堵上了。

需要说明的是:脚本查不出一张卡里有没有浏览器步骤,这一判断还是靠写卡的人。脚本能保证的是,写卡的人不能跳过这个问题,而且就算判断错了,最多也只浪费两轮。

可以拿走的做法

在你的任务卡模板里加这一节,派发前的检查脚本只需要检查这个标题在不在:

## 人工前置条件

执行前我已完成并确认(没有就写“无”):
- 登录:
- 浏览器 / 录屏权限:
- 付费档位、试用提示怎么处理:
- 下载目录:

然后按这三条拆卡:

  1. 只有人能做的,写进前置条件,派之前做完。 登录、两步验证、付费确认都属于这一类。
  2. 要用浏览器但不需要人的,交给有浏览器的那一方做验收步骤。 不交给拿不到凭据的执行方。
  3. 剩下的本机工作才派出去,授权节里关掉网络和插件。 关掉以后,即使它想上网也做不到,卡的边界和实际权限就一致了。

判断一个步骤该不该派,可以问一句:“如果它卡住了,是重试能解决,还是只有我能解决?” 只有我能解决的,就不该出现在执行卡里。

这是系列第 5 篇。前几篇讲了任务卡、钩子、线程可见性和环境归还。如果你也让 Agent 碰过浏览器,欢迎在评论里讲讲卡在了哪一步。

数字说明

  • 来源:派发证据目录里两期节目的逐轮回执(status 与 blockers 字段),以及 2026-10-26、2026-10-31 两次协作复盘。
  • 第一期:2026-10-26 阶段 A 共 6 轮回执,前 5 轮 blocked、第 6 轮 done;五条原因逐条摘自回执。
  • 第二期:2026-10-29 至 10-30 共 3 轮回执,全部 blocked,报错原文一致;第 1 轮派发参数里网络开着(networkAccess: true)。拆分后的本机制作卡在 2026-10-31 一轮 done,229.5 秒、+447 行、25 项自检均出自该轮回执。
  • “后面两期 9 轮回执 3 轮 blocked”:统计的是规则生效后两期节目目录下的全部回执文件,截至 2026-11-17。
  • 根因来自 2026-10-31 内容线会话的排查结论,没有单独做可复现实验。