@ramarivera/pi-model-guardrails
为Pi代码助手提供确定性的破坏性命令防护与策略引擎。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@ramarivera/pi-model-guardrails。 它的用途是：为Pi代码助手提供确定性的破坏性命令防护与策略引擎。 完整的 Skill 内容见：https://321skill.com/skills/ramarivera-pi-model-guardrails/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我清理一下项目的`node_modules`缓存。” 如果`rm -rf node_modules`命令在你的防护列表中，Skill会拦截该请求并提醒你确认。或者，如果你设置了“不得修改package.json”的约束，当AI试图更新依赖时也会被阻止。
介绍
该Skill旨在解决AI编码助手在执行过程中可能意外运行破坏性命令（如删除文件、格式化磁盘）或违反预设约束（如不得修改特定文件）的安全风险。它通过一个确定性的守护层和一个不可违反的策略引擎，在Pi Agent执行操作前进行拦截和检查，确保开发环境的安全与可控。
使用时，开发者需要预先定义好需要防护的破坏性命令（如rm -rf）以及不可违反的策略约束（如“不得修改src/core/目录下的文件”）。当Pi Agent尝试执行相关操作时，该Skill会进行匹配和判断，若触发规则则阻止执行并反馈给用户，从而将潜在风险扼杀在执行前。
它非常适合那些深度集成AI编码助手（如Pi）到其开发工作流中，并高度重视代码库安全性与稳定性的团队或个人开发者。尤其适用于在敏感或生产环境相关的代码库中进行探索和开发时，提供一道安全护栏。
建议在项目初期或接入AI助手时即配置此Skill，并根据项目特点仔细定义防护规则。需要注意的是，其防护效力依赖于规则定义的完备性与准确性，过于宽松的规则可能留下漏洞，而过于严格的规则则可能影响开发效率，需在安全与便利间取得平衡。
核心特点
与同类防护工具相比，它专为Pi Agent深度集成设计，不仅拦截破坏性命令，更提供了一个可定义“不可违反约束”的策略引擎及偏差状态机，能对AI行为进行更复杂、更贴近项目特定需求的策略管控。
注意事项
该Skill的防护能力高度依赖预先手动配置的规则，无法防护规则定义范围之外的未知风险操作。
常见问题
这个防护工具能防止AI删除我的代码吗？
可以，只要将`rm`、`del`等删除命令加入防护列表，AI执行时就会被拦截。
它会影响Pi Agent的正常编码功能吗？
不会，它只在你定义的破坏性命令或违反约束时介入，常规编码操作不受影响。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ramarivera-pi-model-guardrails/raw/index.md 读取 @ramarivera/pi-model-guardrails 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ramarivera-pi-model-guardrails/raw/index.md（查看排版版本）