别再让 Claude Code 干到一半“失忆”了：planning-with-files 实测

别再让 Claude Code 干到一半“失忆”了

你有没有过这种体验：让 Claude Code 跑一个长任务，它前 20 分钟干得挺好，后来突然跑偏，问你“我们最初要做什么来着？”

这不是 Claude 变笨了，是它的上下文窗口被填满了。早先的目标、约束、临时决定，全被压缩、遗忘。

今天要聊的 planning-with-files，就是专门治这个问题的 Skill。它把 AI 的“记忆”从脆弱的上下文窗口，搬到稳定的文件系统里。

它到底是什么

planning-with-files 是一个给 Claude Code 用的持久化规划 Skill，作者是 OthmanAdi。核心思路来自 Meta 20 亿美元收购的 Manus 的上下文工程：让 AI 把任务计划、进度、研究发现，都写成 Markdown 文件存到磁盘上。

也就是说，AI 的“工作记忆”不再是聊天窗口里的浮云，而是真正落盘、可读写、可回溯的文件。

三文件工作流，简单但有效

这个 Skill 的精髓是 3 个核心文件：

• task_plan.md：任务拆解与阶段进度，像项目甘特图，让 AI 随时知道“现在该做什么”。
• findings.md：研究发现、技术判断、决策理由的沉淀池，避免重复探索。
• progress.md：执行日志、报错记录、测试结果，事后复盘直接翻这个文件。

这套组合拳，让 AI 在长任务里既不会目标漂移，也不会重复踩坑。

为什么值得装

这个 Skill 已经在 GitHub 上收获 上万 Star，社区 fork 和插件生态都很活跃。它不止支持 Claude Code，还兼容 Codex CLI、Cursor、Kiro、OpenCode 等 60+ Agent，覆盖了当前主流的 AI 编程终端。

如果你日常让 AI 跑的是“重构整个认证系统”“批量补全单测”“做一次完整代码审计”这类长任务，装完这个 Skill，相当于给 AI 配了个不会忘事的项目助理。

一句话总结

Claude Code 本身已经很强，但长任务里的上下文管理一直是个痛点。planning-with-files 用最朴素的“写文件”方式，把上下文工程落地成了可复用的 Skill。不花哨，但真能打。

GitHub 项目地址：https://github.com/OthmanAdi/planning-with-files

—

**GitHub:** https://github.com/OthmanAdi/planning-with-files