创建计划并在上下文丢失后恢复
- 对 3+ 步或 5+ 工具调用的任务先创建三个规划文件
- 工作中将发现追加到 findings.md，将动作记录到 progress.md
- 阶段完成后在 task_plan.md 中勾选
- 上下文丢失（/clear、崩溃、压缩）后，钩子重新读取项目规划状态，新会话从当前阶段继续
OthmanAdi/planning-with-files
面向 AI 编程智能体的持久化文件规划技能，让计划在上下文丢失后仍可恢复
面向 AI 编程智能体的持久化文件规划技能，让计划在上下文丢失后仍可恢复
产品定位
planning-with-files 是一个 MIT 许可的开源智能体技能（Agent Skill），为 AI 编程智能体提供基于磁盘的持久化规划。它在本地维护 task_plan.md、findings.md 和 progress.md 三个文件，通过生命周期钩子注入规划上下文，使多步骤任务在 /clear、崩溃和上下文压缩后仍能从当前阶段继续。
适合用户
- AI 编程智能体用户
- Claude Code / Cursor / Codex 等编码工具开发者
- 长时间自主智能体任务运维者
功能亮点
持久化文件规划
在磁盘上维护 task_plan.md、findings.md、progress.md 三个 Markdown 文件，作为智能体的持久工作记忆。
会话恢复
通过生命周期钩子在 /clear、崩溃和上下文压缩后自动恢复规划状态，使新会话能从当前阶段继续。
确定性完成门
门控模式下的 Stop 完成门，仅当所有完成条件同时满足时才阻止停止，未完成的计划本身不会困住会话。
SHA-256 计划证明
用 SHA-256 锁定 task_plan.md，被篡改的计划主体在注入时会被拒绝。
跨智能体安装
通过 Agent Skills 标准支持 60+ 智能体，覆盖 Claude Code、Cursor、Codex、GitHub Copilot 等平台。
使用步骤
安装到编码智能体
- Claude Code：通过 /plugin marketplace add OthmanAdi/planning-with-files 安装插件
- 其他智能体：运行 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
- 或通过 npm install planning-with-files 固定版本，或 pi install npm:planning-with-files
适用场景
长时间智能体任务的进度持久化
AI 编程智能体用户
让多步骤任务、研究任务和跨多次工具调用的构建任务在 /clear 和压缩后仍可恢复。
跨 60+ 智能体的统一规划模式
编码工具开发者
在不同编码智能体（Claude Code、Cursor、Codex 等）间使用同一套文件规划模式。
访问与价格
可用状态: 当前可用
价格信息: 开源
支持平台: API, 自托管
价格说明: MIT 许可的开源项目，可从 npm、Claude Code 插件市场或 npx skills 免费安装。
官方入口
常见问题
planning-with-files 是什么？
一个面向 AI 编程智能体的持久化文件规划技能，在磁盘上维护 task_plan.md、findings.md 和 progress.md，通过生命周期钩子注入规划上下文，使计划在 /clear、崩溃和压缩后仍然保留。
如何安装？
Claude Code 可通过插件市场安装；其他智能体可用 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g；也可通过 npm install 或 pi install 安装。
它会读取我的本地会话记录吗？
自动恢复仅读取项目文件。读取同项目本地会话记录需要显式 catchup 模式：--metadata 仅输出聚合计数，--replay 输出有界摘录；两种模式都不包含网络请求或上传路径。
来源核验
资料核验于 2026-09-01