Skill 说明
coordinator 是什么
coordinator 是一套给 Claude Code 用的技能,配合 Herdr 终端应用把「一个会话」升级成「任务调度员」。你给它一个领域(某个仓库或产品线),之后陆续丢请求;它为每个任务写 brief、在独立 Git worktree 和独立标签页里拉起代理会话,监视进度、把问题汇总给你,任务落地后再清理。
调度员自己维护一份 Markdown backlog:范围、已批准事项、进行中与已完成。代理会话结束会写 REPORT.md;后台 fleet_watch.py 在代理结束、卡住或 PR 合并/失败时叫醒调度员。默认最多三路并行,还能限制仓库里未合并 PR 数量。
| 角色 | 做什么 | 状态落在哪 |
|---|---|---|
| Coordinator | 收需求、写 brief、决策小事项、批量提问 | 领域 backlog Markdown |
| Delegate | 独立 worktree 执行,写 REPORT.md | Herdr 标签页 + worktree |
| Watcher | 盯结束/提问/卡住/PR 状态 | fleet_watch.py 后台 |
| fleet-sweep | 清 worktree、分支、标签页与残留进程 | 第二套技能,拒绝丢数据操作 |
依赖:herdr-core、Herdr app、Claude Code、Python 3.9+、git;有 GitHub 仓库时建议登录 gh。可选 Codex 做机械性代理任务。
coordinator 怎么安装
先装 Herdr 核心:
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
再从 https://herdr.dev 下载 Herdr 桌面应用。然后在 Claude Code 里粘贴官方安装指引:
Set up the coordinator workflow by following https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md
也可按仓库 SETUP.md 手动安装两套技能与 Python 脚本。作者在 macOS 上验证过 herdr-core 0.1.21、Herdr app 0.1.15、Claude Code 2.1.325。
coordinator 怎么使用
- 启动调度会话:
/coordinator <domain or project>,它会认领一个领域并维护 backlog。 - 把任务丢给它;它为每个任务开代理会话(独立 worktree + Herdr 标签),最多三路并行。
- 代理卡住或需要决策时,问题会批量(最多 5 条)汇总给你,并带选项与推荐。
- 任务完成后看
REPORT.md;用 fleet-sweep 清理 worktree、分支与标签页。
coordinator 适合谁用
- 一个人要并行推进多个 Claude Code 任务、又不想自己当调度员的开发者。
- 已经用 Herdr 管理多终端代理会话的人。
- 需要 backlog 可重启恢复、且要限制并行度与 PR 堆积的小团队。
- 不适合没有 Herdr / Claude Code,或只跑单会话短任务的场景。
coordinator 项目地址
- GitHub 仓库:https://github.com/petekp/coordinator
- 安装指引:https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md
- Herdr:https://herdr.dev