planning-with-files

在任何复杂任务之前：

1. 在工作目录中创建 task_plan.md
2. 定义阶段，使用复选框
3. 每个阶段后更新 - 标记 [x] 并更改状态
4. 决策前读取 - 刷新注意力窗口中的目标

对于每个非平凡任务，创建三个文件：

| 文件 | 用途 | 更新时机 |

|------|---------|----------------|

| task_plan.md | 跟踪阶段和进度 | 每个阶段后 |

| notes.md | 存储发现和研究 | 研究过程中 |

| [deliverable].md | 最终输出 | 完成时 |

```

循环 1：创建包含目标和阶段的 task_plan.md

循环 2：研究 → 保存到 notes.md → 更新 task_plan.md

循环 3：读取 notes.md → 创建交付物 → 更新 task_plan.md

循环 4：交付最终输出

```

详细循环说明

每次主要操作前：

```bash

Read task_plan.md # 刷新注意力窗口中的目标

```

每个阶段后：

```bash

Edit task_plan.md # 标记 [x]，更新状态

```

存储信息时：

```bash

Write notes.md # 不要塞满上下文，存储到文件中

```

对于任何复杂任务，首先创建此文件：

```markdown

# 任务计划：[简要描述]

[一句话描述最终状态]

• [ ] 阶段 1：规划和设置
• [ ] 阶段 2：研究/收集信息
• [ ] 阶段 3：执行/构建
• [ ] 阶段 4：审查和交付

1. [需要回答的问题]
2. [需要回答的问题]

• [决策]：[理由]

• [错误]：[解决方案]

当前处于阶段 X - [我现在正在做的事情]

```

用于研究和发现：

```markdown

# 笔记：[主题]

来源 1：[名称]

• URL：[链接]
• 关键点：

- [发现]

- [发现]

[类别]

• [发现]
• [发现]

```

1. 始终先创建计划

在没有 task_plan.md 的情况下永远不要开始复杂任务。这是不可协商的。

2. 决策前先读取

在任何重大决策之前，读取计划文件。这可以将目标保持在你的注意力窗口中。

3. 行动后更新

完成任何阶段后，立即更新计划文件：

• 用 [x] 标记已完成的阶段
• 更新状态部分
• 记录遇到的任何错误

4. 存储，不要塞满

大型输出放入文件，而不是上下文。在工作记忆中只保留路径。

5. 记录所有错误

每个错误都进入"遇到的错误"部分。这为未来的任务积累知识。

对以下情况使用三文件模式：

• 多步骤任务（3+ 步骤）
• 研究任务
• 构建/创建某物
• 跨多个工具调用的任务
• 任何需要组织的事情

以下情况跳过：

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

| 不要做 | 而是做 |

|-------|------------|

| 使用 TodoWrite 进行持久化 | 创建 task_plan.md 文件 |

| 陈述一次目标就忘记 | 每次决策前重新读取计划 |

| 隐藏错误并重试 | 将错误记录到计划文件 |

| 将所有内容塞入上下文 | 将大型内容存储到文件中 |

| 立即开始执行 | 首先创建计划文件 |

参见 [reference.md](reference.md) 了解：

• 注意力操作技巧
• 错误恢复模式
• 来自 Manus 的上下文优化

参见 [examples.md](examples.md) 了解：

• 真实任务示例
• 复杂工作流模式