@harms-haus/pi-worktrees

为 pi-coding-agent 扩展的 Git 工作树管理工具

安装使用

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

帮我安装这个 AI Skill:@harms-haus/pi-worktrees。
它的用途是:为 pi-coding-agent 扩展的 Git 工作树管理工具
完整的 Skill 内容见:https://321skill.com/skills/harms-haus-pi-worktrees/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'请为 feature/new-auth 分支创建一个新的工作树。',它会执行 `/wt-create` 命令,在指定位置生成独立目录。然后你可以说:'切换到那个工作树。',AI 会使用 `/wt-switch` 命令将你的工作环境切换到新创建的工作树中,让你可以专注于该功能的开发。

介绍

这个 Skill 解决了开发者在单一 Git 仓库中需要同时处理多个分支或任务时,频繁切换上下文和暂存修改的痛点。它通过创建独立的 Git 工作树,让每个任务分支拥有专属的目录,实现并行开发互不干扰。

使用方式非常直接,通过向集成了此 Skill 的 AI 助手(如 pi-coding-agent)发送特定命令即可。主要命令包括:/wt-create 创建新工作树,/wt-switch 切换工作树,/wt-merge 合并工作树,以及 /wt-cleanup 清理已合并或废弃的工作树。

它非常适合需要同时维护多个功能分支、修复紧急 Bug 或进行代码审查的开发者,特别是那些在复杂项目中工作、希望保持主工作区整洁的工程师。

使用建议是,在开始一项新功能或修复时,优先使用 /wt-create 创建独立工作树。注意事项包括:确保理解工作树与主仓库的关联,定期使用 /wt-cleanup 清理以避免磁盘空间浪费,并在合并前确认目标分支正确。

核心特点

这是专为 pi-coding-agent 设计的原生扩展,深度集成于其工作流中,通过自然语言命令即可管理 Git 工作树,无需离开编码会话或手动执行复杂 Git 命令。与通用 Git 工具相比,它更侧重于在 AI 辅助编程场景下的无缝、上下文感知的版本控制操作。

注意事项

此 Skill 仅适用于已安装并配置了 pi-coding-agent 的环境,且主要面向 Git 工作流,不适用于其他版本控制系统。

常见问题

如何安装这个 Skill?

在 pi-coding-agent 环境中运行 npm install @harms-haus/pi-worktrees 命令。

这个 Skill 支持哪些 Git 命令?

支持工作树的创建、切换、合并和清理,对应 /wt-create, /wt-switch, /wt-merge, /wt-cleanup 命令。

给 AI 助手的安装指引

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

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