name: 基于文件的规划 description: 实现Manus风格的基于文件的复杂任务规划。创建task_plan.md、findings.md和progress.md。用于开始复杂多步骤任务、研究项目或任何需要超过5个工具调用的任务。 license: MIT

基于文件的规划

像Manus一样工作：使用持久的Markdown文件作为你的“磁盘上的工作内存”。

核心原则

Context Window = RAM（易失性，有限）
Filesystem = Disk（持久性，无限）

→ 任何重要的内容都写入磁盘。

快速开始

在任何复杂任务之前，创建这三个文件：

task_plan.md — 跟踪阶段和进度
findings.md — 存储研究和发现
progress.md — 会话日志和测试结果

查看references/以获取起始模板。

文件用途

文件	用途	何时更新
`task_plan.md`	阶段、进度、决策	每个阶段后
`findings.md`	研究、发现	任何发现后
`progress.md`	会话日志、测试结果	会话期间

关键规则

1. 首先创建计划

绝不要在没有task_plan.md的情况下开始复杂任务。不容协商。

2. 两动作规则

“每进行两次查看/浏览/搜索操作后，立即将关键发现保存到文本文件。”

这防止视觉/多模态信息丢失。

3. 决定前阅读

在重大决策前，阅读计划文件。这保持目标在你的注意力窗口。

4. 行动后更新

完成任何阶段后：

标记阶段状态：in_progress → complete
记录遇到的任何错误
注意创建/修改的文件

5. 记录所有错误

每个错误都记录在计划文件中。这建立知识并防止重复。

6. 永不重复失败

if action_failed:
    next_action != same_action

跟踪你尝试的。改变方法。

三击错误协议

ATTEMPT 1: 诊断与修复
  → 仔细阅读错误
  → 识别根本原因
  → 应用针对性修复

ATTEMPT 2: 替代方法
  → 同样的错误？尝试不同的方法
  → 不同的工具？不同的库？
  → 永远不要重复完全相同的失败操作

ATTEMPT 3: 更广泛的重新思考
  → 质疑假设
  → 搜索解决方案
  → 考虑更新计划

AFTER 3 FAILURES: 上报给用户
  → 解释你尝试了什么
  → 分享具体的错误
  → 请求指导

何时使用此模式

用于:

多步骤任务（3步以上）
研究任务
构建/创建项目
跨越多个工具调用的任务

跳过:

简单问题
单文件编辑
快速查找

模板

references/task_plan.md — 阶段跟踪模板
references/findings.md — 研究存储模板
references/progress.md — 会话日志模板

高级主题

Manus原则： 查看references.md以获取完整的上下文工程模式
真实示例： 查看examples.md以获取实际实现

反模式

不要	取而代之
陈述一次目标就忘记	在决策前重新阅读计划
隐藏错误并静默重试	记录错误到计划文件
把所有东西塞进上下文	将大内容存储在文件中
立即开始执行	首先创建计划文件
重复失败的操作	跟踪尝试，改变方法

此模式是Manus在8个月内从启动到被20亿美元收购的原因。