@kungfusaini/pi-plan-mode

为Pi编码代理提供只读计划模式和持久化项目计划管理

安装使用

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

帮我安装这个 AI Skill:@kungfusaini/pi-plan-mode。
它的用途是:为Pi编码代理提供只读计划模式和持久化项目计划管理
完整的 Skill 内容见:https://321skill.com/skills/kungfusaini-pi-plan-mode/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“加载我们之前为电商平台项目制定的开发计划。”,它会从XDG存储路径读取持久化的计划文件,并基于该计划理解当前的开发阶段、待办任务和整体架构,从而提供精准的代码建议。在完成一个模块后,你可以说:“将用户认证模块标记为已完成,并更新计划。”,AI会协助你安全地更新计划文件,为下一阶段工作做好准备。

介绍

该Skill旨在解决Pi编码代理在复杂项目开发中,因缺乏持久化计划管理而导致的上下文丢失和任务不连贯问题。它通过引入只读计划模式,确保项目计划在会话间稳定存在,防止意外修改,同时利用XDG标准路径存储计划文件,实现跨会话的持久化。

使用方式简单直接,安装后即可在Pi编码代理中启用。开发者可以创建、保存项目计划,并在后续的编码会话中加载这些计划,确保AI助手始终基于最新的、完整的项目上下文进行工作,无需重复解释项目背景或目标。

该Skill非常适合需要长期、分阶段开发复杂项目的开发者,尤其是全栈开发、智能体开发和项目经理。他们可以利用此工具来规划功能模块、拆解开发任务,并确保编码代理在整个项目周期内保持对整体目标的清晰认知。

建议在项目启动初期就启用此Skill来制定初步计划,并在每个开发阶段结束后更新计划内容。需要注意的是,计划文件存储在本地XDG配置目录,若在多台设备间协作,需自行同步这些文件以保证计划的一致性。

核心特点

核心区别在于其“只读计划模式”和“XDG标准持久化存储”。与仅提供临时任务列表的同类工具不同,它通过只读模式锁定计划防止误改,并利用操作系统标准路径确保计划文件在本地持久存在,实现了项目计划在AI编码会话间的可靠传递与复用。

注意事项

不适合用于需要频繁、动态调整短期任务清单的敏捷冲刺场景,其只读模式更侧重于维护稳定的长期项目蓝图。

常见问题

这个Skill如何帮助我管理多个项目?

它为每个项目创建独立的计划文件,通过XDG路径存储,您可以在不同项目中切换并加载对应的计划,实现多项目上下文管理。

只读模式会不会影响我更新计划?

不会。只读模式仅在AI编码代理执行任务时保护计划不被意外修改。您可以通过特定命令或手动编辑文件来更新计划内容。

给 AI 助手的安装指引

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

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