智猩猩AI整理

编辑：没方

无论是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智能体工具，更针对各平台特性实现了深度集成，确保上下文工程能力在各类环境中稳定运行。

IDE

Status

Format

（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/plugins

git 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

选项 C：使用 --plugin-dir 参数

git clone https://github.com/OthmanAdi/planning-with-files.git

claude --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 编程环境，为未来构建持久化、可追溯、可进化的智能体奠定了坚实的基础。