| name | planning-with-files |
| description | 将工作流转换为使用 Evan 风格的持久化 markdown 文件进行规划、进度跟踪和知识存储。适用于开始复杂任务、多步骤项目、研究任务，或者当用户提到规划、组织工作、跟踪进度或需要结构化输出时使用。 |
使用文件进行规划
像 Evan 一样工作：使用持久化的 markdown 文件作为你的"磁盘工作记忆"。
快速开始
在任何复杂任务之前：
- 使用 AskUser 明确需求 - 达到 95% 确定性再继续
- 在工作目录中创建
task_plan.md
- 定义阶段，使用复选框
- 每个阶段后更新 - 标记 [x] 并更改状态
- 决策前读取 - 刷新注意力窗口中的目标
三文件模式
对于每个非平凡任务，创建三个文件：
| 文件 | 用途 | 更新时机 |
|---|
task_plan.md | 跟踪阶段和进度 | 每个阶段后 |
notes.md | 存储发现和研究 | 研究过程中 |
[deliverable].md | 最终输出 | 完成时 |
核心工作流
循环 0：使用 AskUser 明确需求细节（达到 95% 确定性）
循环 1：创建包含目标和阶段的 task_plan.md
循环 2：研究 → 保存到 notes.md → 更新 task_plan.md
循环 3：读取 notes.md → 创建交付物 → 更新 task_plan.md
循环 4：交付最终输出
详细循环说明
循环 0：明确需求（开始任何任务前）
AskUser
提问重点：
- 具体要交付什么？
- 有什么约束条件（技术栈、时间、资源）？
- 有什么参考或示例？
- 优先级和取舍是什么？
- 验收标准是什么？
判断标准： 只有当你认为有 95% 的把握可以完成任务时，才进入循环 1。
每次主要操作前：
Read task_plan.md
每个阶段后：
Edit task_plan.md
存储信息时：
Write notes.md
task_plan.md 模板
对于任何复杂任务，首先创建此文件：
# 任务计划：[简要描述]
## 目标
[一句话描述最终状态]
## 阶段
- [ ] 阶段 1：规划和设置
- [ ] 阶段 2：研究/收集信息
- [ ] 阶段 3：执行/构建
- [ ] 阶段 4：审查和交付
## 关键问题
1. [需要回答的问题]
2. [需要回答的问题]
## 已做出的决策
- [决策]：[理由]
## 遇到的错误
- [错误]：[解决方案]
## 状态
**当前处于阶段 X** - [我现在正在做的事情]
notes.md 模板
用于研究和发现：
# 笔记：[主题]
## 来源
### 来源 1：[名称]
- URL：[链接]
- 关键点：
- [发现]
- [发现]
## 综合发现
### [类别]
- [发现]
- [发现]
关键规则
0. 先明确，再动手
在开始任何任务前，使用 AskUser 工具明确需求细节。只有达到 95% 确定性后才能进入计划阶段。
1. 始终先创建计划
在没有 task_plan.md 的情况下永远不要开始复杂任务。这是不可协商的。
2. 决策前先读取
在任何重大决策之前，读取计划文件。这可以将目标保持在你的注意力窗口中。
3. 行动后更新
完成任何阶段后，立即更新计划文件：
- 用 [x] 标记已完成的阶段
- 更新状态部分
- 记录遇到的任何错误
4. 存储，不要塞满
大型输出放入文件，而不是上下文。在工作记忆中只保留路径。
5. 记录所有错误
每个错误都进入"遇到的错误"部分。这为未来的任务积累知识。
何时使用此模式
对以下情况使用三文件模式：
- 多步骤任务（3+ 步骤）
- 研究任务
- 构建/创建某物
- 跨多个工具调用的任务
- 任何需要组织的事情
以下情况跳过：
避免的反模式
| 不要做 | 而是做 |
|---|
| 猜测需求或假设理解 | 使用 AskUser 明确需求到 95% 确定性 |
| 使用 TodoWrite 进行持久化 | 创建 task_plan.md 文件 |
| 陈述一次目标就忘记 | 每次决策前重新读取计划 |
| 隐藏错误并重试 | 将错误记录到计划文件 |
| 将所有内容塞入上下文 | 将大型内容存储到文件中 |
| 立即开始执行 | 首先明确需求，然后创建计划文件 |
高级模式
参见 reference.md 了解：
- 注意力操作技巧
- 错误恢复模式
- 来自 Evan 的上下文优化
参见 examples.md 了解：
