@aprimediet/permission-modes

为pi编码代理提供权限模式循环切换

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@aprimediet/permission-modes。
它的用途是:为pi编码代理提供权限模式循环切换
完整的 Skill 内容见:https://321skill.com/skills/aprimediet-permission-modes/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'切换到 plan 模式,帮我分析当前项目的文件结构,输出一个重构计划。' 它会自动进入只读模式,扫描代码后生成带编号的 Plan: 块,然后询问是否执行该计划。若回复 '执行',则自动切换回 default 模式并逐步执行每个步骤,同时显示进度。

介绍

这个Skill解决了在AI编码代理开发中,手动频繁确认权限导致效率低下的问题。在实际开发中,开发者经常需要在“每次询问后批准”、“只读探索”和“完全自动执行”三种模式间切换,但原生pi缺少一键切换的能力,导致工作流割裂。

使用方式很简单,你只需要通过 pi install npm:permission-modes 安装,之后使用 Shift+Tab 快捷键即可在 default(默认询问)、plan(只读规划)和 auto(全自动)三种模式间循环切换。也可以通过 /default/plan/auto 命令直接跳转,或使用 /auto-depth <n> 控制自动执行的最大步数。在 plan 模式下,代理会先输出结构化计划,用户确认后自动执行;auto 模式下所有操作自动批准,并自动发送“继续”指令直到任务完成。

它非常适合需要频繁切换开发状态的团队或个人。尤其是那些已经使用 pi 编码代理进行复杂项目开发,但希望在某些阶段(如代码审查前)进行只读探索,在调试阶段启用全自动执行,在常规开发中保持手动确认的开发者。对于需要批量处理任务或需要严格权限控制的场景尤为实用。

建议在团队协作时统一约定默认模式,避免误操作。需要注意的是,auto 模式会自动批准所有工具调用(包括跨目录写入),建议仅在明确信任的任务中使用。若在 headless 或 RPC 模式下,任何需要用户确认的调用都会被自动阻止,确保安全。

常见问题

如何快速切换到只读模式?

按 Shift+Tab 循环到 plan 模式,或直接输入 /plan 命令。在 plan 模式下所有写入和修改操作都被禁用,只能读取和浏览。

auto 模式如何停止自动执行?

输入 /done 命令可立即停止自动跟进,或手动切换回 default/plan 模式。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/aprimediet-permission-modes/raw/index.md 读取 @aprimediet/permission-modes 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。