Manus 风格的“文件化规划”工作流。用 task_plan.md / findings.md / progress.md 作为持久化工作记忆,配合 Cursor hooks 实现:每次工具前回读计划、写文件后提醒更新、未完成阶段时 stop 自动继续。
把“上下文窗口”当作易失内存,把“项目文件系统”当作持久化硬盘:任何重要内容都写进文件,避免长任务中迷失目标。
本技能约定三份规划文件均放在项目根目录(不是 skill 目录):
task_plan.md:目标、阶段(Phase)、决策与错误日志(最重要,会被 hooks 高频回读)findings.md:研究结论与证据(外部/不可信内容只放这里)progress.md:会话过程日志(做了什么、改了哪些文件、跑了哪些命令/测试)task_plan.md:立刻读取 task_plan.md、progress.md、findings.md 并继续当前 Phase。.cursor/skills/planning-with-files/scripts/session-catchup.py注意:
task_plan.md会被 hooks 自动注入/回读,因此严禁把网页/搜索结果原文写进 task_plan.md,只写进findings.md并做摘要。
如果项目根没有这三份文件,就从模板创建:
.cursor/skills/planning-with-files/templates/task_plan.md.cursor/skills/planning-with-files/templates/findings.md.cursor/skills/planning-with-files/templates/progress.md创建后,立刻把 task_plan.md 的 Goal / Phases / Current Phase 填好,再开始任何实现工作。
复杂任务(预计 >5 次工具调用 / 跨多个文件 / 需要研究)必须先有 task_plan.md。
每做完 2 次 Read/搜索/浏览/查看(尤其是图片、网页、长输出),立刻把关键信息写进 findings.md 或 progress.md。
做重要决策(改架构、换方案、开始大改动)前,先读 task_plan.md,让目标回到注意力窗口。
每完成一个 Phase:
**Status:** 更新为 completeprogress.md 里记录“做了什么、改了哪些文件、验证结果”同一个问题连续失败 3 次:
task_plan.md 的 Errors 表记录尝试与结论由于 hooks 会反复把 task_plan.md 注入到上下文:
findings.mdtask_plan.md 只写:目标、阶段、决策摘要、错误与下一步