pi-rewind-hook
Pi agent 自动 git 检查点与文件恢复
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-rewind-hook。 它的用途是：Pi agent 自动 git 检查点与文件恢复 完整的 Skill 内容见：https://321skill.com/skills/pi-rewind-hook/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我回到昨天下午3点那个会话节点，并恢复当时的文件状态'，它会自动在 `/tree` 中找到对应节点并执行文件恢复。或者直接输入 `/fork`，选择要分支的消息，然后选择'代码只恢复文件，保留当前对话'，即可快速回滚代码改动而不影响正在进行的对话。
介绍
这个 Skill 解决了在 AI 编码代理（Pi agent）开发过程中，文件状态丢失或难以回滚的问题。实际开发中，开发者经常需要尝试不同方案、切换分支或恢复之前的代码状态，但手动管理 git 提交或依赖 IDE 的本地历史往往不够灵活，尤其当会话被分叉、恢复或压缩时，文件状态容易丢失。
使用方式很简单，你只需要在 Pi agent 中安装后，一切自动运行。每次关键操作（如消息发送、会话分叉）都会自动创建 git 快照，并作为隐藏条目保存在会话元数据中。之后可以通过 /fork 命令选择从哪个历史点恢复，支持“仅恢复会话”、“恢复文件+会话”、“仅恢复文件”三种模式，甚至可以在 /tree 树形导航中直接对任意节点执行文件还原。
它非常适合需要频繁迭代代码、尝试不同路径的 AI 辅助开发团队或个人，尤其是那些已经使用 Pi agent 作为日常编码助手、需要细粒度版本回溯的场景。智能体开发者、后端程序员、全栈工程师都能从中受益，减少因误操作或分支混乱导致的工作量重复。
建议在项目初期就安装此扩展，让自动检查点成为开发工作流的一部分。需要注意的是，它依赖 Git 仓库环境，且 Pi agent 版本需 ≥ v0.65.0。如果开启无限保留，git 对象存储会持续增长，建议按需配置 retention 策略控制快照数量与保存天数。
常见问题
如何安装 pi-rewind-hook？
在终端中执行 `pi install npm:pi-rewind-hook`，扩展会自动下载并启用，无需手动修改 settings.json。
如何配置保留策略以控制存储增长？
在 `~/.pi/agent/settings.json` 中添加 `rewind.retention` 对象，例如 `maxSnapshots: 2000`、`maxAgeDays: 30`，还可设置 `pinLabeledEntries: true` 保护重要节点不被清理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-rewind-hook/raw/index.md 读取 pi-rewind-hook 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-rewind-hook/raw/index.md（查看排版版本）