@rezamonangg/pi-worktree
将AI的文件和Shell操作隔离到独立的Git工作树中。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@rezamonangg/pi-worktree。 它的用途是：将AI的文件和Shell操作隔离到独立的Git工作树中。 完整的 Skill 内容见：https://321skill.com/skills/rezamonangg-pi-worktree/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我重构src/utils目录下的所有函数。”，它会自动在隔离的Git工作树中执行所有文件更改和相关的git命令。完成后，你可以单独检查这个工作树中的所有差异，再决定是否合并到主分支。
介绍
该Skill旨在解决AI助手在执行文件修改或Shell命令时，可能意外污染用户主Git工作区或造成冲突的问题。它通过创建一个临时的、与主分支隔离的Git工作树，将AI的所有文件操作（如创建、编辑、删除）和Shell命令执行都路由到这个沙盒环境中，从而保护用户的主工作区不受干扰。
使用时，用户只需在支持Pi框架的AI平台（如Claude Desktop）中安装并启用此Skill。当AI需要执行文件操作时，该Skill会自动介入，引导操作进入一个预先配置好的隔离工作树。用户可以在操作完成后，自行审查隔离工作树中的变更，并决定是否合并到主分支。
它非常适合那些频繁使用AI助手进行代码生成、脚本编写、文档编辑或系统运维，同时又非常在意代码仓库整洁度和安全性的开发者、运维工程师或技术写作者。
建议在开始一项可能涉及大量文件变更的AI协作任务前启用此Skill。需要注意的是，隔离工作树是临时的，请及时处理其中的变更。对于简单的单文件查询或无需持久化保存的临时操作，可能无需启用，以避免不必要的开销。
核心特点
与同类仅提供文件操作权限的Skill不同，它通过Git工作树实现真正的操作隔离，不仅隔离文件，也隔离了Shell命令的执行环境，提供了更完整的沙盒保护。
注意事项
不适合仅需读取文件信息或执行与当前Git仓库无关的纯计算任务的场景。
常见问题
Pi-worktree 是什么？
是一个将AI的文件和Shell操作路由到独立Git工作树的Pi框架Skill，用于隔离和保护主工作区。
用了它AI还能修改我的文件吗？
能，但所有修改会先进入一个隔离的工作树，不会直接影响你的主分支，需要你手动合并。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/rezamonangg-pi-worktree/raw/index.md 读取 @rezamonangg/pi-worktree 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/rezamonangg-pi-worktree/raw/index.md（查看排版版本）