manage-worktree

此技能是专为管理 Rails-on-Services Apartment 项目中并行 git 工作树 (worktrees) 的开发者所设计。它通过自动化设置与清理兄弟存储库目录，简化了复杂的 git 操作，让您可以同时处理多个功能分支，而无需在单一目录中反复执行 stash 或切换分支。本工具旨在协助软件工程师，特别是那些处理多租户架构并需平行测试不同 schema 配置的开发者。通过此代理，您可以显著降低手动目录管理、分支追踪与环境配置的作业负担。

• 自动创建与主存储库目录并行的 git 工作树，确保路径解析正确。

• 执行项目特定的设置任务，例如调用 'bin/dev/setup-worktree' 来配置 .claude、.bundle、.vscode 及 Peacock 颜色设置。

• 无缝处理 stash 作业，确保在进入或离开工作树时保护未提交的代码变更。

• 具备模式检测功能，能自动判断用户的意图：创建新分支、移动既有分支或执行清理/删除任务。

• 验证开发者前缀（如 man/ 或特定功能标签），以维持存储库的命名规范。

• 使用内部项目脚本 'bin/dev/remove-worktree' 自动化删除分支与清理工作，确保不会遗留孤立的数据库或 schema。

• 此技能预期接收分支名称或意图指令（如 'remove'、'move' 或 'create'）。

• 它会使用 'git worktree list --porcelain' 动态解析工作树根路径，避免在既有工作树内执行时发生问题。

• 在尝试移动操作前，总是会进行既有分支的安全检查，以防止数据丢失。

• 当您需要快速切换上下文、测试不同的租户策略，或为 Apartment 基础的 Rails 应用程序管理独立开发环境时，请使用此工具。

• 请注意，此技能需要访问 bash 基础的 git 命令以及存储库结构中定义的项目 bin 脚本。