@andrewjacop/pi-port
一键迁移AI代理配置到新机器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@andrewjacop/pi-port。 它的用途是：一键迁移AI代理配置到新机器 完整的 Skill 内容见：https://321skill.com/skills/andrewjacop-pi-port/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'导出我的pi agent配置到桌面'，它会启动交互式向导，让你选择要导出的模块（如settings、trust、skills等），确认后生成一个`.pi-backup`文件。在另一台机器上
对AI说：'从桌面恢复刚才的备份'，它会自动解析备份文件，提示你选择恢复哪些模块，并自动将源路径（如/Users/alice/...）重写为目标路径（如/home/bob/...），然后恢复配置。
介绍
这个Skill解决了在多个机器之间迁移AI代理配置时的手动重复劳动问题。当开发者需要在不同电脑上同步开发环境时，经常需要逐一复制settings.json、auth.json、trust.json、skills目录等，还要手动记录npm包列表，过程繁琐且容易遗漏。
使用方式很简单，你只需要在源机器上运行/export-pi命令，它会启动交互式向导，让你选择要导出的配置模块（如设置、认证、信任、技能、Git包等），并自动生成一个小于10MB的.pi-backup备份文件。在目标机器上运行/import-pi并指定该文件，它会自动解析清单、校验校验和，并引导你选择要恢复的模块，同时自动将源机器的绝对路径重写为目标机器的home路径。
它非常适合需要频繁切换开发环境或管理多台设备的智能体开发者、全栈工程师和运维人员。尤其是那些已经部署了多个pi agent实例，并希望快速在不同机器间同步配置，避免重复安装技能和手工配置的团队或个人。
建议在首次配置新设备时统一使用此工具进行配置迁移。需要注意的是，它主要依赖系统自带的tar命令，目前v0.1仅支持macOS和Linux，Windows用户需要等待后续版本。另外，auth.json包含API密钥，导出时会有双重警告，请确保备份文件仅保存在安全位置。
常见问题
如何安装Pi Port？
通过pi命令安装：`pi install npm:@andrewjacop/pi-port` 或 `pi install git:github.com/andrewjacop/pi-port@v0.1.0`，安装后自动加载/export-pi和/import-pi两个命令。
备份文件会包含API密钥吗？
auth.json默认不包含在导出中，需要手动确认才会包含，且导出时会有两次警告提示。建议仅在安全环境下使用，并妥善保管备份文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/andrewjacop-pi-port/raw/index.md 读取 @andrewjacop/pi-port 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/andrewjacop-pi-port/raw/index.md（查看排版版本）