SuperAPI AI 工具集

branch

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:解决同一工作目录中多个 Claude Code 会话并行时的冲突——git checkout 会切换所有人的 HEAD,未提交改动会跨检出泄漏,索引也会互相干扰。worktree 让每个会话拥有独立工作文件、HEAD 和索引,同时共享 .git,开销约等于零。

主要能力:支持创建、列出、结束工作树,以及心跳更新与跨会话协调。创建模式会用 git worktree add 建出新工作树,按项目约定放置路径,并在共享日志中写入条目。日志位于 ~/.claude/coordination/<repo>/journal.md,在受控目录之外、所有工作树共享、不会提交。支持 .claude/worktree-base 路径模板与 .claude/worktree-setup.sh 初始化钩子(如软链被忽略的密钥文件、安装依赖)。

使用方式:命令形式包括 /branch <task-slug> [--from <base-branch>] [--description "..."] [--reuse]、/branch list、/branch done <task-slug> [--force]、/branch update 以及 /branch coord <message>、/branch coord clear <slug>。基础命令为 git worktree add "$WORKTREE_PATH" -b "$SLUG" "$BASE_BRANCH"。update 可设置 working-on、state(building/in-review/blocked/almost-done/stale)、next、blocked-by、asks、dont-touch 等字段。

适用场景:需要并行跑多个 agent 会话、又希望共用同一仓库的团队或个人。

限制与注意:slug 需匹配 ^[a-z][a-z0-9-]*$;已有同名分支或工作树时拒绝创建,除非使用 --reuse;工作树不会带上被 gitignore 的文件,缺少 .dev.vars、.env、node_modules 时无法构建或测试;有未提交改动时删除需 --force;分支删除等破坏性操作不会自动执行;非 git 仓库内不可用。其他细节暂未提供。