14
Tmux · workflow

claude-tmux-delegation-driver

14-claude-tmux-delegation-driver.md
🎯
P1 source: codex-sessions created: 2026-06-13
◉

WHAT IS THIS

定位

Codex 驱动 tmux 里的 Claude 执行长任务的 workflow。Codex 不直接抢写全部内容，而是负责派发、观察、续推、验证、收口。

⚡

TRIGGERS

触发场景
▸Claude 已经在 tmux 里有长任务上下文。
▸文档、PRD、计划需要 Claude 继续写，但 Codex 负责把关。
▸多 agent 混用时，需要一个 driver 统一状态。
▸用户希望“让 Claude 继续，我这边帮我盯着”。
↹

INPUT & OUTPUT

输入 / 产出
↘ INPUT
  • tmux session/window/pane。
  • Claude 当前任务目标。
  • 目标 repo 和 branch。
  • 期望产出文件。
  • 验证命令。
↗ OUTPUT
  • 投递给 Claude 的精确任务。
  • 观察日志。
  • Claude 改动范围。
  • Codex 验证报告。
  • 必要的收口 patch。
🪜

STEPS

编排步骤
  1. 1
    定位 pane
    找到目标 tmux session、window、pane，确认 Claude 当前是否 idle。
  2. 2
    读当前状态
    看 git status、目标文件、pane 输出。不要直接假设 Claude 做完了。
  3. 3
    投递短任务
    每次只给 Claude 一个明确目标、文件范围、验收口径。
  4. 4
    观察进展
    定期检查 pane、git diff、文件更新时间。
  5. 5
    续推或纠偏
    如果 Claude 停在选择、格式错误、跑偏，发短指令，不重开大段上下文。
  6. 6
    收口验证
    pane idle 后，Codex 跑 diff check、lint、docs check、测试。
  7. 7
    记录归属
    最终说明哪些文件由 Claude 改，哪些由 Codex 验证或补丁。
⚙

AGENT ROLES

Agent 分工
⚙
Driver
Codex 主线程。
⚙
Claude Worker
tmux 里的 Claude。
⚙
Verifier
可由 Codex 或另一个 agent 做只读审查。
✓

ACCEPTANCE GATE

验收 gate
⊘

FAILURE HANDLING

失败处理
⊘
Claude 卡住时，先发一句短续推，不发长 prompt。
⊘
Claude 写偏时，明确文件范围和删除/保留边界。
⊘
tmux 状态不可读时，停止并让用户确认。
⊘
不要在未验证 Claude diff 前提交。
⌘

TEMPLATE

投递模板
TEMPLATE
继续当前任务，只处理这些文件：
- ...

目标：
- ...

验收：
- ...

不要改：
- ...