这个 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?
- 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/ 中(此精简做法未被源文档明确确认)。
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?
git worktree 全生命周期管理(创建/删除/列出),明确排除了「用户想手动用 git 命令」等不该触发的场景。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。
查看完整评分方法 →