@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 格式),按其中说明在我的环境里完成安装和配置。