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.mdtask_plan.md是你的任务路线图相当于磁盘上的工作记忆。在开始任何工作之前务必先创建这个文件核心功能与使用时机目标设定用一句话清晰描述你要达成的最终状态阶段划分将任务分解为3-7个逻辑阶段每个阶段都应该是可完成的状态追踪记录每个阶段的进展状态pending→in_progress→complete决策记录技术决策及其背后的理由错误日志遇到的每个错误、尝试次数和解决方案最佳实践在完成每个阶段后更新状态在做出重大决策前重新阅读计划文件。 研究发现文件findings.mdfindings.md是你的知识库存储所有发现和决策。由于上下文窗口有限这个文件就是你的外部记忆——持久化且无限制。关键规则2-Action Rule 在每2次查看/浏览/搜索操作之后立即将关键发现保存到文本文件中。这个规则防止视觉/多模态信息丢失。记住截图、PDF内容和浏览器结果不会持久化必须立即捕获为文本更新时机速查表操作类型何时更新更新内容研究新发现立即添加到研究结果部分查看2次浏览器结果必须更新遵守2-Action规则做出技术决策立即添加到技术决策表格找到有用资源立即添加到资源部分 进度记录文件progress.mdprogress.md是你的会话日志——按时间顺序记录你做了什么、什么时候做的以及发生了什么。进度追踪要素会话日期记录工作发生的日期便于在时间间隔后恢复阶段详情每个阶段的具体操作、创建/修改的文件测试结果运行测试、预期结果、实际结果的详细记录错误日志带有时间戳和解决尝试的详细错误记录 三大文件协同工作指南启动阶段创建task_plan.md- 定义目标、阶段和关键问题创建findings.md- 准备接收研究结果创建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 Check2. 错误处理策略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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考