SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:该技能围绕 Git worktree 与 tmux 集成,帮助创建隔离的开发工作区、在当前 tmux 会话中打开窗口并派发任务,适合并行功能开发、多任务隔离执行等场景。

主要能力:创建 worktree(git worktree add .claude/worktrees/{name} -b {branch});在当前 tmux 会话新建以 {session}-{name} 命名的窗口并进入 worktree 目录;通过 send-keys 派发命令(如 claude '任务'、claude '/bmad-create-story story 1-3'、make test);清理时移除 worktree、关闭 tmux 窗口并可选删除分支;支持列出 worktree、并行化分析与分支合并(需参考 references/bmad-orchestration.md)。

使用方式:创建前先确认 .claude/worktrees/ 已被 git 忽略(git check-ignore .claude/worktrees/test),否则追加到 .gitignore 并提交。随后执行 git worktree add,再用 tmux new-window -t "$SESSION" -n "$WINDOW_NAME" -c "$WORKTREE_PATH" 建窗,必要时用 tmux send-keys 派发任务。清理流程为 tmux kill-window、git worktree remove、git branch -d、git worktree prune。

限制与注意:.claude/worktrees/ 需显式忽略,否则父仓库会将其视为未跟踪文件;tmux 会话名过长可能触发文件名长度限制;跨 worktree 并发 git status 可能因 index.lock 失败;BMAD 并行工作假设文件不重叠;--dangerously-skip-permissions 仅在用户明确要求时使用。命名约定与分支规范依项目而定,可查 CLAUDE.md。