ia-git-worktree
管理Git工作树实现隔离并行开发
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:ia-git-worktree。 它的用途是:管理Git工作树实现隔离并行开发 完整的 Skill 内容见:https://321skill.com/skills/ia-git-worktree/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'为修复线上bug创建一个worktree,基于hotfix/issue-123分支',它会自动执行git worktree add命令,在指定路径创建独立工作目录并切换到该分支,同时显示当前worktree列表。再比如:'切换到我之前创建的feature/logging worktree',它会自动cd到对应目录并加载环境。
介绍
在多人协作或并行开发多个特性时,频繁切换分支会导致工作区污染、构建缓存失效、代码冲突等问题。ia-git-worktree 帮助你在同一仓库下创建多个独立的工作目录(worktree),每个 worktree 对应一个分支,彼此隔离,互不干扰。你可以同时在不同分支上开发、审查代码或运行测试,无需来回切换或暂存未完成的工作。
使用方式非常简单:通过自然语言指令即可创建、列出、切换或清理 worktree。例如,当你需要为一个新功能创建独立开发环境时,AI 会自动在指定路径下创建 worktree 并切换到相应分支;当需要切换任务时,AI 会引导你进入已有 worktree 工作目录;当功能合并后,AI 会帮你清理无用的 worktree 释放磁盘空间。
这个 Skill 适合所有需要频繁并行处理多个分支的开发者,尤其是后端开发、全栈开发以及需要同时进行代码审查和特性开发的团队成员。它也适用于运维工程师在管理多个修复分支或实验性分支时保持工作区整洁。
建议与 Git 分支管理策略结合使用,例如在 feature 分支开发完成后,及时通过该 Skill 清理对应 worktree 以避免磁盘占用膨胀。注意 worktree 不可用于同一分支的多个实例,若需在同一分支上并行工作,请考虑使用克隆或子模块。
核心特点
与普通 Git 分支操作不同,ia-git-worktree 提供的是完整的工作目录生命周期管理——创建、切换、清理一步到位,无需手动执行 git worktree add/remove 等底层命令,并自动处理分支关联与路径规划。
注意事项
不适合需要频繁合并同一分支多个并行修改的场景(同一分支只能有一个 worktree),也不适合非 Git 项目或需要复杂分支网络拓扑的操作。
常见问题
如何创建一个新的 worktree?
对 AI 说:'创建一个 worktree 用于开发登录功能,基于 feature/login 分支',AI 会自动执行 git worktree add 并切换到该目录。
如何切换到已有的 worktree?
说:'切换到 feature/login 的 worktree 工作目录',AI 会切换到对应路径并加载分支上下文。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/ia-git-worktree/raw/index.md 读取 ia-git-worktree 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/ia-git-worktree/raw/index.md(查看排版版本)