如何在 Pi 中安装 planning-with-files 扩展并用 /plan-execute 激活钩子【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files这篇文档面向使用 Pi Coding Agent 的开发者你需要把 planning-with-files 以「skill 扩展」的形式装进 Pi让它在长任务中持续提供计划上下文装好后计划默认处于被动评审状态只有你运行/plan-execute批准当前计划后扩展才会激活全部生命周期钩子。整个流程的依据来自仓库中的 Pi Agent 安装指南 与 README。安装扩展主路径是从 npm 安装pi install npm:planning-with-files这条命令一次安装两个东西Skillplanning-with-files3 文件计划工作流Extensionplanning-with-fileshook parity runtime把 Pi 的生命周期事件映射为 Claude Code 同等的钩子行为。安装完成后的验证与加载步骤pi list用pi list确认包已安装随后在 Pi 会话内重新加载运行时/reload如果命令仍不可用按文档检查两处路径是否存在skill.pi/skills/planning-with-files/extensionextensions/planning-with-files/index.ts可选分支从仓库手动安装文档给出的手动安装方式是克隆仓库后把 skill 包复制进你的 Pi skills 目录# Clone repo git clone https://github.com/OthmanAdi/planning-with-files.git cd planning-with-files # Copy skill package into your Pi skills directory mkdir -p ~/.pi/agent/skills/planning-with-files cp -r .pi/skills/planning-with-files/* ~/.pi/agent/skills/planning-with-files/副作用说明该分支会克隆仓库到你当前目录并写入~/.pi/agent/skills/下的文件仅当你无法使用 npm 通道时才需要走这条路径。配置注入模式可选扩展有四种模式影响计划上下文如何注入对话模式行为auto默认DeepSeek 模型 -cache-safe其他模型 -parityparity最大 Claude 等效行为动态计划注入cache-safe固定的稳定提醒提升 DeepSeek KV-cache 命中率notify只做 UI 通知不注入对话两种配置方式PWF_MODEauto pi PWF_MODEparity pi PWF_MODEcache-safe pi PWF_MODEnotify pi或在 settings 中配置项目级.pi/settings.json覆盖全局~/.pi/agent/settings.json{ planningWithFiles: { mode: auto } }默认auto即可满足大多数场景使用 DeepSeek 且关心缓存命中率时才需要显式指定。创建计划并进入被动评审安装后在 Pi 中先启动 skill/skill:planning-with-files然后让 Pi 创建/更新三个文件task_plan.mdfindings.mdprogress.md注意 Pi 上没有/plan命令来创建这些文件——由 skill 负责创建/plan-execute只负责批准这是 README 中「Pi extension commands」一节明确的差异。此时扩展保持被动可以显示计划状态但不会注入计划上下文、不会在工具调用前复述计划也不会自动继续。评审并编辑计划直到内容符合你的意图。用 /plan-execute 激活钩子计划就绪后运行/plan-execute该命令批准当前激活的计划并启用钩子激活Pi 特有命令无/planning-with-files:前缀。激活后扩展在以下生命周期事件上生效session_start会话恢复session catchupbefore_agent_start计划上下文提醒/注入tool_call工具调用前的计划复述pre-tool recitation 等效行为tool_result写入/编辑输出后的 post-write 提醒agent_end未完成计划的自动继续保护限制 3 次session_before_compact压缩前的计划提醒计划证明保护检测到篡改的计划会得到[PLAN TAMPERED — injection blocked]。对长任务把task_plan.md当作唯一事实来源由激活后的钩子/扩展事件执行循环。如果不想再执行当前计划用下面命令回到被动评审模式/plan-execute reset结果验证与排查按文档的 Troubleshooting 顺序判断安装是否到位确认包已安装pi list重载运行时/reload检查 skill 与 extension 路径见安装一节列出的两个路径。如果计划注入被拦截出现计划被篡改拦截先查看当前证明状态再对有意修改过的计划重新证明/plan-attest --show/plan-attest证明使用 SHA-256 锁定task_plan.md且与 Claude Code 共享同一个.attestation文件——证明一次即可同时锁定两个运行时。安装后还会注册这些扩展命令可在会话内直接输入无插件前缀/plan-status— 显示当前计划计数与路径/plan-attest [--show|--clear]— 管理计划 SHA-256 证明/plan-execute//plan-execute reset— 批准激活 / 回到被动评审/plan-goal text|default|clear— 设置/清除继续目标文本/plan-loop [10m] [prompt...]— 周期性计划 tick用stop取消边界说明钩子激活前扩展只展示被动状态所有注入与自动继续行为都以运行/plan-execute为前提。agent_end的自动继续每个会话计划最多 3 次不会无限续跑。TypeScript 扩展运行时只在 Pi 进程加载时运行仓库没有针对 Pi 扩展运行时的 CI 测试见 CHANGELOG v2.39.0 相关说明遇到 Pi 上的行为回归问题应指向.pi/skills/planning-with-files/extensions/目录。更多细节模式选择、事件映射、证明机制可继续查阅 docs/pi-agent.md。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
