Claude Code失忆这事，用过的人都懂。好不容易让它理解了项目需求，一个
/clear下去，它忘了你是谁、要做什么、做到哪一步了。planning-with-files的思路很简单：把计划、发现、进度实时写入三个Markdown文件。不管清多少次上下文、开多少个新会话，只要读回这三个文件，Agent就能恢复状态------相当于给 Claude Code装了个持久化的"外置大脑"，今天给大家分享下它的使用！
简介
planning-with-files是一个基于持久化文件（Markdown）的AI编程代理规划技能（Skill），目前在Github上已有25k+star。主要解决AI编程代理上下文窗口"失忆"问题------把任务计划、发现和进度持久化到磁盘的Markdown文件上，确保即使发生/clear、崩溃或上下文重置，代理也能从磁盘恢复状态、不丢失目标。
它的核心能力如下：
- 崩溃安全：计划文件存于磁盘，/clear、上下文丢失、崩溃后自动恢复。
- 完成门控（Gated Mode）：v3.0 新增，在所有阶段真正完成前阻止代理停止。
- 自主模式（Autonomous Mode）：减少每次工具调用的计划重读开销，适合长运行任务。
- SHA-256计划认证：锁定 task_plan.md，防止计划被篡改。
- 多代理共享状态：多个代理可通过磁盘文件共享执行状态。
- 多语言支持：英语、德语、西班牙语、阿拉伯语、简体中文、繁体中文。
安装
这里以Claude Code为例，介绍下planning-with-files的安装。
- 在Claude Code中使用
/plugin来安装planning-with-files非常方便，输入如下命令安装即可；
bash
# 添加planning-with-files的插件源
/plugin marketplace add OthmanAdi/planning-with-files
# 安装planning-with-files插件
/plugin install planning-with-files@planning-with-files- 安装完成后使用如下命令重启插件才能生效；
bash
/reload-plugins- 生效后在Claude Code中输入
/planning-with-files将会提示如下命令；
- 这些命令的具体作用如下：
这或许是一个对你有用的开源项目，mall项目是一套基于 SpringBoot3 + Vue3 的电商系统（Github标星60K），后端支持多模块和微服务架构，采用Docker和K8S部署。包括前台商城项目和后台管理系统，能支持完整的订单流程！涵盖商品、订单、购物车、权限、优惠券、会员、支付等功能！
- Boot项目：github.com/macrozheng/...
- Cloud项目：github.com/macrozheng/...
- 文档网站：www.macrozheng.com
项目演示：
使用
这里以开发基于Spring Boot的URL短链接服务为例，介绍下planning-with-files的使用。
- 使用如下命令启用中文规划，将会创建task_plan.md、findings.md和process.md三个文件；
bash
/planning-with-files:planning-with-files-zh- 这三个文件的具体作用可以参考下图；
- 接下来输入提示词开发项目，例如：
我想构建一个基于Spring Boot实现一个URL短链接服务，要带UI界面，Claude Code将更新三个规划文件；
- Claude Code将根据task_plan.md中定义好的阶段来工作，例如我们刚刚完成了阶段1：需求与探索；
- 在开发过程中，Claude Code将实时更新task_plan.md中各个阶段的完成状态，还会记录关键问题、已做决策和项目文件清单等信息；
- 在process.md文件中，包含了项目开发各个阶段的进度和测试结果；
- 在findings.md文件中，将会记录开发过程中的研究和发现、技术决策和资源等内容；
- 最终开发完成后Claude Code将会输出一个功能清单；
- 最终开发完成的项目效果如下；
- 不管你是
/clear当前会话，还是新建一个会话，使用/planning-with-files:planning-with-files-zh命令都能恢复之前的上下文。
总结
planning-with-files的思路并不复杂：用三个Markdown文件把Agent的计划、发现和进度持久化到磁盘上，/clear之后不再是白纸一张。
实际用下来，最实用的是跨会话恢复------今天写到一半，明天打开继续，它还记得做到哪一步了。一条命令安装，GitHub25k star，值得一试。