using-git-worktrees

using-git-worktrees 技能为软件开发代理程序提供了一套系统化的框架，用于管理并行分支，避免频繁切换上下文造成的性能损耗。通过利用 git worktrees，代理程序可以建立共享同一底层仓库的隔离工作空间，从而实现同步的实现、测试与调试。此技能专为需要干净、隔离环境来进行功能开发或错误修正的工程工作流程所设计。

• 自动化的目录选择优先考虑 .worktrees 等隐藏文件夹或专属的全局设定路径，以确保工作空间组织的一致性。

• 强制性的安全验证使用 git check-ignore 来确保工作空间目录不会与仓库追踪冲突，防止意外的源代码污染。

• 智慧化的项目设定功能可检测 package.json、Cargo.toml、requirements.txt 或 go.mod 等文件标记，以自动触发如 npm install、cargo build 或 pip install 等安装指令。

• 基准测试整合机制要求在工作空间正式启用前，必须先执行项目特定的测试套件，确保开发环境在已知的稳定状态下启动。

• 严格遵守项目惯例与现有文档 (CLAUDE.md)，防止代理程序做出未经授权的目录选择。

• 执行前请务必宣布意图：“我正在使用 using-git-worktrees 技能来建立隔离的工作空间。”

• 若针对项目本地的 worktrees 侦测到未被忽略的目录，技能强制要求立即采取补救措施，将该路径加入 .gitignore 并提交变更后才可继续。

• 当遇到基准测试失败时，代理程序必须报告具体错误并请求人类介入，而不是贸然进入不稳定的开发环境。

• 极适合用于涉及多重功能开发、复杂分支管理或子代理程序驱动开发 (subagent-driven-development) 的使用场景，因为这些场景中快速的上下文切换容易导致设定错误。

• 此技能作为实现任务的先决条件，确保在任何新逻辑注入仓库之前，所有依赖项皆已就绪且代码基准皆可验证。