pi-permissions
为AI工具pi提供可配置的权限规则，控制其对系统的访问。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-permissions。 它的用途是：为AI工具pi提供可配置的权限规则，控制其对系统的访问。 完整的 Skill 内容见：https://321skill.com/skills/pi-permissions/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请用pi工具检查/var/log目录下的日志文件大小。” 配置了pi-permissions后，AI会先触发权限检查。如果规则允许读取/var/log/*，则命令正常执行并返回结果；如果规则禁止，则操作会被拦截，并向用户返回权限错误提示。
介绍
pi-permissions 是一个为 pi 工具调用设计的权限控制模块，旨在解决AI助手在调用系统命令、读写文件时可能存在的安全风险与权限滥用问题。它通过定义清晰的允许（allow）和拒绝（deny）规则，让用户能够精细化管理AI可以执行的bash命令、读取的文件路径、写入或编辑的操作范围，从而在提供便利的同时保障系统安全。
使用方式非常直接，开发者可以在项目中引入此npm包，并通过配置文件（如JSON或YAML）来定义权限规则集。这些规则可以基于命令模式、文件路径模式等进行匹配，当pi工具尝试执行操作时，该模块会进行拦截和校验，只有符合规则的操作才会被放行，否则将被阻止并返回错误。
它非常适合那些在开发、运维或自动化脚本场景中深度集成pi工具，但又需要对AI助手的行为进行安全约束的团队和个人开发者。例如，在共享服务器、生产环境或处理敏感数据的项目中，管理员可以通过此工具确保AI不会执行危险命令或访问机密文件。
在使用建议上，建议从最严格的拒绝所有规则开始，再逐步添加必要的允许规则（最小权限原则）。同时，规则定义应尽可能具体，避免使用过于宽泛的通配符。定期审查和更新规则以适应项目变化也是必要的。请注意，此模块主要控制通过pi工具发起的操作，并不能替代系统层面的其他安全措施。
核心特点
与同类权限控制方案相比，pi-permissions专为pi工具链设计，深度集成其调用流程，能精准拦截命令、文件读写等底层操作；它采用声明式、可配置的规则文件，无需修改pi工具核心代码，提供了更高的灵活性和可维护性。
注意事项
此skill仅适用于控制通过pi工具发起的操作，无法管理其他非pi渠道（如直接终端、其他AI工具）对系统的访问。
常见问题
pi-permissions能防止AI删除重要文件吗？
可以，通过在规则中明确拒绝（deny）对特定路径的写入或删除操作来实现。
规则配置复杂吗？支持通配符吗？
配置基于模式匹配，支持通配符（如*），可以从简单规则开始，逐步细化。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-permissions/raw/index.md 读取 pi-permissions 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-permissions/raw/index.md（查看排版版本）