wm-git-worktree-manager

wm (Git Worktree Manager) 技能是一项强大的 CLI 工具，专为需要维护多个并发功能分支的开发者而设计。它通过自动化创建、管理和清理隔离的工作区，简化了 git worktree 的工作流程，有效解决了分支切换与暂存（stash）的繁琐问题。此工具适合在具有复杂 CI/CD 流程、长时间构建过程或需要同时处理多个合并请求（PR）的仓库中进行开发的软件工程师。

• 自动为特定分支创建隔离的 git worktree，让开发者能同时处理多项功能，无需频繁切换分支或存储工作状态。

• 支持智能文件同步，用户可在 .wm.yaml 定义规则，将 .env 等关键配置文件或项目特定配置复制或链接至新工作区。

• 触发自动化的安装后任务，例如执行 npm install、pnpm install 或自定义后台脚本，确保新工作区在创建后立即具备开发能力。

• 自动检测远程分支，当开始处理存在于远程但本地尚未拥有的功能分支时，能流畅地从远程拉取。

• 提供强大的 CLI 界面并支持明确参数，非常适合整合至自动化环境、CI/CD 管线以及脚本驱动的开发工作流中。

• 包含如主工作区保护等安全机制，防止意外删除关键项目根目录，并针对含斜线的分支名称提供标准化命名约定。

• 确保在项目根目录中配置 .wm.yaml 文件，以定义基本目录、文件同步模式及安装后任务命令，从而维持一致的开发环境。

• 在自动化脚本中运行时，请使用明确的命令参数（例如 wm add <branch>）而非交互模式，以避免处理程序挂起，因为交互模式需要终端机 TTY。

• 使用 wm list 指令以结构化且易读的格式查看所有活动中的工作区及其关联的 git 分支或 HEAD 状态。

• 管理复杂分支结构时，请注意包含斜线的分支名称（例如 feature/auth）会被自动转换为扁平目录名称（feature-auth），以确保路径安全性和操作系统兼容性。

• 在移除指令中使用 -b 参数，可同时删除 git worktree 目录与关联的 git 分支，简化功能完成或 PR 合并后的清理工作。