remote-drive

name	remote-drive
description	用一个 Claude (driver) 通过 tmux 远程控制另一个 Claude Code session (sub-agent CC) 走完 pipeline。把 sub-agent 当 worker 用：driver brief 任务 → send-keys 输入 → capture-pane 监听 → 处理 AskUserQuestion → 等下次 idle。Use when user says "remote drive", "驱动另一个 cc", "sub-agent cc", "控制别的 claude", "tmux drive", "我已经开了 cc 你来控制".
argument-hint	[--target tmux-session:window] [--brief brief.md]
allowed-tools	Bash(*), Read, Write

/remote-drive — 远程驱动一个 tmux 里的 sub-agent CC

实战经验：driver Claude 控制 vla3d project 里另一个 Claude Code，走完 Stage 1-4。 完整 transcript 在 Auto-Production GitHub PR/issue history。

Overview

driver 通过 4 个 tmux 原子操作完成全程：

操作	何用
tmux capture-pane -p -t <target> -S -<N>	读 sub-agent 当前屏（含 askuser UI）
tmux send-keys -t <target> "text" Enter	发消息
tmux send-keys -t <target> Escape	清 input 框（sub-agent 自动 suggest 文本不会真 submit）
tmux send-keys -t <target> Enter	在 AskUserQuestion UI 里 select 当前 highlight option

When to Use

• 一个 Claude 跑长任务，另一个 driver Claude 盯着它（dual-monitor 模式）
• 测一个 skill bundle，driver 验完整路径而 sub-agent 实际执行
• 夜间 wrapper：driver = ScheduleWakeup poller，sub-agent = autonomous loop
• 多 sub-agent 编排（driver 控 N 个 cc 窗口分头跑实验）

Critical patterns (实战发现)

实战来源标记：⓪=vla3d Stage 1-4 walkthrough；①=vla3d Stage 5 implementation； ②=vla3d hpcc deploy round 3。

1. CC UI 假"pending input"陷阱 ⚠️ ⓪

Sub-agent 写完一段后自动在 input 框 suggest 下一动作的文字（如「进 Stage 2」「直接进 Stage 3」「等 datalake 完成再继续」）。看起来像 pending 输入但按 Enter 不会 submit。 正确做法：先 Escape 清 input，再 send-keys "your message" Enter。

tmux send-keys -t research:vla3d Escape
sleep 1
tmux send-keys -t research:vla3d "go Stage 5" Enter

2. AskUserQuestion UI 导航 ⓪

Sub-agent 弹 multi-choice 时屏幕显示：

❯ 1. PROCEED ...
  2. REFINE ...
  3. PIVOT ...

Enter to select · Tab/Arrow keys to navigate · Esc to cancel

• 直接 Enter = 选当前 ❯ 高亮的（默认 option 1）
• 选别的：Tab（下） / BSpace 或 Up （上）N 次再 Enter
• multi-choice 后会再问「Submit answers?」，再发一次 Enter 才真提交

3. Wait-for-idle 检测 ⓪①

不要 sleep 30 后盲读——sub-agent 可能还在思考或刚开始新工具调用。用 polling：

# idle = pane content 不变 AND 末尾有 "^❯ $" 空 prompt AND 无 busy marker
prev=""; stable=0
while true; do
  pane=$(tmux capture-pane -p -t $TARGET)
  h=$(echo "$pane" | md5sum | awk '{print $1}')
  busy=$(echo "$pane" | tail -10 | grep -cE \
    "Jitterbugging|Twisting|Blanching|Churned|Spawning|Editing|Reading|Searching|esc to interrupt|✶|✻|Submit answers")
  empty=$(echo "$pane" | tail -8 | grep -c "^❯ *$")
  if [ "$h" = "$prev" ] && [ "$busy" -eq 0 ] && [ "$empty" -ge 1 ]; then
    stable=$((stable+1))
    [ $stable -ge 5 ] && { echo IDLE; break; }
  else
    stable=0; prev="$h"
  fi
  sleep 3
done

跑成 background task（run_in_background: true），不阻塞 driver 处理别的事。

4. 长 brief 用文件而非 send-keys ⓪

200 字符的 brief 直接 send-keys 经常被 cc 截断或排版乱。改成写文件：

cat > .driver_brief.md <<EOF
# Brief for sub-agent
... 详细任务 ...
EOF
tmux send-keys -t $TARGET "读 .driver_brief.md 然后按里面要求走" Enter

5. 报告频率契约 ⓪

Brief 里强制要求 sub-agent 每段大动作 + stage 末尾用 /conclusion-first 5-段格式汇报，driver 读 capture-pane 拿摘要。否则 driver 要爬全屏 N 段才能拼出来。

6. 批量授权减少 round-trip ①

每个 sub-section 等 driver approve 一次特别慢（cc 思考 + driver 看 + 决策 + 类 + 等）。 观察到 sub-agent 计划清晰可信时，一次 batch authorize 全部剩余 step：

go all remaining 5.3 → 5.7，不要停，只有 blocking 才 ask。

cc 会一气呵成完成全部并最后 5-段汇报。要点：

• 只在 sub-agent 已经报过完整 plan + 你 reviewed approved 后才用 batch
• batch 内的 AskUserQuestion 仍会停下来——这是 feature 不是 bug
• 若 batch 中途出意外，sub-agent 应主动停下报告

7. driver findings 文件 round-N 化 ②

driver 跑 hpcc / 远程发现新 bug 后不要直接 send-keys 长 message——会被 cc UI 截断 / 排版乱。 正确做法：

1. driver 写 <project>/.driver_findings_<contextN>.md（如 .driver_findings_hpcc_w1.md）
2. send-keys "读 .driver_findings_hpcc_w1.md 按里面修" 触发 cc
3. cc 自己 git commit 时 .gitignore 排除该文件（避免提到 driver 私有 channel 进 repo 历史）

详细 spec 见 /driver-findings skill。

8. ssh + sub-agent 链式坑 ②

如果 driver 想自己跑 ssh 到 hpcc 抓证据再回喂 sub-agent，注意：

• ssh non-interactive shell 不读 .bashrc → conda / slurm 命令找不到。
  • 必须 ssh hpcc bash -l /path/to/script.sh 或脚本头加 source $(conda info --base)/etc/profile.d/conda.sh
• 多 conda 安装同时存在时，conda activate <name> 失败但 conda activate /full/path/to/env 成功
• 大量 quote 嵌套（ssh→bash→python -c→...）容易爆 → 直接 scp 一个 .sh 过去再 ssh 跑
• 见 hpcc deploy probe 示范：scp /tmp/probe.sh hpcc:/tmp/ && ssh hpcc bash -l /tmp/probe.sh

9. busy-marker 维护 ⚠️ ①

cc 用 30+ 种 "thinking" 动词标 spinner（Jitterbugging / Twisting / Blanching / Churned / Spawning / Editing / Reading / Searching / Whirlpooling / Billowing / Crunched / Cooked / Sautéed / Baked / Mulling / Doing / Harmonizing / Combobulating / Nebulizing / Brewed / Cogitated / Befuddling / Frosting / ...），不断添加。

watcher 的 busy-marker regex 必须定期补全——否则会把 thinking 误判为 idle 触发 watcher 提前 fire。推荐：用宽松 fallback \(.*[0-9]+s · 匹配「N 秒 · 」时间标记（普适），

• 显式动词 list 作 fast-path。完整 list 见本 skill 末 §Constants。

Workflow

Phase 0 — pre-flight

# 验证 target tmux window 存在 & cc 在 prompt
tmux list-windows -t <session> | grep -q $WINDOW || exit 1
tmux capture-pane -p -t $TARGET | tail -8 | grep -q "^❯" || exit 1

Phase 1 — 写 brief

把任务、约束、报告契约写进 <project>/.driver_brief.md。必含：

• 你是 sub-agent 角色定位
• 工作目录 + 已就绪的前置
• 目标任务（数字化、可验收）
• 约束（什么能做、什么不能）
• 报告频率 + 5-段格式要求
• 第一步立刻执行什么

Phase 2 — kick off

tmux send-keys -t $TARGET "读 .driver_brief.md 然后按里面要求走" Enter

Phase 3 — drive loop

loop:
  wait_for_idle (background)
  capture pane to see latest output
  if AskUserQuestion detected:
    decide option N
    send Enter (or Tab×N then Enter)
    submit confirmation Enter
  elif report 5-段 detected and task incomplete:
    Escape; send next-step prompt; Enter
  elif task complete (sub-agent says STOP or final report):
    break

Phase 4 — handoff

Sub-agent 末尾汇报后：

• driver commit sub-agent 产物
• driver 写自己的 5-段汇报回给 user
• 可选：sub-agent 继续 standby 等 user 下一轮 brief

Constants

• CAPTURE_LINES = 300（足够看到 1-2 个 AskUserQuestion + 上下文）
• IDLE_STABLE_SEC = 15-24（5-6 次 3-4-秒 stable 才算 idle，防 cc 工具调用间隙误判）
• MAX_TURN_TIME = 15min（单个 turn 超时 → driver 介入 ping 一下「你还在吗」）
• BUSY_MARKERS_REGEX（vla3d 累计观察）：

Jitterbugging|Twisting|Blanching|Churned|Spawning|Editing|Reading|
Searching|Whirlpooling|Billowing|Crunched|Cooked|Sautéed|Baked|
Mulling|Doing|Harmonizing|Combobulating|Nebulizing|Brewed|Cogitated|
Befuddling|Frosting|esc to interrupt|✶|✻|Submit answers|\(.*[0-9]+s ·

最后那个 \(.*[0-9]+s · 是 fallback——cc 任何 spinner 都会显示 (<seconds>s · ...) 时间标记。这条匹配上了即视为 busy。

Output

driver 产物：

• <project>/.driver_brief.md — 任务 brief
• <project>/.driver_log.md —（可选）driver 每次 send-keys + capture 的 timestamp log

Failure modes

现象	处理
send-keys 后 sub-agent 无响应	再发一次 Enter；或 Escape + 重新 type
sub-agent UI 假 pending input	Escape 清，重 type
sub-agent 卡在 spinner > 15min	tmux send-keys C-c 中断，重新 brief
AskUserQuestion 弹了 nested 2 个 question	一个一个 Enter 答完，最后 submit
sub-agent 把 driver 当 user 反问	driver 答案要简洁，跟 brief 风格一致
pane 滚动出去看不到 history	capture-pane -S -<N> 拉更多行
sub-agent 调 /clear 把 brief 丢了	driver 立即 send-keys 重读 .driver_brief.md

Composition

• 跟 /sleep-research 互补：sleep-research = 自己 wrap 自己；remote-drive = 别人 wrap 你
• 跟 /spawn-task 区别：spawn-task = fork 一个 Agent sub-agent in-process；remote-drive = 跨 process / 跨 session 控制独立的 CC instance
• 跟 /cross-host-sync 联动：driver 调 cross-host-sync 知道 sub-agent 跑在哪台机器
• 跟 /sync-to-remote 联动：driver 自己跑 sync-to-remote 把代码送 hpcc 验证，结果以 /driver-findings 文件回喂 sub-agent
• 跟 /driver-findings 联动：远程发现的 bug 用 findings 文件格式标准化传回
• 跟 /meta-optimize 联动：driver-sub-agent 协作日志是 self-evolution 高质量数据

Example session

# driver 这边
tmux new-window -t research -n sub-cc -c /path/to/project
tmux send-keys -t research:sub-cc "claude" Enter
sleep 10  # 等 cc 启动

cat > /path/to/project/.driver_brief.md <<EOF
你是 sub-agent。任务：跑通 /research-pipeline Stage 1-4，STOP 在 Stage 5。
报告：每 stage 末 5-段格式。
第一步：cat RESEARCH_BRIEF.md，告诉我你计划的 skill 调用顺序。
EOF
tmux send-keys -t research:sub-cc "读 .driver_brief.md 按要求走" Enter

# 后台 watcher
nohup bash -c 'while ...; do ...; done' &

# loop: wait → capture → decide → send
while true; do
  wait_for_idle
  pane=$(tmux capture-pane -p -t research:sub-cc -S -300)
  if echo "$pane" | grep -q "Enter to select"; then
    tmux send-keys -t research:sub-cc Enter  # accept default
  elif echo "$pane" | grep -q "STOP"; then
    break
  else
    tmux send-keys -t research:sub-cc Escape
    tmux send-keys -t research:sub-cc "继续下一阶段" Enter
  fi
done

完整实战见 auto-production repo 的 vla3d test session（commit 10459f1）。