SuperAPI AI 工具集

git-worktree-workflow

编程与开发

查看项目

更新于 10-15 17:25

技能介绍

用途:在单个 Claude 会话中管理 git worktree,实现分支隔离。worktree 允许在独立目录中处理功能分支,同时保持主仓库不被改动。

目录结构:主仓库目录(Claude 在此运行)与 worktree 目录并列,worktree 中的 .claude 通过符号链接指向主仓库的 .claude。

主要能力与用法: 创建 worktree:git worktree add ../WorktreeName -b branch-name,并符号链接 Claude 设置:ln -s ../CurrentRepoDir/.claude ../WorktreeName/.claude。 列出:git worktree list。 移除:git worktree remove ../WorktreeName,再 git branch -d branch-name 删除本地分支。

工作流分四阶段:创建 worktree 并验证;在 worktree 中编辑文件、提交并推送分支;用 gh pr create --base main --head feature/my-feature 创建 PR 并返回 URL 等待批准;合并后回到主仓库、git pull origin main、移除 worktree 并删除本地分支,最后用 git worktree list 验证清理。

准则:符号链接 .claude/ 目录而非复制;符号链接使用相对路径;合并后清理 worktree 与分支;从主仓库使用完整路径在 worktree 中工作;清理前先回到主仓库。不要复制 .claude/、不要用绝对路径做符号链接、不要合并后遗留 worktree、不要在推送前删除 worktree。

错误处理:worktree 已存在时先 git worktree list 检查,必要时 git worktree remove ../WorktreeName --force;分支已存在时改用 git worktree add ../WorktreeName existing-branch;有未合并改动时强制移除会丢失未提交内容。

安装:符号链接辅助脚本(不要复制):ln -s /path/to/skills/development/git-worktree-workflow/scripts/worktree.sh .claude/scripts/worktree.sh。

限制:资料未提供平台、收费、价格或效果等信息。