Git Worktrees

Goal

为并行任务提供可定位、可验证、所有者清晰的 Git 工作区。完成时应说明 worktree 的绝对路径、分支或 detached 状态、管理者、基准提交、验证结果，以及仍需人工处理的改动或清理条件。

Directory policy

统一根目录是 ~/.agents/worktrees。本 skill 创建的路径使用 <forge>/<owner>/<repo>/<task>；优先从规范化后的远端 URL 得到 forge/owner/repo，没有远端时使用 local/<repo>-<common-dir-short-hash>。task 使用短而稳定的任务或分支 slug；斜杠等路径分隔符改为连字符。目标路径必须解析到统一根目录内，且不得覆盖现有路径。

Codex 等平台托管的 worktree 也可以使用这个根目录，不再按 app 划分子目录。管理权不能只靠路径判断：先结合当前平台能力、Git worktree 元数据和任务上下文识别所有者。平台托管 worktree 由平台负责快照和自动清理，skill 不手工移动、删除或 prune；原生 Git 创建的 worktree 则没有平台快照或自动清理保证。需要统一 Codex 路径时，通过 Codex 的 Settings > Worktrees > Worktree root 指向 ~/.agents/worktrees。

这个目录是本机运行状态，不是配置事实源。不要把它纳入 Git、云盘或跨机器同步；每台机器独立创建。Git 自身的 git worktree list --porcelain 是单个仓库的权威状态，不另建全局 registry。

Discover the local interface

先确认本机 Git 版本，并从当前版本发现与目标相关的语法：