Manus风格的文件式任务规划工具，通过持久化Markdown文件（task_plan.md、findings.md、progress.md）管理复杂项目的规划和进度，让AI在多步骤项目中的工作不因上下文丢失而中断。适合长期研究、多步骤开发等场景。

【适用场景】

复杂多步骤任务场景： 1. 长期研究项目：需要跨越多个会话持续推进的研究 2. 多步骤开发：5个以上工具调用的大型开发任务 3. 复杂问题分析：需要收集多方信息并逐步整合的分析任务 4. 提案撰写：商业提案、学术论文等多阶段写作任务 5. 任何需要5+工具调用才能完成的工作

【操作步骤】

第一步：恢复上下文（必须首先执行） 每次开始工作时，先检查是否存在已有的规划文件： bash

Linux/macOS

SKILL_DIR="${HERMES_HOME:-$HOME/.hermes}/skills/planning-with-files" $(command -v python3) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)"

如存在task_plan.md，立即读取task_plan.md、progress.md和findings.md

第二步：创建或更新规划文件 根据任务需求，创建或更新三个核心文件： - task_plan.md：任务计划，分解为具体步骤 - findings.md：研究发现和收集的信息 - progress.md：当前进度，已完成和待办事项

第三步：执行并记录 每个工具调用后，将结果记录到findings.md或progress.md bash

将发现追加到findings.md

echo '## 新发现' >> findings.md

第四步：会话恢复 如遇到/clear或上下文被重置，先执行session-catchup.py恢复规划文件

【代码模板】

task_plan.md模板： markdown

任务计划

目标

明确描述要达成的最终目标

分解步骤

1. [ ] 步骤1 2. [ ] 步骤2 3. [ ] 步骤3

当前重点

当前会话应聚焦的任务

风险与假设

已识别的风险和假设条件

findings.md模板： markdown

研究发现

信息A

收集到的具体信息

信息B

另一个重要发现

progress.md模板： markdown

进度追踪

已完成

- [x] 完成项1 - [x] 完成项2

进行中

- [ ] 进行中项

障碍

遇到的障碍和解决方案

【复盘要点】

1. 永远先恢复上下文：task_plan.md存在时必须先读取 2. 三个文件缺一不可：分别承担计划、发现、进度的角色 3. 会话恢复脚本：使用session-catchup.py自动恢复 4. 进度及时更新：每完成一步就更新progress.md 5. 障碍透明记录：遇到问题时记录到progress.md的障碍区 6. 支持多会话连续：工作可随时通过读取文件恢复

来源：GitHub https://github.com/OthmanAdi/planning-with-files