用途
planning-with-files 实现了一种 Manus 风格、基于文件的规划方式，用于组织并跟踪复杂任务的进度。它的核心理念是：把持久化的 Markdown 文件当作“磁盘上的工作记忆”。
其核心原则是：
- 上下文窗口 = RAM（易失、有限）
- 文件系统 = 磁盘（持久、无限）
因此，任何重要的内容都应写入磁盘。
主要能力
该方法要求在开始任何复杂任务之前创建三个文件：
- task_plan.md —— 跟踪阶段与进度
- findings.md —— 存储研究与发现
- progress.md —— 会话日志与测试结果
各文件的用途与更新时机如下：
| 文件 | 用途 | 更新时机 |
|---|---|---|
| task_plan.md | 阶段、进度、决策 | 每个阶段之后 |
| findings.md | 研究、发现 | 任何发现之后 |
| progress.md | 会话日志、测试结果 | 整个会话过程中 |
起始模板可参见 references/ 目录。
使用方式：关键规则
- 先创建计划
绝不在没有 task_plan.md 的情况下开始复杂任务。这是不可协商的。
- 两动作规则
“每进行 2 次查看/浏览器/搜索操作后，立即将关键发现保存到文本文件中。”这可以防止视觉/多模态信息丢失。
- 决策前先阅读
在做出重大决策之前，先阅读计划文件。这能让目标保持在你的注意力窗口内。
- 行动后更新
完成任何阶段后：
- 标记阶段状态：in_progress → complete
- 记录遇到的任何错误
- 注明创建/修改的文件
- 记录所有错误
每个错误都写入计划文件。这能积累知识并防止重复。
- 绝不重复失败
if action_failed:
next_action != same_action
跟踪你尝试过的内容，改变方法。
三振出局错误协议
ATTEMPT 1: Diagnose & Fix
→ Read error carefully
→ Identify root cause
→ Apply targeted fix
ATTEMPT 2: Alternative Approach
→ Same error? Try different method
→ Different tool? Different library?
→ NEVER repeat exact same failing action
ATTEMPT 3: Broader Rethink
→ Question assumptions
→ Search for solutions
→ Consider updating the plan
AFTER 3 FAILURES: Escalate to User
→ Explain what you tried
→ Share the specific error
→ Ask for guidance
适用场景
适用于：
- 多步骤任务（3 步以上）
- 研究任务
- 构建/创建项目
- 跨越多次工具调用的任务
可跳过：
- 简单问题
- 单文件编辑
- 快速查询
模板
- references/task_plan.md —— 阶段跟踪模板
- references/findings.md —— 研究存储模板
- references/progress.md —— 会话日志模板
进阶主题
- Manus 原则：完整上下文工程模式参见 references.md
- 真实示例：实际实现参见 examples.md
反模式
| 不要 | 而应 |
|---|---|
| 只陈述一次目标就忘记 | 决策前重读计划 |
| 隐藏错误并静默重试 | 将错误记录到计划文件 |
| 把所有内容塞进上下文 | 将大段内容存入文件 |
| 立即开始执行 | 先创建计划文件 |
| 重复失败的动作 | 跟踪尝试，改变方法 |
限制
资料未提供该方法的收费、价格、平台支持范围或具体效果数据，这些信息暂未提供。