large-task-orchestrator

大型任务 driver

这是流程类 Skill，仅在用户显式调用 $large-task-orchestrator 时运行。它只接管已经通过 large-task-planning v2 校验的计划：脚本是控制面，Worker、Validator 和异常时的 Judge 都是经 bb-dispatch 创建的 BB 线程。Worker 和 Validator 按轮次独立；每张 Story 的 Judge 使用一个独立会话， 后续裁决在同一会话续聊。

开始前加载 $large-task-planning 与 $bb-model-routing。使用宿主返回的两个 Skill 根目录分别定位 scripts/epic_story.py 和 scripts/bb-dispatch，不要假设它们与本 Skill 相邻。需要理解整体职责时，按 $large-task-planning 的指引读取它拥有的联合设计。计划 JSON 与 Git 是权威状态；每个 (仓库, 计划) 的 .local/large-task-orchestrator/<topic-slug>/ 保存可回看的运行事实。

生命周期用法

1. 先确定用户指定的计划；未指定时只能使用当前仓库唯一的计划。阅读仓库规则、SPEC.md、STATUS.md，检查 分支、git status --short 和 git worktree list，保留并发改动。然后只对这个 (仓库, 计划) 查询状态：

python3 <orchestrator-skill>/scripts/large_task_driver.py status \
  --plan <topic>/agent/plan.json --stories-dir <topic>/agent/stories \
  --planning-script <large-task-planning-skill>/scripts/epic_story.py \
  --dispatch <bb-model-routing-skill>/scripts/bb-dispatch

1. 若 status 显示 driver 仍在运行，把 completed/total、每张 in-progress Story 的阶段、线程 ID 和难度翻译给 用户；不要自己运行主循环，也不要读线程全文。若 last_stop 非空或有 blocked Story，说明事实，并只向用户索取 继续所需的最小决定。需要停止时使用 stop [--wait]；它只在当前 run_once 结束后退出，不会中断 BB 线程。

2. 若没有运行中的 driver，用 start 启动指定计划。start 自己会先执行计划校验和 bb-dispatch --dry-run， 然后在新 session 中派生后台 run；本轮到此结束，向用户报告 pid、日志路径和后续状态命令。不要在本轮改用 前台 run 等待结果。

python3 <orchestrator-skill>/scripts/large_task_driver.py start \
  --plan <topic>/agent/plan.json \
  --stories-dir <topic>/agent/stories \
  --repository <repo-root> \
  --planning-script <large-task-planning-skill>/scripts/epic_story.py \
  --dispatch <bb-model-routing-skill>/scripts/bb-dispatch \
  --environment <bb-environment-id>

同一计划已有存活 pid 时 start 以退出码 4 拒绝重复启动；陈旧 pid 自动覆盖。不同仓库或同一仓库不同计划使用 独立的状态目录与锁，可以同时运行。计划中的 owner 保留 Worker 线程 ID；遗失计划本地状态时，driver 会从计划 和 BB 线程恢复。driver 因需要用户处理（退出码 3）、受控停止或全部完成而退出时，会向启动它的 BB 线程发一条 简短消息（结论、需要用户决定什么、status 命令）；线程 ID 取 --notify-thread 或环境变量 BB_THREAD_ID，都没有则静默跳过。仅在排障或定时任务需要前台单次推进时才用 run 或 start --foreground 加 --once。