pi-permission-gate
为Pi Agent提供配置驱动的权限控制系统。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-permission-gate。 它的用途是：为Pi Agent提供配置驱动的权限控制系统。 完整的 Skill 内容见：https://321skill.com/skills/pi-permission-gate/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请分析 /var/log 目录下的系统日志。” 如果配置中只允许访问 /tmp 目录，pi-permission-gate 会拦截此请求并记录日志，AI将无法执行该操作。你可以通过查看结构化日志，了解所有被拒绝的访问尝试。
介绍
pi-permission-gate 是一个专为 Pi 系列 AI 智能体设计的权限管理工具。它旨在解决智能体在调用外部工具或执行敏感操作时可能存在的安全风险，通过一套严谨的规则来限制智能体的行为边界，防止其执行未经授权的操作。
该工具采用配置驱动的方式，通过编写 YAML 配置文件来定义权限规则。其核心机制是“默认拒绝”，即任何未在配置中明确允许的工具或路径都将被禁止访问。系统支持使用 glob 模式进行灵活的路径匹配，并会自动对路径进行规范化处理，确保规则匹配的准确性。
它非常适合需要将 Pi Agent 集成到生产环境或处理敏感数据的开发者、运维人员和安全工程师。无论是构建一个需要严格管控的自动化工作流，还是开发一个面向用户的 AI 应用，此工具都能为智能体的行为加上一道安全锁。
使用建议是，在部署任何涉及文件操作、系统调用或第三方 API 交互的 Pi Agent 之前，都应优先考虑集成此权限门。注意事项包括：务必仔细规划和测试权限配置文件，避免因规则过严导致功能失效或过松留下安全漏洞；同时，其结构化日志功能有助于事后审计和问题排查。
核心特点
采用“默认拒绝”的安全模型，并集成了路径规范化与 glob 模式匹配，能更精确地控制文件系统等资源的访问，而非简单的功能开关。同时具备自我保护机制，防止权限系统自身被绕过。
注意事项
不适合对权限管理没有要求或需要动态、实时变更权限规则的简单实验性场景。
常见问题
pi-permission-gate 能防止 AI 乱删文件吗？
可以，通过配置 glob 规则，可以严格限制 AI 可访问的文件路径和操作类型。
这个工具会影响 Pi Agent 的正常功能吗？
正确配置下不会，它只拦截配置中禁止的操作，允许的操作不受影响。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-permission-gate/raw/index.md 读取 pi-permission-gate 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-permission-gate/raw/index.md（查看排版版本）