Codex 模型路由团队
把主 Agent 保持为任务总负责人,通过 Codex App 独立后台任务实现真实的 model 与 thinking 路由。禁止使用原生 spawn_agent 代替本流程。
Do not use
简单问答、状态查询、单文件小改、强顺序任务,以及发布、付款、删除、账户或生产操作不得自动派遣。
执行流程
- 检查当前指令中是否存在用户对后台任务和模型路由的明确授权。全局
AGENTS.md的长期授权有效;没有授权就留在主任务内完成。 - 读取 路由策略,判断并行收益是否高于协调成本。简单任务直接执行,不创建后台任务。
- 选择模式:默认轻量路由;满足长期、正式交付、可恢复或高风险条件时,读取 耐久模式。
- 先显示一条简短派遣通知:任务数、每个任务的模型、推理强度和职责。
- 读取 任务包模板,为每个 Worker 写完整提示词。提示词必须包含“禁止创建任何后台任务或子 Agent”。
- 读取 任务生命周期。用
codex_app__list_projects定位项目;工作区写入任务使用匹配项目,通用调研使用 projectless。用codex_app__create_thread显式传入model与thinking。 - 把第一个真实 Worker 当作健康探针:创建后立即用
codex_app__read_thread验证它已经实体化。只有读到真实 thread、cwd 与 turn 状态后,才记录为已创建并继续派遣。首个创建超时或返回未实体化状态时停止整批派遣,禁止改用 projectless 重试同一故障。 - 健康探针通过后,每波最多再创建 3 个;运行并发最多 6 个,单个根任务累计最多创建 8 个。按文件、模块、章节或主题分配互斥所有权;同一文件同一时刻只允许一个写入者。
- 用
codex_app__read_thread读取结果。信息不足时只在原任务中用codex_app__send_message_to_thread追问一次;随后升级推理、切换模型或由主 Agent 接管。每个子任务最多两次执行机会。 - 主 Agent 亲自核对事实、运行验证、处理冲突并整合最终交付。只对已实体化、状态为 completed/idle、且结果已采纳的轻量任务调用
codex_app__set_thread_archived;逐个归档并等待每次确认。失败、争议或待审任务保留。 - 最终汇报任务数、模型分布、升级/重试、采纳结果、归档情况和未解决风险。
硬性边界
- Worker 永不使用 Ultra,永不继续派生任务。
- Terra 默认不参与路由;只有用户明确要求或有任务证据时才可使用。
- 主 Agent 不切换自己的模型,不把后台任务伪称为原生 Subagent 或预制 Agent Type。
- 外部发布、发送、付款、删除、账户和生产变更始终由主 Agent 在用户授权范围内执行;Worker 只准备材料。
- App 后台任务工具不可用、项目无法安全定位或文件所有权无法隔离时,停止委派并在主任务内完成。
create_thread超时后产生的未实体化 ID 不是可管理任务。禁止恢复、追问或归档该 ID,也禁止直接修改 Codex 数据库;记录故障并停止创建。fork_thread会复制已完成历史,可能显著增加上下文成本。只有源任务历史很短且继承上下文确有价值时才能作为应急路径;其他情况由主 Agent 接管。
输出契约
交付必须完整、自洽、经过主 Agent 验证,并包含可审计的模型路由摘要。触发、并发、归档和失败边界见 验证案例。