@alexeiled/pi-plan-exec
在Pi中可靠执行并恢复Markdown计划
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alexeiled/pi-plan-exec。 它的用途是：在Pi中可靠执行并恢复Markdown计划 完整的 Skill 内容见：https://321skill.com/skills/alexeiled-pi-plan-exec/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用pi-plan-exec执行项目文档中的开发计划docs/plans/add-login.md'，它会自动安装依赖、创建隔离工作树，然后逐条执行计划中的任务，每完成一项检查复选框，并在完成后执行审查和修复阶段。如果中途中断，重新加载后会自动恢复执行。
介绍
这个Skill解决了长时间运行AI实现过程中的控制问题。在实际开发中，AI代理容易丢失上下文、重复执行已完成任务、跳过验证步骤，或在重启后出现写者冲突。pi-plan-exec将任务顺序、重试次数、工作树检查和恢复逻辑从提示词中抽离，交给持久化的控制器状态，确保计划执行可追溯、可中断恢复。
使用方式很简单，你需要先安装依赖包（pi-subagents、pi-tasks、pi-bridge、pi-fusion），然后通过/exec命令执行Markdown格式的执行计划。Skill会自动选择第一个未完成的任务，在隔离的Git工作树中启动新的工作代理，完成后检查复选框状态。如果中断，重新加载Pi时会自动附加到正在运行的执行，或通过/exec adopt接管其他会话的陈旧运行。
它非常适合需要长期、多步骤、可审查的AI编码任务的团队或个人。尤其是那些已经在使用Pi浏览器开发复杂功能、需要跨会话保持执行上下文的场景。无论是AI应用开发、代码重构还是多模块集成，都能从中获得稳定的执行保障。
建议在初次使用时选择可审查的工作树环境，避免直接修改主分支。需要注意的是，它依赖Pi子代理、Bridge和Fusion等扩展，如果这些组件不可用，/exec会提示你如何恢复。另外，节点版本需≥22.19.0，且运行环境需要Git仓库。
常见问题
执行中断后如何恢复？
重新加载Pi后，`/exec`会自动附加到匹配的运行；如果跨会话，则使用`/exec adopt`接管。控制器会通过锁和租约防止重复启动。
/exec 命令需要哪些前置条件？
必须在Git仓库中运行，且已安装所有依赖包。执行前需先`/reload`刷新Pi。你可以用`/exec help`查看完整帮助。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alexeiled-pi-plan-exec/raw/index.md 读取 @alexeiled/pi-plan-exec 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alexeiled-pi-plan-exec/raw/index.md（查看排版版本）