title: planning-with-files - 复刻 Manus 上下文工程的开源插件 date: 2026-02-02 tags:
- 技术学习
- Agent
- Claude-Code
- 上下文工程
- Manus
- 开源项目 status: learning source: 归档/Clippings/暴涨11.7k Star！复刻Manus上下文工程的开源Skills，Claude code等多个平台即插即用.md github: https://github.com/OthmanAdi/planning-with-files
planning-with-files - 复刻 Manus 上下文工程的开源插件
开源插件，复刻了 Manus 的上下文工程方法论——用磁盘文件代替上下文窗口做"工作记忆"，解决 AI 智能体失忆、迷航、重复犯错三大痛点。GitHub 11.7k+ Stars。
核心思想
任何重要信息都应写入磁盘，而非依赖易失且有限的上下文窗口。
LLM 上下文窗口 = 内存（易失、有限） 磁盘文件 = 硬盘（持久、无限）
三文件架构
| 文件 | 作用 | 更新时机 |
|---|---|---|
task_plan.md |
阶段划分、进度状态、错误记录 | 每个阶段完成后 |
findings.md |
调研结果、关键发现 | 查看/搜索/浏览操作后 |
progress.md |
会话日志、测试结果 | 整个过程中持续记录 |
六大原则
- 先计划后执行：复杂任务必须先有
task_plan.md - 及时写入发现：每 2 次查看/搜索/浏览后，立即写入
findings.md - 决策前回顾目标：关键决策前重新读取
task_plan.md - 阶段完成必更新：标记完成状态、记录错误和修改的文件
- 记录所有错误：持久化错误日志，避免重复踩坑
- 绝不重复失败：同一操作失败后换方案，记录尝试历史
安装
已通过 ~/.claude/skills/planning-with-files/ 安装。包含中文 SKILL.md、辅助脚本和模板文件。
也可在 Claude Code 内通过命令安装：
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
使用场景
- 多步骤任务（3 步以上）
- 研究型任务（信息收集、分析、整理）
- 涉及大量工具调用的复杂工作流
- 研究或开发，需要断点续做的场景
学习总结
Manus 的方法论本质是用工程约束弥补模型缺陷——不追求让 AI 更聪明，而是让它更可靠地执行流程。三个文件看似简单，但 hooks 机制在每次工具调用前后自动读/写计划文件，形成了"读→做→写→审"的执行闭环，这是真正有效的关键。
参考资源
- GitHub：https://github.com/OthmanAdi/planning-with-files
- 本地 Skill 位置：
~/.claude/skills/planning-with-files/