---
name: planning-with-files
description: 将工作流转换为使用 Manus 风格的持久化 markdown 文件进行规划、进度跟踪和知识存储。适用于开始复杂任务、多步骤项目、研究任务，或者当用户提到规划、组织工作、跟踪进度或需要结构化输出时使用。
---

# 使用文件进行规划

像 Manus 一样工作：使用持久化的 markdown 文件作为你的"磁盘工作记忆"。

## 快速开始

在任何复杂任务之前：

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     # 不要塞满上下文，存储到文件中
```

## task_plan.md 模板

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

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

## 目标
[一句话描述最终状态]

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

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

## 已做出的决策
- [决策]：[理由]

## 遇到的错误
- [错误]：[解决方案]

## 状态
**当前处于阶段 X** - [我现在正在做的事情]
```

## notes.md 模板

用于研究和发现：

```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) 了解：
- 真实任务示例
- 复杂工作流模式