Worktree 管理技能
一条指令搞定 git worktree 的创建、列举与删除，为并行开发自动分配隔离的端口、数据库与配置。
git worktree 全生命周期管理（创建/删除/列出），明确排除了「用户想手动用 git 命令」等不该触发的场景。
这个 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 有哪些优点和局限？
- 将创建/列举/删除 worktree 全流程封装为三条命令，附带关键词决策树，触发意图清晰
- 创建时自动处理端口唯一性、隔离端口/数据库/配置，删除时自动清理，减少人为遗漏
- 自带操作手册、示例和故障排查文档（OPERATIONS/EXAMPLES/TROUBLESHOOTING/REFERENCE）
- 明确划定了使用与不使用的边界，避免与手工 git 操作冲突
- 依赖 Claude Code 特有的斜杠命令与 SlashCommand 工具，其他 Agent 平台无法直接使用
- 仓库整体许可证标注为 unknown，商用前需自行确认授权
- 该技能只是仓库捆绑的 4 个技能之一，仓库 README 主要描述的是可观测性系统，技能本身的独立成熟度和测试情况未在源中说明
- 文档未说明创建 worktree 时数据库/配置隔离的具体实现细节
如何安装这个 Skill？
该技能属于 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/ 中（此精简做法未被源文档明确确认）。
如何使用这个 Skill？
在 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 命令，技能明确将此列为不适用场景。