@kmiyh/pi-plan-mode

为Pi添加只读计划模式,用于安全分析代码和追踪执行进度。

安装使用

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

帮我安装这个 AI Skill:@kmiyh/pi-plan-mode。
它的用途是:为Pi添加只读计划模式,用于安全分析代码和追踪执行进度。
完整的 Skill 内容见:https://321skill.com/skills/kmiyh-pi-plan-mode/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

‘启用Plan Mode,分析当前项目的用户认证模块,并提取接下来的重构步骤。’ 它会自动锁定文件为只读,然后解析模块依赖,生成一个包含子任务和依赖关系的可视化计划图,并允许你随着重构推进,在图上标记每个步骤的完成状态。

介绍

Pi Plan Mode 是一款Pi编辑器扩展,它通过引入一个只读的“计划模式”,专门解决在分析复杂代码库或协作项目时,因误操作而意外修改代码的风险。该模式将工作区锁定为只读状态,允许开发者安全地浏览、理解代码结构和提取执行计划,同时还能可视化地追踪任务执行的进度。

使用时,用户需要在Pi编辑器中安装并启用此扩展。启用后,可以在编辑器界面中切换到“Plan Mode”。在此模式下,所有文件变为只读,但用户仍可进行代码导航、调用AI进行分析、生成任务分解图,并通过集成的进度条或看板视图来跟踪每个子任务的完成状态。

它非常适合需要频繁进行代码审查、项目交接或制定详细开发计划的软件工程师、技术负责人和项目经理。对于开源项目贡献者或远程协作团队,在深入理解他人代码逻辑而无需立即修改的场景下,此工具能提供安全的探索环境。

建议在开始一个新功能开发或修复复杂Bug前,先使用此模式分析相关代码模块,绘制执行路线图。需要注意的是,该模式旨在辅助规划和理解,不适用于实际的编码或调试阶段,进行写操作时需要切换回常规编辑模式。

核心特点

与仅提供代码高亮或静态分析的插件不同,它强制启用只读环境来杜绝误编辑,并集成了从代码分析到任务进度追踪的完整工作流,而非单一功能。

注意事项

不适合需要直接修改代码、进行实时调试或快速原型开发的场景。

常见问题

Pi Plan Mode 会修改我的代码吗?

不会,在计划模式下所有文件均为只读,确保代码安全。

如何跟踪任务执行进度?

扩展提供可视化进度条或看板,用于标记已提取计划的完成情况。

给 AI 助手的安装指引

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

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