该技能用于协调多个智能体进行并行开发、顺序交接与提交归属转移。核心思路是让多个虚拟分支同时保持应用状态,共享单一工作区,从而省去目录协调、分支切换与后置冲突发现。
主要能力包括:并行功能开发(每个智能体创建自己的分支并提交,互不冲突)、顺序交接(后一智能体接管前一智能体的提交并继续改进)、跨智能体提交转移(用 but rub 在分支间瞬时转移提交归属)。推荐分支命名格式为 <agent-name>-<task-type>-<brief-description>,以便在 but status 和 but log 中辨别归属。
必要用法:使用 but branch new 创建分支,but rub 将文件或提交分配到分支,but commit 提交。关键约束是不要使用 git commit,否则会破坏 GitButler 状态。AI 集成方式包括 Claude Code 的 Agents Tab、生命周期钩子(but claude pre-tool / post-tool / stop)以及 MCP 服务器(but mcp)。
协作协议包括状态广播、风险操作前快照(but snapshot)和撤销(but undo),并需尊重锁定文件。but rub 可执行分配、移动、压缩与修正四类操作。其他限制:暂未提供 PR 提交 CLI,重叠文件编辑只能归属一个分支,也无堆栈导航 CLI;该技能更适合探索性多智能体工作。