planning-with-files

Planning with Files - Claude 复杂任务文件规划技能

技能概述

Planning with Files 是一款实现 Manus 风格文件式规划的 Claude 技能，通过创建 task_plan.md、findings.md 和 progress.md 三个持久化文件，帮助用户有效管理复杂的多步骤任务、研究项目和需要大量工具调用的开发工作。

适用场景

1. 复杂多步骤任务

当你的任务需要执行超过 5 次工具调用，或者包含 3 个以上相互关联的步骤时，这个技能可以帮助你建立清晰的任务结构，跟踪每个阶段的完成状态，确保不会遗漏任何重要环节。

2. 研究项目与探索

在进行代码库研究、技术调研或问题诊断时，findings.md 文件可以作为你的研究笔记，记录所有重要发现和见解，防止多模态信息（如浏览器内容、图片分析）在上下文窗口中被遗忘。

3. 长期开发项目

对于跨越多个会话的开发工作，三个规划文件提供了持久化的"磁盘工作记忆"，让你随时可以恢复之前的进度，回顾已完成的阶段和记录的错误及解决方案。

核心功能

1. 三文件规划系统

task_plan.md：记录任务阶段、当前进度和关键决策，每个阶段完成后更新状态

findings.md：存储研究过程中的发现、见解和重要信息，遵循"2-Action 规则"及时保存

progress.md：会话日志和测试结果记录，帮助追踪工作历史

2. 智能错误处理机制

内置"3-Strike 错误协议"，指导你系统化地处理失败：第一次诊断修复，第二次尝试替代方案，第三次重新思考问题方向，三次失败后升级给用户。所有错误都会被记录到计划文件中，避免重复失败。

3. 上下文管理最佳实践

提供"决策前重读计划"和"5问题重启测试"等方法，确保在长时间复杂任务中始终保持目标清晰。文件系统作为持久化的外挂记忆，弥补了上下文窗口容量有限的不足。

常见问题

planning-with-files 适合什么类型的任务？

这个技能专为需要超过 5 次工具调用的复杂任务设计。典型适用场景包括：多步骤的代码重构、大型研究项目、跨多个文件的调试工作、需要多次搜索和浏览的技术调研等。对于简单的单次文件编辑或快速查询，直接使用相应工具更高效。

三个规划文件有什么区别和用途？

task_plan.md 是你的任务蓝图，记录阶段划分、进度状态和关键决策；findings.md 是你的研究笔记，随时记录发现的任何有价值信息；progress.md 是你的会话日志，按时间顺序记录操作和测试结果。三者配合使用，确保重要信息不会因上下文切换而丢失。

为什么要用文件而不是内置的 TodoWrite 管理任务？

文件是持久化的，会话结束后仍然存在，适合跨天或跨周的项目；而 TodoWrite 仅在当前会话有效。更重要的是，文件可以被版本控制（Git），可以与其他开发者共享，并且不受上下文窗口大小限制，能够容纳大量的任务细节和研究发现。