@georgedong32/permission-modes
为Pi编码代理提供Claude式的权限控制模式
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@georgedong32/permission-modes。 它的用途是:为Pi编码代理提供Claude式的权限控制模式 完整的 Skill 内容见:https://321skill.com/skills/georgedong32-permission-modes/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启用plan模式,分析并给出重构src/utils目录下所有模块的步骤。” 它会先生成详细的执行计划供你确认,而不会直接操作。或者,在auto模式下
对AI说:“自动修复所有ESLint报出的错误。” 它会在你预设的目录和模型配置下,直接执行修复并提交更改。
介绍
这个Skill为Pi编码代理(pi coding agent)引入了类似Claude Code的权限控制模式(ask/plan/auto),旨在解决AI编码助手在自动化操作时可能带来的安全风险与不可控问题。它允许用户根据任务的安全性和复杂性,在三种模式间切换:‘ask’模式会就任何潜在风险操作进行询问,‘plan’模式会先提供执行计划,‘auto’模式则在设定范围内全自动执行,从而平衡了效率与控制力。
使用上,开发者需要先安装此Skill,然后在配置中为不同的权限模式指定对应的AI模型配置、允许写入的目录范围(支持跟踪CWD外的写入),并可以按模式过滤可用的其他Skill。这使得AI代理的行为能够被精确地约束在项目所需的边界内。
它非常适合那些希望利用AI代理自动化编码、重构或文件操作,但又需要对AI行为保持一定监督和控制权的开发者,特别是在处理重要或复杂项目时。对于个人项目探索或需要快速原型开发的场景,也能通过模式切换来灵活应对。
建议在使用前仔细规划不同模式下的模型配置和目录权限,例如在’auto’模式下使用能力更强但成本更高的模型,并严格限制其写入范围。对于团队项目,建议统一配置并文档化,以确保协作安全。注意,其权限控制主要基于文件系统和Skill过滤,对于代码逻辑本身的安全性仍需开发者审阅。
核心特点
核心区别在于将Claude Code的成熟权限交互理念(ask/plan/auto)体系化地引入Pi代理,并深度整合了按模式配置不同AI模型、跟踪CWD外写入行为以及按模式过滤Skill三大特性,实现了粒度更细、配置更灵活的行为管控。
注意事项
不适合追求完全无干预、极致自动化编码流程的场景,因其核心设计理念包含了必要的人工监督环节。
常见问题
如何切换ask/plan/auto模式?
通常在启动Pi代理或通过特定配置命令进行设置,具体请参考Skill文档。
能防止AI修改系统关键文件吗?
可以,通过配置`outside-cwd write tracking`来限制或跟踪对当前工作目录外文件的写入。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/georgedong32-permission-modes/raw/index.md 读取 @georgedong32/permission-modes 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/georgedong32-permission-modes/raw/index.md(查看排版版本)