无论是Claude Code还是市面上大多数AI智能体，都逃不开这些核心痛点：
上下文一重置，工具任务状态直接消失；
执行 50 多次工具调用后，原始目标被遗忘；
失败不被记录，系统在同一个坑里跌倒无数次；
所有内容都硬塞进上下文，而非持久化存储。
而智能体Manus凭着一套上下文工程（Context Engineering），精准破解了上述AI智能体的核心痛点，最终以20亿美元估值被Meta重磅收购，用实力印证了这套方法论的巨大价值。
Manus核心原则是：任何重要信息都应写入磁盘，而非依赖易失且有限的上下文窗口。Manus 使用 Markdown 作为磁盘上的“工作记忆”，这些文件充当笔记的草稿纸、进度的检查点，以及最终交付成果的构建模块。
今天要给大家介绍一个Agent Skills开源项目planning-with-files，它完整复刻了Manus使用Markdown文件进行任务规划、进度追踪和知识存储能力，让 AI 智能体真正具备“记忆”与“反思”能力，告别目标漂移与重复犯错。该项目在github上已收获 11.7k stars。
项目地址：
https://github.com/OthmanAdi/planning-with-files
01
项目介绍
planning-with-files 是一款专为 Claude Code 等 AI 编程智能体设计的开源插件，旨在将 Manus 中基于文件的复杂任务规划能力无缝融入日常开发与工作流。它特别适用于多步骤任务、研究型任务、软件构建或内容创作任务、涉及大量工具调用的自动化流程等复杂工作。
在执行任何复杂任务前，需要创建以下三个文件：
task_plan.md：负责跟踪任务阶段与进度。
findings.md：专门存储调研结果与关键发现。
progress.md ：记录会话日志与测试结果。
智能体的任务执行遵循以下六大原则：
（1）先制定计划，绝不在没有 task_plan.md 的情况下启动任何复杂任务。
（2）每完成两次查看、浏览或搜索操作后，立即将关键发现写入文本文件，防止多模态信息丢失。
（3）做出关键决策前，先阅读 task_plan.md 文件，将目标重新拉入注意力窗口。
（4）每个任务阶段完成后，必须同步更新 task_plan.md 文件：将阶段状态从 in_progress 改为 complete、记录所有遇到的错误、注明新增或修改的文件。
（5）将所有错误信息写进计划文件，构建智能体的经验库避免重复踩坑。格式如下：
## Errors Encountered| Error | Attempt | Resolution ||-------|---------|------------|| FileNotFoundError | 1 | Created default config || API timeout | 2 | Added retry logic |
（6）绝不重蹈覆辙：一旦某操作失败，处理方法如下：
第1次尝试：诊断并修复→ 仔细阅读错误信息→ 定位根本原因→ 应用针对性修复第2次尝试：更换方法→ 仍出现相同错误？尝试不同方案→ 换用其他工具？改用其他库？→ 绝不再次执行完全相同的失败操作第3次尝试：全局反思→ 质疑原有假设→ 主动搜索解决方案→ 考虑更新整体任务计划3次均失败后：向用户求助→ 清晰说明已尝试的方法→ 提供具体的错误信息→ 请求进一步指导
02
使用方法
planning-with-files 不仅兼容多款 AI智能体工具，更针对各平台特性实现了深度集成，确保上下文工程能力在各类环境中稳定运行。
（1）在 Claude Code 中自动安装
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files
（2） 手动安装
将本仓库克隆或复制到项目中的 .claude/plugins/ 目录。
选项 A：直接克隆到插件目录
mkdir -p .claude/pluginsgit clone https://github.com/OthmanAdi/planning-with-files.git .claude/plugins/planning-with-files
选项 B：作为 Git 子模块添加
git submodule add https://github.com/OthmanAdi/planning-with-files.git .claude/plugins/planning-with-files
git clone https://github.com/OthmanAdi/planning-with-files.gitclaude --plugin-dir ./planning-with-files
安装完成后，请验证该 Skill 是否已成功加载：
启动一个新的 Claude Code 会话，看到以下提示：
[planning-with-files] Ready. Auto-activates for complex tasks, or invoke manually with /planning-with-files
也可以手动输入 /planning-with-files 来显式调用该插件。
03
总结
planning-with-files 完整复刻了 Manus 那套直击 AI 智能体“失忆、迷航、重复犯错”三大痛点的上下文工程方案，并已深度适配 Claude Code、Cursor、OpenCode等十余款主流 AI 编程环境，为未来构建持久化、可追溯、可进化的智能体奠定了坚实的基础。
END
