Planning-with-Files三大文件详解：task_plan.md、findings.md、progress.md的使用技巧

Planning-with-Files三大文件详解：task_plan.md、findings.md、progress.md的使用技巧

【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files

想要像Meta以20亿美元收购的Manus公司一样高效工作吗？🤔 Planning-with-Files技能让你掌握他们的核心工作模式——使用持久化的Markdown文件作为"磁盘上的工作记忆"。这个技能实现了Manus风格的基于文件的规划，专门为复杂任务设计，特别适合需要超过5个工具调用的场景。

📋 任务规划文件：task_plan.md

task_plan.md是你的任务路线图，相当于"磁盘上的工作记忆"。在开始任何工作之前，务必先创建这个文件！🎯

核心功能与使用时机

• 目标设定：用一句话清晰描述你要达成的最终状态
• 阶段划分：将任务分解为3-7个逻辑阶段，每个阶段都应该是可完成的
• 状态追踪：记录每个阶段的进展状态（pending→in_progress→complete）
• 决策记录：技术决策及其背后的理由
• 错误日志：遇到的每个错误、尝试次数和解决方案

最佳实践：在完成每个阶段后更新状态，在做出重大决策前重新阅读计划文件。

🔍 研究发现文件：findings.md

findings.md是你的知识库，存储所有发现和决策。由于上下文窗口有限，这个文件就是你的"外部记忆"——持久化且无限制。

关键规则：2-Action Rule 🚨

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

这个规则防止视觉/多模态信息丢失。记住：截图、PDF内容和浏览器结果不会持久化，必须立即捕获为文本！

更新时机速查表

📊 进度记录文件：progress.md

progress.md是你的会话日志——按时间顺序记录你做了什么、什么时候做的以及发生了什么。

进度追踪要素

• 会话日期：记录工作发生的日期，便于在时间间隔后恢复
• 阶段详情：每个阶段的具体操作、创建/修改的文件
• 测试结果：运行测试、预期结果、实际结果的详细记录
• 错误日志：带有时间戳和解决尝试的详细错误记录

🎯 三大文件协同工作指南

启动阶段

1. 创建task_plan.md- 定义目标、阶段和关键问题
2. 创建findings.md- 准备接收研究结果
3. 创建progress.md- 建立会话记录基础

工作循环模式

1. 研究 → 更新findings.md 2. 研究 → 更新findings.md（第2次 - 现在必须更新！） 3. 做出决策 → 更新findings.md"技术决策" 4. 实现代码 → 更新progress.md"已执行操作" 5. 完成阶段 → 更新task_plan.md状态为"完成" 6. 完成阶段 → 更新progress.md阶段摘要

💡 实用技巧与最佳实践

1. 目标保持技巧

• 在做出重大决策前重新阅读task_plan.md
• 使用PreToolUse钩子自动读取计划文件
• 定期更新5-Question Reboot Check

2. 错误处理策略

• 3-Strike错误协议：尝试1→诊断修复，尝试2→不同方法，尝试3→重新思考

3. 文件位置管理

• 模板文件：存储在技能目录的templates/文件夹中
• 你的规划文件：应该在你的项目目录中创建——你正在工作的文件夹

确保你的规划文件与代码并存，而不是埋在技能安装文件夹中。

🚫 常见错误避免指南

❌不创建task_plan.md就开始工作✅ 始终先创建计划文件

❌忘记在2次浏览器操作后更新findings.md✅ 设置提醒："2次查看/浏览操作 = 更新findings.md"

❌不记录错误因为快速解决了✅ 记录所有错误，即使你立即解决了

❌重复相同的失败操作✅ 如果某件事失败，记录下来并尝试不同的方法

🎉 成功案例展示

案例1：研究任务

用户请求："研究晨练的好处并写总结"

task_plan.md：

# 任务计划：晨练益处研究 ## 目标 创建关于晨练益处的研究总结。 ## 阶段 - [x] 阶段1：创建此计划 ✓ - [x] 阶段2：搜索收集来源 ✓ - [ ] 阶段3：综合发现（当前） - [ ] 阶段4：交付总结

通过掌握这三个核心文件的协同使用，你将能够像Manus的AI工程师一样高效管理复杂任务，避免目标漂移和上下文丢失问题。记住：文件系统就是磁盘（持久化、无限制），上下文窗口就是RAM（易失、有限）——任何重要的内容都应该写入磁盘！💪

【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files