# Codex Model Routing Team

> 在 Codex App 中为复杂、可并行的知识工作或编程任务创建可指定模型与推理强度的后台任务，由主 Agent 负责规划、provider 数据边界、分工、集成和验收。用于多来源调研、多章节内容、复杂 Skill/PPT、跨模块开发、独立验证或 2 个以上互不依赖工作流；也用于用户明确要求模型路由、后台 Worker、Agents Team、Grok/Gemini Worker 或持久项目协作。简单问答、状态查询、单文件小改、强顺序任务和发布/付款/删除/账户操作不得自动触发。

- **Type:** Skill
- **Install:** `agentstack add skill-zjp1997720-zhijian-skills-codex-model-routing-team`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zjp1997720](https://agentstack.voostack.com/s/zjp1997720)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zjp1997720](https://github.com/zjp1997720)
- **Source:** https://github.com/zjp1997720/zhijian-skills/tree/main/skills/codex-model-routing-team

## Install

```sh
agentstack add skill-zjp1997720-zhijian-skills-codex-model-routing-team
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Codex 模型路由团队

主 Agent 始终是任务总负责人。后台 Worker 通过 Codex App 独立 Thread 获得真实的 `model` 与 `thinking` 路由；本 Skill 不使用原生 `spawn_agent` 冒充模型路由。

## Do not use

简单问答、状态查询、单文件小改、强顺序任务，以及发布、付款、删除、账户或生产操作不得自动派遣。外部或不可逆动作只能由主 Agent 在用户授权范围内执行，Worker 只准备材料。

## 上游 Skill 模式

当 Deep Research、PPT、课程生产或其他上游 Skill 已经定义任务拆分、阶段顺序、文件路径和验收标准时，读取 [上游 Skill 适配协议](references/upstream-skill-adapter.md)。上游 Skill 保持业务流程主权；本 Skill 只负责模型路由、provider 门、Thread 创建、并发额度、运行读取和归档。

禁止重复执行 Scale、改写上游阶段依赖或创建第二套事实源。安全上限仍然生效；预算不足时收敛 Worker 数量并明确报告。

## 执行流程

1. 检查当前指令中是否存在用户对后台任务和模型路由的明确授权。全局 `AGENTS.md` 的长期授权有效；没有授权就留在主任务内完成。
2. 读取 [模型注册表](references/model-registry.json)、[路由策略](references/routing-policy.md) 与 [Provider 策略](references/provider-policy.md)。先固定任务画像、数据边界、有序候选链和最低 `thinking`，再创建任何 Thread。
3. 独立任务由本 Skill 判断并行收益；上游 Skill 模式直接采用上游 Scale 和任务包，只施加安全上限。预计超过 30 分钟、正式交付物达到 4 个、需要恢复或涉及高风险审批时，读取 [耐久模式](references/durable-mode.md)。
4. 按 [任务生命周期](references/thread-lifecycle.md) 做分层预检：注册表与 live runtime 元数据负责静态可接受性；Provider 策略负责账号、条款和数据边界；可用时运行不占 App Thread 的语义 canary；每个新 `host/model/thinking/tool-signature` 的第一个真实业务 Worker 负责最终数据面探针。缺少任一层证据时不得把局部检查写成 `route_eligible=true`。
5. 派遣前显示一条简短通知：任务数、每个任务的精确模型、`thinking`、职责、预声明 fallback，以及为后续阶段和重试预留的累计额度。Gemini Antigravity 路径必须说明 manual-only 状态和账号风险。
6. 读取 [任务包模板](references/task-packet.md)，为每个 Worker 写独立可执行的完整提示词。提示词必须包含“禁止创建任何后台任务、线程或子 Agent”。
7. 用 `codex_app__list_projects` 定位项目；任何声明工作区输出路径的任务都使用匹配 project local，只有纯聊天交付才能 projectless。调用 `create_thread` 前先消耗一次 root `creation_attempt` 和 subtask attempt，并按 [审计 schema](references/audit-schema.json) 建立 `thread_id: null` 的 ledger 记录；再显式传入 RoutePlan 的 `model` 与 `thinking`。
8. `create_thread` 返回正式 `threadId` 后立即写回 ledger，再用 `codex_app__read_thread` 验证实体化。读到真实 thread、cwd 与 turn 状态后标记 `materialized=true`。首个 assistant-originated 输出项或模型发起的工具调用出现后标记 `data_ready=true`；用户消息、Thread 元数据和 MCP 启动错误不计入 `DATA_READY`。
9. 每波最多再创建 3 个；运行并发最多 6 个，单个根任务最多发起 8 次 `creation_attempt`，未实体化、超时歧义和 fallback 尝试都计数。创建前扣除上游后续阶段和失败恢复的 reserved slots。按文件、模块、章节或主题分配互斥所有权；同一文件同一时刻只允许一个写入者。
10. 按 [恢复策略](references/recovery-policy.md) 分类失败。完整输出质量不足时只在原 Thread 追问一次；仍失败才创建预声明 fallback Worker。每个子任务最多创建两个 Worker Thread，禁止运行时随机选模、循环回退或静默降低 `thinking`。
11. 主 Agent 亲自核对事实、运行验证、处理冲突并整合最终交付。只对已实体化、completed/idle、输出文件已经验证、且结果已采纳的轻量任务逐个调用 `codex_app__set_thread_archived`；失败、争议或待审任务保留。
12. 所有 Worker 记录遵守 [审计 schema](references/audit-schema.json)，包含 `creation_attempt / subtask_attempt / thread_id / role / model / requested_model / platform_accepted_model / observed_runtime_model / thinking / route_plan / provider_policy / materialized / data_ready / status / output / adopted / fallback_reason / archived`。`model` 保持为 `requested_model` 的兼容别名；平台没有回显真实模型时，`observed_runtime_model` 记为 `unknown`。最终汇报模型分布、预检、重试、升级、采纳、归档和未解决风险。

## 硬性边界

- 自动候选、manual-only 候选、精确模型 ID 与支持的 `thinking` 以 [模型注册表](references/model-registry.json) 为策略事实源；Codex App live 工具元数据只验证当前 host 是否接受该组合，不能静默扩张策略。
- `gpt-5.6-luna` 与 `gpt-5.6-sol` 是稳定基线；`xai/grok-4.5` 通过 runtime/provider 预检后可作为条件自动候选。
- `antigravity/gemini-3.6-flash` 默认 manual-only，不进入自动路由或静默 fallback。显式点名、风险确认和数据允许仍不能覆盖 `terms_status: blocked`；当前第三方 Antigravity 登录路径不得创建，正式 API 路径必须作为新的 registry entry 接入。
- 禁止自动回退到 `gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini` 或 `gpt-5.3-codex-spark`。Terra 默认关闭；只有用户明确要求或有任务证据时才可使用。
- Worker 永不使用 Ultra，永不继续派生任务。fallback 不得低于任务声明的最低 `thinking`。
- 主 Agent 不切换自己的模型，不把后台任务伪称为原生 Subagent 或预制 Agent Type。
- App 后台任务工具不可用、项目无法安全定位、Provider 数据边界不允许或文件所有权无法隔离时，停止委派并在主任务内完成。
- `create_thread` 超时后产生的未实体化 ID 不是可管理任务。禁止恢复、追问或归档该 ID，也禁止直接修改 Codex 数据库；记录故障并停止同批创建。
- MCP 初始化错误按 workspace/tool signature 处理，不通过连续换模型掩盖环境故障。
- `fork_thread` 会复制已完成历史，可能显著增加上下文成本。只有源任务历史很短且继承上下文确有价值时才能作为应急路径；其他情况由主 Agent 接管。
- 上游 Skill 的阶段门优先于并行收益；存在 verifier → reviewer 等依赖时必须串行创建。

## 输出契约

交付必须完整、自洽、经过主 Agent 验证，并包含可审计的模型路由摘要。上游 Skill 模式另外报告 reserved slots、阶段门、输出采纳和归档状态。触发、并发、provider、恢复和归档边界见 [验证案例](references/validation-cases.md)。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zjp1997720](https://github.com/zjp1997720)
- **Source:** [zjp1997720/zhijian-skills](https://github.com/zjp1997720/zhijian-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zjp1997720-zhijian-skills-codex-model-routing-team
- Seller: https://agentstack.voostack.com/s/zjp1997720
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.