开发与工程

Worktree 管理技能

一条指令搞定 git worktree 的创建、列举与删除,为并行开发自动分配隔离的端口、数据库与配置。

59/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Claude Code
Star 数
★ 1.5k
最近更新
8 个月前
git-worktreeparallel-developmentbranch-managementslash-commands
+2port-isolationdeveloper-environment

这个 Skill 能做什么,适合哪些场景?

这是 disler/claude-code-hooks-multi-agent-observability 仓库中 .claude/skills/worktree-manager-skill 目录下的一个 Agent Skill,提供完整的 git worktree 生命周期管理。它将创建、列举、删除 worktree 封装为三个斜杠命令,自动处理端口唯一性、环境配置和操作校验,避免手工执行底层 git 命令。该技能明确依赖 Claude Code 的斜杠命令机制(frontmatter 中声明了 SlashCommand 工具),因此移植到其他 Agent 平台需要适配。适合在多个并行开发环境之间频繁切换、且已在用 Claude Code 的开发者。

该技能管理三类 worktree 操作:/create_worktree <branch-name> [port-offset] 创建新的并行开发环境;/list_worktrees 列出所有 worktree 及其状态;/remove_worktree <branch-name> 删除指定 worktree。创建时自动配置隔离的端口、数据库与配置文件,确保端口唯一;删除时自动清理。它通过 Bash、Read、Write、Edit、Glob、Grep 等工具执行,技能文档明确要求不要手工用 git 命令或直接删除目录,一切经由斜杠命令完成以获得校验和错误处理。

适合
  • 并行开发多个功能分支的开发者,需要为每个分支创建带独立端口和数据库的隔离环境
  • 同时调试多个分支 bug 的工程师,用 /list_worktrees 快速查看现有 worktree 及状态
  • 合并或废弃某个功能后,用 /remove_worktree 一条命令删除对应 worktree 并自动清理
  • 团队新成员想尝试多环境并行开发,但不想手动记 git worktree 的各种参数与端口配置
  • 需要临时搭起一个分支环境做验证或演示的人,想避免端口冲突和配置遗漏

如何安装这个 Skill?

开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • git

该技能属于 disler/claude-code-hooks-multi-agent-observability 仓库捆绑的 4 个技能之一。按照该仓库的通用做法,将仓库中的 .claude 目录复制到你的项目根目录:cp -R .claude /path/to/your/project/。worktree-manager-skill 即位于 .claude/skills/worktree-manager-skill/。仓库未单独说明该技能的最小化安装步骤,最简方式是只复制 skills 下对应子目录到项目的 .claude/skills/ 中(此精简做法未被源文档明确确认)。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/disler/claude-code-hooks-multi-agent-observability.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.claude/skills/worktree-manager-skill" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 为 feature-x 创建一个 worktree,端口偏移 1
  • 列出所有 worktree
  • 删除 feature-x 的 worktree

在 Claude Code 中用自然语言触发即可:说「为 feature-x 创建一个 worktree,端口偏移 1」会匹配到 /create_worktree feature-x 1;说「列出所有 worktree」匹配 /list_worktrees;说「删除 feature-x 的 worktree」匹配 /remove_worktree feature-x。技能文档还附带 OPERATIONS.md、EXAMPLES.md、TROUBLESHOOTING.md、REFERENCE.md 提供详细步骤与排错说明。注意不要在对话中要求直接手工执行 git worktree 命令,技能明确将此列为不适用场景。

这个 Skill 有哪些优点和局限?

优点
  • 将创建/列举/删除 worktree 全流程封装为三条命令,附带关键词决策树,触发意图清晰
  • 创建时自动处理端口唯一性、隔离端口/数据库/配置,删除时自动清理,减少人为遗漏
  • 自带操作手册、示例和故障排查文档(OPERATIONS/EXAMPLES/TROUBLESHOOTING/REFERENCE)
  • 明确划定了使用与不使用的边界,避免与手工 git 操作冲突
局限
  • 依赖 Claude Code 特有的斜杠命令与 SlashCommand 工具,其他 Agent 平台无法直接使用
  • 仓库整体许可证标注为 unknown,商用前需自行确认授权
  • 该技能只是仓库捆绑的 4 个技能之一,仓库 README 主要描述的是可观测性系统,技能本身的独立成熟度和测试情况未在源中说明
  • 文档未说明创建 worktree 时数据库/配置隔离的具体实现细节

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Worktree 管理技能 本页 59 · 推荐 ★ 1.5k 8 个月前 —
Git Worktree 并行环境创建技能 57 · 谨慎使用 ★ 1.5k 8 个月前 —
分支变更合并助手 ✓ Microsoft · 官方 49 · 谨慎使用 ★ 194k 11 天前 MIT
do — 功能开发编排器 47 · 谨慎使用 ★ 2.8k 5 个月前 AGPL-3.0
CODEOWNERS 分组拆分 PR ✓ NVIDIA · 官方 57 · 谨慎使用 ★ 3.6k 11 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-1.0
推荐
59/ 100 五分制 3.0 / 5
1价值适配11 / 20 · 2.8/5

git worktree 全生命周期管理(创建/删除/列出),明确排除了「用户想手动用 git 命令」等不该触发的场景。

2可靠性12 / 20 · 3.0/5
3安全性19 / 25 · 3.8/5
4证据5 / 15 · 1.7/5
5易用性7 / 10 · 3.5/5
6维护性5 / 10 · 2.5/5
1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月17日 评估证据[1]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。

查看完整评分方法 →

常见问题

它和直接敲 git worktree add 有什么区别?
区别在于自动化:技能会自动分配唯一端口、生成隔离的数据库与配置文件,并在删除时做完整清理;直接用 git 命令这些都要手工处理。技能文档明确建议不要绕过它手工执行 git worktree 操作。
必须在 Claude Code 里用吗?
是的。技能 frontmatter 声明了 SlashCommand 工具,且核心操作全部通过 /create_worktree 等 Claude Code 斜杠命令触发,没有提供独立脚本入口,移植到其他平台需要改造。
安装它是不是必须装整套可观测性系统?
源文档只给出了复制整个 .claude 目录的通用安装方式,并未说明该技能能否脱离仓库中的 hooks 和观测服务独立运行;如果只要这一个技能,复制 skills 子目录的做法合理但未被源明确确认。
端口偏移参数是必须的吗?
不是。命令语法为 /create_worktree <branch-name> [port-offset],端口偏移是可选参数;不指定时技能会自动保证端口唯一。

同仓库的其他 Skills

均来自 disler/claude-code-hooks-multi-agent-observability

相关 Skills