| name | drive |
| description | Use when the user wants a detached worker (Codex or Claude) to execute an arbitrary user-specified task and keep going automatically when the worker merely asks whether to continue. |
驱动 Detached Worker
这是独立于 workflow 的 drive 入口。用户明确说“开一个 detached worker 去做这个任务”“持续驱动 worker 干活”“别让它每做一点就回来问我是否继续”,或直接说 /cc-leader-drive 时,用这个 skill。
worker 默认 codex; 可用 --worker claude 切 Claude Code CLI。
语义
drive 不负责 workflow phase / gate / spec
drive 只做一件事:按用户给的任务启动 detached worker
- 如果 worker 只是停下来问“是否继续”,就自动用 continue prompt 去
resume
- 监控只关心 4 类里程碑:
- PR merge
- CI 失败
- 需要用户介入
- drive 结束
- 非里程碑进展不通知用户,静默运行
执行方式
- 把用户当前这次明确给出的任务,原样作为 drive prompt 主体
- (可选) 问用户 worker / 模型:
--worker codex|claude、--model <model>、--effort <e> (effort 仅 claude)、--max-auto-continue <n> (自动 continue 上限, 防无限回环)
- 用背景模式执行:
cc-leader drive [--worker <w>] [--model <m>] [--effort <e>] [--max-auto-continue <n>] "<user task>"
- 这个命令静默等待,直到出现一个里程碑。背景模式不内联返回 JSON: 返回 task id + 输出文件路径; 收到
<task-notification> 后 Read 输出文件取 JSON
- 解析 JSON,至少读取:
drive_id
active
stop_reason
milestone.type
milestone.summary
auto_continue_count
thread_id
stdout_log
stderr_log
- 里程碑处理:
milestone.type == "pr_merged":通知用户 PR 已合并;如果 active == true,马上再次后台执行 cc-leader drive 挂下一个里程碑,不要问用户
milestone.type == "ci_failed":通知用户 CI 失败;如果 worker 仍在继续修,active == true 时再次后台执行 cc-leader drive
milestone.type == "needs_user":这才把控制权交回用户,展示 milestone.summary
milestone.type == "drive_finished":通知用户 drive 已结束
- 回环兜底: 自动 continue / 自动 re-dispatch 靠里程碑驱动, 无里程碑时不应无限自转。检查
auto_continue_count: 若持续增长但无 pr_merged / ci_failed 等实质进展, 视为疑似卡死, 停下问用户; --max-auto-continue <n> 是硬上限
接管已有 drive
如果上次 drive 启动后,cc 自己断线、报错、额度耗尽:
cc-leader drive
不带 prompt 时,表示接管当前 active drive;如果 active 已结束,也会回退读取最近一次 drive 的未通知里程碑。
如果当前 active drive 还在跑,cc-leader drive 会继续静默等下一个里程碑,而不是重复发新任务。
何时不用
- 需要 phase / review gate / 最终报告时,不用
drive,用 /cc-leader-run
- 需要先写 spec 时,不用
drive,用 /cc-leader-spec