gw-tools

一个用于高效管理Git工作树的命令行工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:gw-tools。
它的用途是:一个用于高效管理Git工作树的命令行工具
完整的 Skill 内容见:https://321skill.com/skills/gw-tools/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我正在开发一个新功能分支‘feature-payment’,需要创建一个独立的工作树并复制主分支的.env文件。”,它会指导你使用 `gw add feature-payment` 命令,该命令会自动创建分支(如不存在)、创建工作树并复制配置好的文件。然后你可以用 `gw cd feature-payment` 快速进入该目录开始工作。

介绍

gw-tools 是一个专为开发者设计的Git工作树管理工具,旨在解决多分支并行开发时环境切换繁琐、文件同步困难的问题。它通过一个名为 gw 的命令行工具,将创建、导航、同步和删除Git工作树的操作简化为几个简单的命令,并支持自动复制配置文件(如.env)等实用功能。

使用gw-tools非常简单。首先通过Homebrew或npm安装gw CLI,然后在shell配置中集成它。之后,你可以用 gw init 初始化仓库,用 gw add <branch> 创建新工作树,用 gw cd <branch> 快速切换,用 gw sync 同步文件,整个过程流畅且自动化。

这个工具非常适合需要频繁在不同功能分支间切换、进行代码审查或并行处理多个任务的前后端开发、全栈开发和运维工程师。它能显著减少手动操作,提升开发效率。

建议在使用前仔细阅读其文档,了解如何配置自动同步的文件模式。对于大型项目或复杂的monorepo,可能需要根据项目结构进行特定的配置调整,以达到最佳效果。

核心特点

与基础的 `git worktree` 命令相比,gw-tools 的核心优势在于自动化的文件同步(如.env、配置文件)和智能的模糊匹配导航(`gw cd`),无需手动复制环境文件或输入完整分支名,极大简化了多工作树环境下的开发流程。

注意事项

主要面向熟悉Git工作树概念的开发者,对于不熟悉此概念的新手或仅使用简单Git工作流的用户可能过于复杂。

常见问题

gw 和普通的 git worktree 命令有什么区别?

gw 封装并增强了 git worktree,增加了自动复制配置文件、智能分支名匹配导航(gw cd)、以及便捷的文件同步(gw sync)等功能。

gw 支持哪些Shell?

支持 Bash、Zsh 和 Fish,通过运行 `gw install-shell` 并按照提示配置即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/gw-tools/raw/index.md 读取 gw-tools 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。