mcpField
P
parallel-worktrees

parallel-worktrees

github.com/rohitg00开发2.9k164 次安装4 周前更新
代码仓库

关于 parallel-worktrees

parallel-worktrees 是一项指导使用 Git worktree 并行开展开发工作的技能，适用于测试、构建或 CI 等待期间。它说明如何创建隔离工作副本，并在完成后清理。

主要功能

  1. 01创建隔离的 Git 工作副本
  2. 02在独立会话中并行处理任务
  3. 03列出、移除和清理 worktree
  4. 04提供 Claude Code 专用用法

适用场景

  1. 01测试运行时开始开发另一项功能
  2. 02同时进行代码审查与新功能开发
  3. 03并行比较多种实现方案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rohitg00/pro-workflow --skill parallel-worktrees

安装后在 Claude Code 中输入/parallel-worktrees确认已加载。

详细介绍

并行工作树

不浪费时间。一个会话运行测试时，你可以处理其他事情。

触发条件

等待测试或长时间构建、探索不同方案，或需要同时进行审查和开发时使用。

快速入门

Claude Code：

claude --worktree    # or claude -w (auto-creates isolated worktree)

Cursor / Any editor：

git worktree add ../project-feat feature-branch
# Open the new worktree folder in a second editor window

这两种方法都会创建一个隔离的工作副本，其中的更改不会影响主会话。

Claude Code 的额外功能

这些功能仅适用于 Claude Code（使用 Cursor 时可跳过）：

  • claude -w 会自动创建并清理工作树
  • 子 Agent 支持在 Agent 的 frontmatter 中设置 isolation: worktree
  • Ctrl+F 会终止所有后台 Agent（需按两次确认）
  • Ctrl+B 会将任务发送到后台

工作流

  1. 显示当前工作树：git worktree list
  2. 为并行任务创建一个工作树。
  3. 在该工作树中打开新的编辑器或终端会话。
  4. 完成后，清理工作树。

命令

git worktree list

git worktree add ../project-feat feature-branch
git worktree add ../project-fix bugfix-branch
git worktree add ../project-exp -b experiment

git worktree remove ../project-feat
git worktree prune

使用模式

Terminal 1: ~/project          → Main work
Terminal 2: ~/project-feat     → Feature development
Terminal 3: ~/project-fix      → Bug fixes

每个工作树都独立运行自己的 AI 会话。

适合并行处理的场景

场景操作
测试运行中（2 分钟以上）在工作树中开始开发新功能
长时间构建并行调试问题
探索不同方案同时比较 2-3 种方案
审查 + 新任务在一个工作树中审查，在另一个工作树中开发
等待 CI在工作树中开始下一个任务

注意事项

  • 每个工作树都是一个完整的工作副本，更改彼此隔离。
  • 删除工作树前，请确认更改已提交：git -C ../project-feat status
  • 完成后别忘了清理工作树（git worktree prune）。
  • 避免在多个工作树中同时编辑相同的文件。

输出

  • 当前工作树列表
  • 已创建工作树的路径和分支
  • 打开新会话的说明

评论

支持 Markdown