pi-plan-build
pi CLI 的只读计划与完整构建模式切换工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-plan-build。 它的用途是：pi CLI 的只读计划与完整构建模式切换工具 完整的 Skill 内容见：https://321skill.com/skills/pi-plan-build/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我想用 pi 部署项目，但不确定命令会做什么，帮我先预览一下。’ 它会引导你或建议你使用 `pi-plan-build` 切换到 Plan 模式运行命令，列出所有将要进行的操作。确认无误后，再切换回 Build 模式执行实际部署。
介绍
该 Skill 解决了开发者在执行 pi CLI 命令时，需要在安全预览模式与完整执行模式之间快速切换的需求。它允许用户在执行可能产生实际变更的命令前，先进入只读的“Plan”模式预览将要执行的操作，确认无误后再切换到“Build”模式执行完整构建，从而避免误操作。
使用方式非常简单，通过 npm 安装后，即可在 pi CLI 环境中使用相应的命令来切换模式。例如，在计划模式下，命令会模拟运行并输出变更摘要，而不会实际修改文件或系统状态；切换到构建模式后，相同的命令则会实际执行所有操作。
它非常适合使用 pi CLI 进行项目构建、部署或自动化脚本的开发者，尤其是那些希望对关键操作进行二次确认、追求流程可控性的用户。在团队协作或生产环境中，这能有效减少因命令误执行导致的事故。
建议在尝试新命令或对现有工作流进行修改前，先使用 Plan 模式进行验证。需要注意的是，该工具仅控制 pi CLI 命令本身的执行模式，不保证所有第三方插件或脚本都完全遵循只读约定，在关键操作上仍需保持谨慎。
核心特点
该 Skill 专为 pi CLI 设计，提供了类似 Terraform `plan` 的原生模式切换功能，而非通用的安全执行包装器；它直接集成到 pi CLI 的命令执行流程中，切换更轻量、无感知。
注意事项
仅适用于 pi CLI 生态内的命令，对于其他命令行工具或未适配此模式的 pi 插件可能无效。
常见问题
pi-plan-build 是做什么的？
它是一个为 pi CLI 提供只读预览（Plan）和实际执行（Build）模式切换的工具。
Plan 模式真的不会修改任何文件吗？
在理想情况下，是的。但具体取决于命令和插件的实现，建议先在不重要的任务上测试。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-plan-build/raw/index.md 读取 pi-plan-build 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-plan-build/raw/index.md（查看排版版本）