@thisux/pi-worktree

在 Pi 中管理 Git worktree 的斜杠命令

安装使用

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

帮我安装这个 AI Skill:@thisux/pi-worktree。
它的用途是:在 Pi 中管理 Git worktree 的斜杠命令
完整的 Skill 内容见:https://321skill.com/skills/thisux-pi-worktree/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'/worktree add fix-login',它会自动检测当前仓库,创建名为 fix-login 的 worktree 目录(如 ~/project-fix-login),并切换到该分支。如果本地没有该分支,会从远程 origin 跟踪或基于 main 新建。之后可以用 '/worktree ls' 查看所有 worktree 列表。

介绍

这个 Skill 解决了在 AI 编码会话中频繁切换 Git 分支时,手动创建和管理 worktree 效率低下的问题。在实际开发中,开发者经常需要同时处理多个特性分支、修复紧急 Bug 或审查 PR,而传统 git worktree 命令需要记住复杂参数,且无法与 AI 助手自然交互。

使用方式很简单,你只需要在 Pi 会话中安装该包,然后通过自然语言指令如 /worktree add fix-login 即可自动创建基于当前仓库的 worktree 目录。之后可以通过 /worktree ls 列出所有 worktree,/worktree open <branch> 显示路径,/worktree rm <branch> 安全删除,甚至 /worktree pr 42 直接拉取 GitHub PR 并创建 worktree。所有操作都在会话内完成,无需离开终端。

它非常适合需要频繁并行开发多个功能、同时维护多个版本或参与开源协作的全栈开发者和后端工程师。尤其是那些已经使用 Pi 作为 AI 编码助手的团队,可以无缝集成到日常开发流程中,减少上下文切换成本。

建议在开始新功能或修复 Bug 时统一使用此工具来创建隔离的工作目录。需要注意的是,它主要依赖 Git 和 GitHub CLI(gh),且必须在已初始化的 Git 仓库内运行。删除 worktree 时默认保留分支,并会二次确认脏工作区,安全性较高。

常见问题

如何安装这个 Skill?

在 Pi 会话中执行 `pi install npm:@thisux/pi-worktree`,然后 `/reload` 即可。

如何更新到最新版本?

执行 `pi update npm:@thisux/pi-worktree`。

给 AI 助手的安装指引

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

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