用途:规范在 .agents/worktree/<name> 下使用 Git worktree 进行实现类工作,包括何时创建、如何创建、并行隔离与合并后清理。是否必须使用 worktree 的策略由 rules/git-workflow.md 定义,本技能不重复。
主要能力:一次性配置(向 .gitignore 追加 .agents/worktree/,在 .vscode/settings.json 设置 git.repositoryScanMaxDepth 与 git.detectWorktrees,确认 UV_PROJECT_ENVIRONMENT 指向共享 .venv);创建 worktree(git fetch origin 后以 origin 默认分支为起点,git worktree add ".agents/worktree/$NAME" -b "$BRANCH" "origin/$DEFAULT",名称由分支名 / 替换为 -);hook 创建的 detached HEAD 用 git switch -c "$BRANCH" 建分支;submodule 仅 source 初始化;并行 worker 各自独立 worktree 与分支;PR 交接用 git push -u origin "$BRANCH" 与 gh pr create --fill --base "$DEFAULT";合并后清理用 git worktree remove、git branch -d、git fetch --prune、git worktree prune。
使用方式:Claude Code 的 --worktree 或 isolation 启动时由 WorktreeCreate hook 代建,从创建后步骤开始;删除由 WorktreeRemove hook 代行,但含未提交变更、lock、已初始化 submodule、无分支可达 commit 或非缓存 ignore 文件(如 .env)的 worktree 会保留,需按 Phase 6 手动处理。共享 checkout 编辑被 PreToolUse hook 拦截时,先 git stash push -u -m "move to worktree",创建 worktree 后 git stash pop。
限制:venv 共享,不在 worktree 内执行 uv sync、uv lock、uv add,这些在共享 checkout 串行进行;清理仅针对 .agents/worktree/ 下无未提交变更且分支已合并的 worktree,确认可丢弃才用 --force;CI 监控、修复与 merge 判断不在本技能范围。缺失信息暂未提供。