pi-permission-modes
为Pi AI代理提供声明式、可自定义的权限管理模式。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-permission-modes。 它的用途是：为Pi AI代理提供声明式、可自定义的权限管理模式。 完整的 Skill 内容见：https://321skill.com/skills/pi-permission-modes/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我列出当前目录下所有文件，并查找包含密码关键词的日志。”，AI在尝试执行`find`或`grep`命令前，会先根据你激活的“审计”模式策略进行检查，如果该命令被允许，则正常执行；如果策略设置为“询问”，则会向你确认；若被拒绝，则会提示你无相应权限。
介绍
该Skill旨在解决AI编码助手（如Pi）在运行命令和工具时可能带来的安全与权限失控问题。用户常常担心AI会执行危险命令或访问敏感数据，而传统的全有或全无的权限模型无法满足精细控制的需求。
它通过一套声明式的配置系统来工作。用户可以为不同的操作模式（如“安全”、“开发”、“审计”）定义策略，明确哪些工具、命令或技能允许执行、需要询问还是直接拒绝。核心机制包括利用OS级别的沙箱（如bubblewrap）隔离进程，通过树解析器（tree-sitter）对Bash命令进行抽象语法树级别的门控，以及动态隐藏或限制特定工具和自定义技能。
适合对AI助手安全性有较高要求的开发者、系统管理员和安全研究人员。特别是那些需要在生产环境或存有敏感数据的项目中引入AI辅助编码，但又必须确保操作受控、可审计的团队。
使用建议是，初次部署时建议从最严格的“安全”模式开始，仅允许少数必要的基础命令。然后根据实际工作流，逐步在“开发”等模式中添加白名单。注意事项包括，沙箱配置可能因操作系统而异（Linux使用bubblewrap，macOS使用sandbox-exec），且对命令的AST解析主要针对Bash，其他Shell的支持可能有限。
核心特点
与同类仅提供简单黑白名单的权限工具不同，它实现了多层、细粒度的权限控制：结合了操作系统级沙箱隔离、基于真实Bash语法树（AST）的命令意图分析，以及可按技能和自定义工具进行动态门控的策略引擎。
注意事项
不适合需要AI助手完全自由、无限制访问系统以进行探索性调试或快速原型设计的场景。
常见问题
这个权限模式会影响AI的正常编码能力吗？
不会完全阻止，但会根据策略对危险或越权操作进行拦截或询问，在安全与功能间取得平衡。
支持Windows系统吗？
核心的OS沙箱功能主要针对Linux（bubblewrap）和macOS（sandbox-exec），Windows支持可能有限或需要额外配置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-permission-modes/raw/index.md 读取 pi-permission-modes 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-permission-modes/raw/index.md（查看排版版本）