ClaudeMap

Coordinator

一对把单个会话变成管理者的 Claude Code skill:写任务简报、在各自 worktree 与 Herdr 标签页里启动 delegate 会话、盯进度、落地后清理

插件与代理orchestrationmulti-agentworktreeherdrpython

Coordinator 是一个更高层的 Claude Code agentic 工作流,由驱动 Herdr 终端应用的 Python 脚本承载。用 /coordinator <domain> 启动一个协调者会话;它负责一个域(一个仓库或产品面),状态保存在 Markdown backlog 文件里——这个域覆盖什么、你已永久批准什么、什么还开着、什么已完成——重启后靠它恢复。每个进来的请求被写成一份简报,协调者为它启动独立的 delegate 会话,各有自己的 Git worktree 与 Herdr 标签页;delegate 停下时写 REPORT.md。后台看护 fleet_watch.py 在 delegate 完成、提问或卡住时唤醒协调者,PR 合并、检查失败、收到评审时也会唤醒。上限检查让同时工作的 delegate 至多三个,并可把你每个仓库的开放 PR 压在你设的上限内;安静一天的 delegate 会被结束、之后用同一会话恢复。第二个 skill fleet-sweep 清理完成的 worktree、分支、标签页与游离进程,但拒绝任何会丢工作的操作。协调者自行决定小的可逆事项并说明选择,向你提问时一次至多五条、各带选项与推荐。依赖:herdr-core、Herdr 应用、Claude Code、Python 3.9+(仅标准库)、git、已登录的 gh;可选让 Codex 接小的机械任务,petekp/inbox mod 可把问题收进一个面板。已在 macOS 上对 herdr-core 0.1.21、Herdr 0.1.15、Claude Code 2.1.325、Codex 0.164.0 测试。

它做什么

  • 每个域一个协调者:/coordinator <domain> 维护一份 Markdown backlog(范围、批准、开放、完成),重启可恢复;delegate 拿到写明「怎样算完成、在哪里停」的逐任务简报
  • 舰队机制:delegate 各自的 Git worktree 与 Herdr 标签页运行,停止时写 REPORT.md;fleet_watch.py 在完成、提问、卡住、PR 合并、检查失败或收到评审时唤醒协调者
  • 护栏:上限检查同时至多三个 delegate,并可按仓库设开放 PR 上限;安静一天的 delegate 被结束、之后同会话恢复;fleet-sweep 拒绝任何会丢工作的操作
  • 升级纪律:小的可逆决定自行做出并报告;向你提问一次至多五条、各带选项与推荐
  • 脚本面:delegate_start/cap/end、fleet_watch/status、backlog_check、coordinator_restart、watcher_check 与 sweep.py,均有 --help;仅用 Python 3.9+ 标准库

什么时候用

适合让一个长期会话负责一个仓库或产品面、把工作扇出到可在同一应用里盯着看的并行 delegate——多任务并流、长杂务、分阶段重构。不想引入 Herdr 应用就别用:delegate 以 Herdr 标签页打开,应用是必需品。

如何上手

让 agent 代装——把下面这段贴进 Claude Code:

Set up the coordinator workflow by following https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md

或手动安装:

git clone https://github.com/petekp/coordinator.git ~/src/coordinator
~/src/coordinator/install.sh

install.sh 把两个 skill 链接进 ~/.claude/skills 与 ~/.agents/skills,随后检查上列工具;克隆目录请保持在原位,链接指向它。更新用 git pull(看护每天检查、绝不自行拉取)。卸载:~/src/coordinator/install.sh --remove,然后删掉克隆目录。

herdr-core:curl -fsSL https://releases.herdr.dev/core/install.sh | sh(Herdr 应用从 herdr.dev 下载)

注意事项

delegate 跑在你当前的 Claude Code 权限档下:默认档里每个 delegate 会在权限提示与每个新 worktree 的目录信任提示处停下,直到你在它的标签页里应答。删除 worktree 时其忽略文件(如 .env 与 .scratch/)会被移进 <主 checkout>/.scratch/parked/——没有任何机制自动清理 parked 目录。Codex delegate 只在你在 Codex 标记为可信的仓库里启动,且 Codex 不能取代 Claude Code 担任协调者。非 POSIX 登录 shell(fish)会让 delegate 经 /bin/sh 启动,需要 PATH 上有 hc、claude 与 python3。已在 macOS 测试(herdr-core 0.1.21、Herdr 0.1.15、Claude Code 2.1.325、Codex 0.164.0)。MIT 许可。撰稿时 47 星(2026-11-21)。

代码仓库

petekp/coordinator

收录日期

地图上的相关资源

  • clawd-conduit

    插件 / 代理

    把全部 15 个 Claude Code hook 事件接进 Clawd on Desk 桌面宠物,权限请求变成可等待的桌面卡片。

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md