@pi-vault/pi-plan

为Pi添加只读规划模式,先探索再产出完整实施计划

安装使用

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

帮我安装这个 AI Skill:@pi-vault/pi-plan。
它的用途是:为Pi添加只读规划模式,先探索再产出完整实施计划
完整的 Skill 内容见:https://321skill.com/skills/pi-vault-pi-plan/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

‘我们需要开发一个用户积分系统,请切换到规划模式,我们一起分析一下。’ 它会引导你讨论积分规则、数据模型、并发处理、与现有系统的集成点等。探索完成后,

对AI说:‘基于刚才的讨论,请生成完整的实施计划。’ 它会输出一份包含技术栈选择、模块划分、API设计、数据库变更、测试策略和阶段排期的详细文档。

介绍

Pi Plan 是一个为 Pi 扩展添加“只读规划模式”的插件。它解决的核心问题是,在复杂任务中,开发者或团队常常在没有充分探索和决策的情况下就急于开始编码,导致后续频繁返工、方向偏离或计划不完整。

该插件的使用方式非常直接。安装后,在 Pi 中激活“只读规划模式”。在此模式下,你可以与 AI 深入探讨任务背景、潜在方案、技术选型和风险点,AI 会协助你进行全面的前期分析,但不会直接生成代码。当探索充分后,你可以退出此模式,AI 将基于之前的讨论,产出一份决策完备、步骤清晰的详细实施计划。

它非常适合需要严谨技术设计的软件工程师、架构师以及项目负责人。特别是在启动新模块、重构旧系统或评估复杂技术方案时,它能帮助团队统一认识,明确技术路径,避免盲目开工。

使用建议是,在启动任何你认为复杂度中等以上的开发任务前,都先开启此模式进行一轮“纸上谈兵”。注意事项是,它主要服务于计划制定阶段,不直接生成可执行代码,因此不适合用于快速原型验证或已经思路非常清晰的简单任务。

核心特点

与直接生成代码或简单任务拆解的技能不同,Pi Plan 强制进行“只读”的前期探索阶段,确保在产出具体计划前,所有关键决策(如技术选型、架构权衡、潜在风险)都已被充分讨论和确认,从而生成的是“决策完备”的实施蓝图,而非简单的待办列表。

注意事项

不适合用于思路已极其清晰、或需要立即看到代码原型的快速验证场景。

常见问题

Pi Plan 能直接生成代码吗?

不能,它的核心是生成详细的实施计划,代码实现需基于该计划另行完成。

这个模式会影响正常的 Pi 编码功能吗?

不会,它是一个可切换的模式,退出后即可恢复正常编码对话。

给 AI 助手的安装指引

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

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