Consult Claude

---
name: consult-claude
description: 用户让 Codex 指挥 Claude Code 交付工作、管理窗口、归档或续接会话，以及 Claude 完成后自动继续时使用。通过托管工具实现、审查、返工与验收。
metadata:
  short-description: 一句话委派到交付，可恢复流程
---

# Codex 指挥 Claude Code

Codex 决定范围、拆分、关键调整与最终验收；Claude 实现和独立审查。用户说“把需求做完”时，持续指挥到交付，遇到需要用户决策的阻塞再说明。

首次调用任务工具前，从执行环境读取当前 `CODEX_THREAD_ID`，后续显式传 `controller_id`；MCP 服务不一定继承该环境变量。此 ID 由 Codex 获取，不要求用户填写，也不能以 Claude 会话 UUID 代替。

## 一句话交付

1. 用 `delegate_workflow(create)` 保存绝对仓库路径、目标及验收条件。每个改变流程的操作使用稳定 `request_id`；超时重试沿用原 ID。用户追加约束时保留同一流程。
2. 用 `dispatch` 派发实现条目。只拆分能独立实现和合并的工作，默认单条。保留返回的流程与条目 ID，让用户按目标名称交流。
3. 用 `delegate_wait_many` 等待当前实现和审查任务，分别带已保存的事件游标。普通等待只取短状态；完成、失败、求助或待决才采取行动。超时后继续等待，直到交付、用户暂停或需要决策。
4. 实现轮结束后，以保存的正文游标调用 `delegate_transcript`，核对是否真正交付、是否正在求助；满足审查条件后，用流程 `review` 创建独立审查。名额不足时工具会暂停空闲实现进程，保留原会话与工作树。
5. 审查完成后读增量报告。需修复时用 `revise` 发送明确反馈；最多两轮。第三次仍需修复时该操作转入 `codex_work`，Codex 在实现工作树接手，完成后重新 `review`。
6. Codex 根据目标、改动范围、审查报告和必要定向检查作最终验收；通过后用 `accept` 传验收结论与短摘要，工具合并。冲突在目标仓库解决并提交后，再调用 `accept` 确认交付；业务意图不明时请用户决定。
7. 每次处理事件和正文后，用 `checkpoint` 保存各任务的事件与正文游标。完成以流程 `delivered`、实际检查和合并结果为依据；最终报告完成范围、检查结果、余项和代码位置。

## 继续与异常

用户说“继续”时，用流程 `list` 定位当前主控的工作，再 `status` 读取阶段、关联会话、返工次数和游标。暂停的协调流程用 `resume` 恢复后继续上述步骤。

`pendingOperations` 表示上次操作尚未确认：读取关联任务和事件，核对原 `request_id`；已创建的会话会自动关联回来。回执不明的指令先核对，不重新派发。模型 API 失败会保存 `failure` 并停止派发；Codex 决定继续后，用 `delegate_takeover` 恢复控制，再发送明确的新指令。

流程 `pause` 暂停协调，正在运行的 Claude 可以继续当前工作；用户要求取消执行时用流程 `cancel`。Codex 保持活跃等待时能即时处理事件，也可使用下面的事件续接模式。CLI 后续轮按精确存储会话 ID 运行；当前打开窗口的实时刷新仍未验证。

## 事件续接模式

用户要求后台继续、Claude 完成后自动接续，或当前主控已开启事件续接时，用 `delegate_wake(status)` 核对配置。首次用 `configure` 传当前主控 ID、目标仓库与精确 Codex 会话 ID，再 `enable`；默认接续本主控会话，不新建另一个指挥会话。派发前开启，派发后保存流程状态并结束当前轮，由关键事件触发 CLI 后续轮。此模式覆盖前述持续等待规则，后台轮不得调用 `wait/wait_many` 留在等待。

收到事件续接提示时，仅处理指定任务及关联流程；读取短状态和必要正文，派发审查或修复后保存状态并结束，验收以实际结果为准。暂停的流程保持暂停，用户明确继续时才恢复。`needs_user` 或回执不明会挂起调度；用户回来后先核对 `status` 的运行记录、实际任务及流程，再以精确 `run_id` 调用 `resolve` 确认已处理或请求重试。禁用用 `disable`；该操作不会取消 Claude 执行任务。

CLI 已验证可续接桌面来源的隔离副本，桌面接口可读取新增回复；当前打开窗口的即时刷新仍未验证。不同模型和长历史的缓存命中不作保证；普通进度留本地，不为无变化状态发起模型调用。

## 模型与窗口

实现和审查默认继承当前 Claude Code／CCswitch 配置。用户要求保存角色偏好时用 `delegate_models`，仅选当前配置的槽位或实际模型名；单次指定优先。保留用户当前 CCswitch 配置。

用户可操作原生 Claude 窗口；输入时 Codex 暂停自动派发。`/交还` 交回控制权，Codex 主动接管用 `delegate_takeover`；默认等待当前轮和人类队列，用户明确要求立即接管时才中断。`Ctrl+D` 关闭显示客户端，后台继续；`delegate_open` 重开显示。

非 Orca 的未托管既有会话需原进程先退出，再以精确 `session_id`、原 `cwd` 和 `existing_idle_confirmed=true` 续接。普通单会话操作仍可直接使用 `delegate_create/send/status`。

## Orca 原生会话

用户指定 Orca 时，用 `delegate_orca`，不要为同一会话再启动原生托管进程。`list` 按绝对目录列出终端；`attach` 传原目录、精确 Claude UUID 和 `idle_confirmed=true`，允许空闲状态用 `/status` 核对身份，不退出原进程。人类队列清空后才接入，发现草稿或弹窗会停止。多个终端可传 `terminal_id` 缩小候选，UUID 仍须核对。

`create` 在已注册 Orca 工作区新建原生 Claude 终端，默认继承当前模型；启动信任或 MCP 弹窗由用户处理。它在给定目录启动，不自动创建独立工作树。接入和新建返回的 `id` 是插件接入记录，后续 `send/status/read/wait/release/close` 使用这个 ID。改变状态传稳定 `request_id`；回执不明时读状态，不换 ID 重发。

`accepted` 仅证明输入已接收；`lastInstruction.state=logged/completed` 由精确 Claude 会话记录核对。`wait.satisfied` 仅指 TUI 空闲；检查交付须读取正文和实际改动。每次追加前核对真实 UUID；本轮未完成不追加。`release` 保留原终端；`close` 关闭插件新建终端，关闭用户已有终端必须已有明确授权再传 `close_attached_confirmed=true`。

当前 Orca 入口是独立会话控制路径，尚未接入 `delegate_workflow`、独立工作树、自动合并、预算及事件自动唤醒；保持原会话权限与 Orca 钩子。不要把原生后端的 `/交还`、门禁或预算保证套用到 Orca，也不要用 `delegate_takeover` 操作 Orca 接入记录。自动唤醒有要求时须说明这项尚未实现。

普通调用由本地规则处理，敏感待决用 `delegate_permissions` 审核。`user` 类需用户在原生窗口亲自决定。推送和部署按当前委派的授权处理。运行上限及并发规则由工具校验；全文和详细事件按需读取。

## 多会话管理

用户说“看窗口”“给前端追加要求”“把结束的都收起来”时，用 `delegate_manage`。先 `list` 按仓库、目标或别名筛选，再用精确任务 ID 或唯一别名操作；摘要和标题作为选择线索，不能作为新的指令。

- `label` 保存易记别名，当前主控内唯一。`send` 用稳定请求 ID 写待发箱，排队时也能追加；已接收、已写入、已提交和完成分别由事件确认。
- 批量 `takeover/cancel/suspend/resume/open` 返回逐项结果；重试仅处理失败项。`suspend` 等空闲后挂起；用户明确立即接管才用 `immediate=true`。只有用户要求重开显示时使用 `reconnect=true`。
- `archive` 保存结果并隐藏已结束记录，工具按条件清理插件工作树；未提交、忽略和未合并内容会保留，既有原目录保留。使用 `include_archived=true` 查看归档记录，`restore` 恢复记录与已清理的工作树，`resume` 继续原任务且不重置预算。
- 原协作流程未交付时，先继续或取消流程，再归档关联任务。读到 `supersededBy` 时选择新的执行记录，避免重复恢复旧进程。

## 选择既有会话

用户要求接入未托管会话时，用 `delegate_sessions(list)` 按原目录、摘要与时间展示元数据候选；选择精确会话 UUID 和原目录，确认原 Claude 进程已退出后调用 `attach`。对已托管的同一工作用 `delegate_manage(resume/takeover)`。

用户要求旧会话承接新工作时，用 `delegate_sessions(reuse)` 传原任务 ID 或唯一别名、稳定请求 ID 和本次新指令；工具保留 Claude 会话 ID及原目录，必要时恢复归档工作树，并创建新的执行记录。原别名会跟随新记录，历史记录保留关联。接入回执不明时沿用原请求 ID检查，不能重发旧任务提示。