name: planning-with-files description: 为复杂任务实施Manus风格的基于文件的规划。创建task_plan.md、findings.md和progress.md。用于启动复杂多步任务、研究项目或任何需要超过5个工具调用的任务。

文件规划

像Manus一样工作：使用持久的markdown文件作为你的“磁盘上的工作内存”。

重要：文件位置

模板在此技能的templates/文件夹中
你的规划文件放在你的项目目录中

位置	存放内容
技能目录	模板、脚本、参考文档
你的项目目录	`task_plan.md`、`findings.md`、`progress.md`

快速开始

在任何复杂任务之前：

创建task_plan.md — 参考templates/task_plan.md
创建findings.md — 参考templates/findings.md
创建progress.md — 参考templates/progress.md
决策前重读计划 — 刷新注意力窗口中的目标
每个阶段后更新 — 标记完成、记录错误

注意： 规划文件放在项目根目录，而非技能安装文件夹。

核心模式

上下文窗口 = 内存（易失、有限）
文件系统 = 磁盘（持久、无限）

→ 任何重要内容都写入磁盘。

文件用途

文件	用途	何时更新
`task_plan.md`	阶段、进度、决策	每个阶段后
`findings.md`	研究、发现	任何发现后
`progress.md`	会话日志、测试结果	整个会话中

关键规则

1. 先创建计划

切勿在没有task_plan.md的情况下开始复杂任务。不容协商。

2. 2动作规则

“每进行2次查看/浏览/搜索操作后，立即将关键发现保存到文本文件中。”

这防止视觉/多模态信息丢失。

3. 决策前阅读

在重大决策前，阅读计划文件。这使目标保持在你的注意力窗口中。

4. 行动后更新

完成任何阶段后：

标记阶段状态：in_progress → complete
记录遇到的错误
注意创建/修改的文件

5. 记录所有错误

每个错误都记入计划文件。这积累知识并防止重复。

## 遇到的错误
| 错误 | 尝试次数 | 解决方案 |
|-------|---------|------------|
| FileNotFoundError | 1 | 创建了默认配置 |
| API超时 | 2 | 添加了重试逻辑 |

6. 永不重复失败

if action_failed:
    next_action != same_action

跟踪尝试内容。改变方法。

3次尝试错误协议

尝试1：诊断与修复
  → 仔细阅读错误
  → 识别根本原因
  → 应用针对性修复

尝试2：替代方法
  → 相同错误？尝试不同方法
  → 不同工具？不同库？
  → 绝不重复完全相同的失败动作

尝试3：更广泛的重新思考
  → 质疑假设
  → 搜索解决方案
  → 考虑更新计划

3次失败后：向用户升级
  → 解释尝试内容
  → 分享具体错误
  → 请求指导

读取与写入决策矩阵

情况	动作	原因
刚写入文件	不读取	内容仍在上下文中
查看图像/PDF	立即写入发现	多模态 → 在丢失前转为文本
浏览器返回数据	写入文件	截图不持久
开始新阶段	阅读计划/发现	如果上下文过时，重新定位
发生错误	阅读相关文件	需要当前状态修复
中断后恢复	阅读所有规划文件	恢复状态

5问题重启测试

如果能回答这些问题，你的上下文管理很扎实：

问题	答案来源
我在哪里？	task_plan.md中的当前阶段
我要去哪里？	剩余阶段
目标是什么？	计划中的目标陈述
我学到了什么？	findings.md
我做了什么？	progress.md

何时使用此模式

适用于：

多步任务（3步以上）
研究任务
构建/创建项目
跨越多个工具调用的任务
任何需要组织的任务

跳过：

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

模板

复制这些模板开始：

templates/task_plan.md — 阶段跟踪
templates/findings.md — 研究存储
templates/progress.md — 会话日志记录

脚本

自动化辅助脚本：

scripts/init-session.sh — 初始化所有规划文件
scripts/check-complete.sh — 验证所有阶段完成

高级主题

Manus原则： 见references/reference.md
实际示例： 见references/examples.md

反模式

不要	改为做
一次陈述目标后就忘记	决策前重读计划
隐藏错误并静默重试	将错误记录到计划文件
把所有内容塞入上下文	将大内容存储到文件中
立即开始执行	首先创建计划文件
重复失败的动作	跟踪尝试、改变方法
在技能目录中创建文件	在你的项目中创建文件