ia-git-worktree
一键管理Git工作树,隔离并行开发
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:ia-git-worktree。 它的用途是:一键管理Git工作树,隔离并行开发 完整的 Skill 内容见:https://321skill.com/skills/ia-git-worktree-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我需要同时review PR #42和开发新功能,请为这两个任务各创建一个工作树,分别绑定到feature/review-42和feature/new-feature分支。’ 它会自动执行git worktree add命令创建两个独立工作目录,并在完成后提示你切换时使用‘cd’命令进入对应目录。
介绍
在并行开发多个功能或修复多个Bug时,传统做法是频繁切换分支或复制多个仓库目录,容易导致工作区混乱、编译环境冲突、代码丢失等问题。ia-git-worktree 是一个基于Git worktree机制的AI Skill,让你在同一个仓库中创建多个独立的工作目录,每个工作目录对应不同的分支,互不干扰,实现真正的并行开发。
使用时,只需通过自然语言指令告诉AI你的需求,例如“创建一个新工作树用于review feature-x分支”或“列出所有工作树并清理已合并的分支”。AI会自动执行git worktree add、list、prune等命令,无需你记忆复杂参数。同时支持切换到指定工作树、删除过期工作树等常见操作,打通整个工作流。
适合Git日常使用频繁的开发者,尤其是需要同时处理多个代码审查、紧急修复、功能开发的后端、全栈工程师,以及运维工程师在多分支部署场景下使用。对于团队协作中需要隔离不同任务进度的场景,此Skill能显著减少环境切换开销。
建议在项目根目录下使用,确保Git版本不低于2.5(worktree功能的最低版本)。注意:工作树之间共享仓库对象,但文件系统独立,因此不要在同一个工作树内执行git reset等危险操作影响其他工作树。使用前最好先通过‘list’命令确认当前工作树状态,避免重复创建。
核心特点
不同于普通的分支管理工具,ia-git-worktree 原生利用Git worktree机制创建独立工作目录,而不是依赖stash或临时分支,因此能完全隔离构建产物和依赖,避免切换分支时引起编译冲突或重新安装依赖。
注意事项
不适合需要频繁在多个分支间快速切换且对工作目录隔离无要求的场景,因为每次创建或删除工作树会占用额外的磁盘空间。
常见问题
git worktree和git branch有什么区别?
git branch只是创建指针,工作区不变;git worktree会创建独立的工作目录,每个目录对应一个分支,可以同时并行开发而不互相影响。
如何删除一个工作树?
使用git worktree remove <worktree-name>命令,或者直接对AI说‘删除名为xxx的工作树’。注意:删除前确保该工作树没有未提交的更改。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/ia-git-worktree-x/raw/index.md 读取 ia-git-worktree 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/ia-git-worktree-x/raw/index.md(查看排版版本)