用途:这是一套协调型智能体技能,用于以 workmux CLI 编排多个在各自 git worktree/分支中运行的 Claude Code 会话(称 worktree agent)。协调者只负责派发、监控、通信与合并,不直接写代码或改源文件。
主要能力:一是派发智能体,先写提示文件再并行启动,命令形如 workmux add <handle> -b -P <file>,支持 -p 内联提示、--name、-c/--continue 恢复、--base、--parent-session 等。二是监控,workmux status 查看状态,状态分 working、waiting、done。三是等待,workmux wait 可指定多个句柄、--timeout 秒数、--any 首个完成即返回,以及 --status working 确认启动;退出码 0 达标、1 超时、2 未找到 worktree、3 智能体异常退出。四是抓取输出,workmux capture <handle> -n 50 读取尾部行。五是发送指令,workmux send 支持文本、技能命令(如 /commit、/merge)和 -f 文件。六是运行命令,workmux run 在面板中执行并回传输出与退出码,支持 -b、--timeout、--keep。七是合并与清理:让智能体自行 /merge,或 workmux remove 移除。
跨项目:send、capture、status、wait、run 可全局解析句柄,跨项目用 project:handle 消歧;add、open、merge、remove、close 仍限于当前仓库。
使用要点:先写完全部提示文件再启动全部智能体;提示需自包含且用相对路径;用 -b 后台运行;启动后用 wait --status working 确认;多智能体时用 --any 等待,完成后用 status 识别、capture 审阅,再逐个 /merge,避免冲突;中断不解除监控责任,需持续跟踪未处理的句柄并恢复等待。
适用场景:需要并行开发多个独立任务、评审合并分支的团队式编排流程。
限制:依赖 workmux CLI 与 tmux 环境;智能体看不到协调者对话;提示文件必须自包含;合并需逐个进行;其余如价格、平台、许可等暂未提供。