planning-with-files

文件规划

像 Manus 一样工作：将持久化的 Markdown 文件用作磁盘上的工作记忆。

这不仅是一种可选的规划方式。对于复杂的 Codex 工作，它应当成为默认的持久化层。

遇到以下情况时，请主动使用：

• 任务可能需要多次工具调用才能完成
• 需要跨阶段跟踪进度
• 工作过程中需要保留发现或证据
• 任务可能会分支、暂停或稍后恢复
• 仅依赖聊天上下文会不可靠

快速开始

开始任何复杂任务之前：

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

三文件模式

对于每项非简单任务，都创建三个文件：

文件	用途	更新时机
task_plan.md	跟踪阶段和进度	每完成一个阶段后
notes.md	存储发现和研究结果	研究期间
[deliverable].md	最终输出	完成时

核心工作流

Loop 1: Create task_plan.md with goal and phases
Loop 2: Research → save to notes.md → update task_plan.md
Loop 3: Read notes.md → create deliverable → update task_plan.md
Loop 4: Deliver final output

循环详解

每次重大操作之前：

Read task_plan.md  # Refresh goals in attention window

每个阶段之后：

Edit task_plan.md  # Mark [x], update status

存储信息时：

Write notes.md     # Don't stuff context, store in file

task_plan.md 模板

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

# Task Plan: [Brief Description]

## Goal
[One sentence describing the end state]

## Phases
- [ ] Phase 1: Plan and setup
- [ ] Phase 2: Research/gather information
- [ ] Phase 3: Execute/build
- [ ] Phase 4: Review and deliver

## Key Questions
1. [Question to answer]
2. [Question to answer]

## Decisions Made
- [Decision]: [Rationale]

## Errors Encountered
- [Error]: [Resolution]

## Status
**Currently in Phase X** - [What I'm doing now]

notes.md 模板

用于研究和记录发现：

# Notes: [Topic]

## Sources

### Source 1: [Name]
- URL: [link]
- Key points:
  - [Finding]
  - [Finding]

## Synthesized Findings

### [Category]
- [Finding]
- [Finding]

关键规则

1. 始终先创建计划

没有 task_plan.md，绝不开始复杂任务。这是不可妥协的要求。

2. 决策前先阅读

进行任何重大决策之前，先阅读计划文件。这样可以让目标保持在注意力窗口中。

3. 行动后更新

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

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

4. 存储，而非塞满上下文

大量输出应存入文件，而不是上下文。工作记忆中只保留路径。

5. 记录所有错误

将每个错误都记录在“遇到的错误”部分。这能为未来的任务积累经验。

何时使用此模式

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

• 多步骤任务（3 步以上）
• 研究任务
• 构建或创建某项内容
• 需要多次工具调用的任务
• 任何需要组织规划的任务

以下情况跳过：

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

应避免的反模式

不要这样做	应这样做
使用 TodoWrite 实现持久化	创建 task_plan.md 文件
只陈述一次目标，然后置之不理	每次决策前重新阅读计划
隐瞒错误并重试	将错误记录到计划文件
将所有内容塞进上下文	将大量内容存入文件
立即开始执行	先创建计划文件

高级模式

参见 reference.md，了解：

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

参见 examples.md，了解：

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