用AI写代码有个头疼的问题：上下文一长，它就忘了之前在干啥。你让它实现功能A，它做到一半跑去改B，最后A没做完，B还改出了新bug。

最近发现一个工具叫 planning-with-files，专门解决这个问题。

问题在哪？

AI编程代理有几个通病：

• 记性差 — 上下文满了或你运行/clear，之前的任务全忘
• 目标漂移 — 调用50+工具后，原始目标早忘了
• 错误重复 — 失败了不记录，下次又犯同样错误
• 上下文堆砌 — 什么都塞进context，不往磁盘写

这个工具做什么

planning-with-files用3个文件记录任务状态：

task_plan.md   → 任务阶段和进度
findings.md    → 研究发现和结论
progress.md    → 会话日志和测试结果

上下文窗口相当于内存，用完就没了。文件系统相当于磁盘，一直都在。重要的东西写到磁盘上，上下文清空也不怕。

来自Manus的经验

这个模式来自Manus。Meta在2025年12月以20亿美元收购了它。

Manus的核心思路：

“Markdown是我的磁盘工作记忆。我迭代处理信息，活动上下文有限，Markdown文件充当笔记、进度检查点和最终交付物。”

现在这个经验被做成了可安装的技能包。

下载使用

工具已打包上传，永久有效：

百度网盘：
https://pan.baidu.com/s/1Ip5068YyOZKqM6N07hLf7g?pwd=38w7

提取码：38w7

使用步骤：

1. 点击链接或复制到浏览器
2. 输入提取码 38w7
3. 点击"保存到网盘"或直接下载
4. 解压得到 planning-with-files 文件夹
5. 放到你的AI工具skills目录（如 ~/.claude/skills/ 或 ~/.cursor/skills/）
6. 重启AI工具即可生效

支持Claude Code、Cursor、GitHub Copilot等18+个IDE和平台。

核心规则

1. 先建计划 — 没有task_plan.md不开始
2. 2操作保存 — 每看2个文件/网页就保存发现
3. 记录所有错误 — 避免重复失败
4. 尝试后变通 — 不走死路

效果怎么样

基准测试：

• 通过率96.7%（有工具）vs 6.7%（无工具）
• 3文件模式遵循：5/5（有）vs 0/5（无）
• A/B盲测胜率：3/3（100%）

长任务确实不会跑偏了，错误也有记录可查。

最后说两句

AI代理的最大问题不是能力不够，而是记不住自己在干什么。planning-with-files把任务状态写到磁盘上，让代理有了"持久记忆"。

复杂任务不再怕上下文爆炸，跑偏了也能找回来。