用途:在 dotfiles 仓库中建立隔离工作区,避免猜测仓库入口。核心默认:优先使用仓库封装命令,而非通用 git worktree 或 vde-worktree 创建流程;以 config/vde/worktree/config.yml 为本地 worktree 策略来源;托管根目录假定为 .worktrees;交接或状态消息中报告最终 worktree 路径与分支;本技能只关注工作区隔离与检查,不涉及运行时激活或 Nix 切换。主要流程:执行 issue 时运行 issue-worktree-create <issue_number>,预期会 fetch origin、刷新 main、复用已有匹配分支、按需创建新链接 worktree、复制 .envrc、运行 repo-setup;PR 审查运行 pr-worktree-create <pr_number>,预期会 fetch origin、刷新 main、从 GitHub 解析 PR head 分支、创建或复用审查 worktree、复制 .envrc、运行 repo-setup;清理运行 worktree-remove <path>,接受 ghq 风格、绝对或相对路径,仅移除链接 worktree,不移除普通仓库克隆。通用工具:仅在封装流程未覆盖任务时使用 vde-worktree,可用 vde-worktree list --json 查看全部、vde-worktree status [branch] --json 查看单个、vde-worktree path <branch> [--json] 解析绝对路径;通过 z <keyword> 或 zi [keywords...] 重新进入;可用 cd "$(vde-worktree cd)" 选择路径;通用回退可用 vde-worktree switch <branch>。不要将 vde-worktree 作为本仓库 issue 或 PR 的主要入口,也不要单独用原始 zoxide 作为最外层选择器。进入工作区后先运行 pwd、git branch --show-current、git status --short 验证,需要更广可见性时用 git worktree list --porcelain 或 vde-worktree list --json。注意:仓库可能包含分离的链接 worktree;若任务涉及修改 worktree 脚本或配置,应视为代码变更任务并完整阅读相关文件。默认不要询问用户选择任意 worktree 目录,不要依赖 vde-worktree extract、absorb、unabsorb、adopt 或 gone,也不要编辑 .gitignore、config/vde/worktree/config.yml 或封装脚本,除非任务明确针对这些文件。
using-git-worktrees
部署与运维
更新于 10-15 22:16