@aliou/pi-guardrails
为Pi代理添加安全护栏，防止意外操作
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@aliou/pi-guardrails。 它的用途是：为Pi代理添加安全护栏，防止意外操作 完整的 Skill 内容见：https://321skill.com/skills/aliou-pi-guardrails/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我清理项目中的临时文件，但不要删除任何配置文件或敏感数据。' 它会自动调用guardrails策略，在删除前检查路径是否在白名单中，如果遇到危险命令（如`rm -rf`），会弹出确认窗口，你可以选择仅允许本次执行或永久拒绝。
介绍
这个Skill解决了Pi代理在自主执行任务时的安全隐患问题。在实际开发中，AI代理可能会无意中读取.env、私钥等敏感文件，修改项目范围内的受保护路径，或执行rm -rf、磁盘格式化等高危shell命令，导致数据泄露或系统损坏。
使用方式很简单，安装后运行/guardrails:onboarding选择初始配置，之后通过/guardrails:settings随时调整策略。它内置了三个扩展：文件保护策略（保护特定文件/路径）、路径访问控制（限制访问工作区外路径）、权限门（拦截危险shell命令）。在路径访问中，你可以选择允许、拦截或每次询问；在权限门中，可以允许一次、允许本次会话、拒绝或终止当前对话。
它非常适合需要让AI代理自主操作文件系统和执行命令的团队或个人。尤其是那些已经使用Pi作为编码助手，希望在不牺牲安全性的前提下让代理更自由地运行构建、部署、数据操作等任务的开发者。如果你是运维人员或安全敏感的项目负责人，这个Skill能显著降低AI误操作带来的风险。
建议在配置时先通过/guardrails:onboarding选择推荐的安全策略，再根据项目需求微调。需要注意的是，它主要针对Pi代理环境，对shell命令的检测基于内置风险模式库，如果你有自定义的危险命令模式，可以通过配置文件扩展。另外，路径访问控制默认只检查工作区外路径，不影响工作区内的正常操作。
常见问题
怎么安装pi-guardrails？
执行 `pi install npm:@aliou/pi-guardrails` 即可安装。
如何配置保护哪些文件？
运行 `/guardrails:settings` 进入交互式设置，或在文件 `~/.pi/agent/extensions/guardrails.json` 中直接编辑策略。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/aliou-pi-guardrails/raw/index.md 读取 @aliou/pi-guardrails 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/aliou-pi-guardrails/raw/index.md（查看排版版本）