pi-agent-permissions
为Pi CLI提供可配置的AI代理权限管理策略
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-agent-permissions。 它的用途是：为Pi CLI提供可配置的AI代理权限管理策略 完整的 Skill 内容见：https://321skill.com/skills/pi-agent-permissions/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我运行数据库迁移命令”，AI代理在执行前会检查`.agents/permissions.json`中的规则。如果规则允许运行数据库相关命令，它会正常执行；如果规则禁止，它会拒绝操作并提示权限不足，从而确保安全。
介绍
该Skill是一个Pi CLI扩展，旨在解决AI代理在自动化任务中权限控制不透明、难以管理的问题。它允许开发者通过项目目录下的.agents/permissions.json文件以及原生代理配置，清晰地定义和限制AI代理可以执行的操作范围，从而提升安全性和可控性。
使用方式非常直接：在项目中安装此扩展后，创建一个permissions.json文件，在其中以JSON格式声明允许或禁止的CLI命令、文件访问路径等规则。Pi CLI在运行时将读取这些策略，确保AI代理的操作严格在预设的边界内进行，防止越权行为。
它非常适合那些在开发流程中深度集成AI代理（如Claude、Cursor等）的团队和个人开发者，尤其是需要对敏感操作（如生产环境部署、数据库修改、关键文件读写）进行审计和约束的场景。
建议在项目初期就引入此权限策略，并与团队共同制定规则。注意，权限配置需要与具体的AI代理工具（如Cursor的Agent配置）配合使用才能完全生效，且主要管理的是通过Pi CLI触发的代理行为，对直接使用其他AI工具界面的操作约束有限。
核心特点
它通过一个独立的、版本可控的JSON配置文件来集中管理权限，与项目代码库集成，便于团队协作和策略追溯；同时，它作为Pi CLI的扩展，能与Pi生态内的其他工具和原生代理配置无缝结合，提供统一的权限管控入口。
注意事项
此Skill主要作用于通过Pi CLI调用的AI代理操作，对于直接在IDE（如Cursor独立Agent）或其他非Pi CLI通道执行的AI行为可能无法完全约束。
常见问题
permissions.json文件应该放在哪里？
通常放在项目根目录的.agents文件夹下，即`.agents/permissions.json`。
这个权限管理能防止AI删除重要文件吗？
可以，通过在permissions.json中配置禁止对特定路径的写入或删除操作来实现。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-agent-permissions/raw/index.md 读取 pi-agent-permissions 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-agent-permissions/raw/index.md（查看排版版本）