SuperAPI AI 工具集

git-worktree-workflows

办公与效率

查看项目

更新于 10-16 01:29

技能介绍

用途:该技能围绕 gw CLI 组织 Git worktree 的并行开发流程,要求在已安装 gw 的仓库中一律使用 gw,而非原生 git worktree。安装方式为 brew install mthines/gw-tools/gw 或 npm install -g @gw-tools/gw,可用 which gw 检查。

主要能力:gw checkout 创建 worktree(gw add、gw co 为别名),支持 --from、--from-staged、--no-cd、--no-fetch、--no-hooks;gw cd 按名称或部分匹配导航;gw list 列出 worktree;gw pr 检出 PR(支持编号或 URL);gw update 以 merge 或 rebase 更新;gw sync 同步自动复制文件;gw remove 删除 worktree 及本地分支,支持 --preserve-branch、批量与 --dry-run;gw clean 批量清理已提交并推送的 worktree;gw prune 清理 worktree 与孤立分支;gw root、gw protect、gw unprotect 辅助管理。代理命令包括 gw lock、gw unlock、gw repair、gw move、gw prune --stale-only。

使用方式:首次用 gw init 初始化,可配置 autoCopyFiles 与 post-checkout 钩子;gw cd 与自动导航需在 ~/.zshrc 加入 eval "$(gw install-shell)"。配置存于 .gw/config.json 与 .gw/config.local.json,含 defaultBranch、autoCopyFiles、hooks、cleanThreshold、autoClean、updateStrategy、protectedBranches,钩子变量有 {worktree}、{worktreePath}、{gitRoot}、{branch}。

适用场景:功能分支开发、紧急修复、隔离环境代码评审、并行测试等。

限制:同一分支不能同时检出到两个 worktree;gw checkout 默认执行 git ls-remote 探测远程(3 秒超时),离线时用 --no-fetch;未安装 shell 集成时 gw cd 与自动导航会静默失效。其余细节暂未提供。