用途
planning-with-files 用于复杂多步骤任务的规划与上下文管理，采用 Manus 风格的基于文件的规划方法，把持久化 markdown 文件作为磁盘上的“工作记忆”。其核心模式是：上下文窗口相当于 RAM（易失、有限），文件系统相当于磁盘（持久、近乎无限），因此任何重要信息都应写入磁盘。
主要能力
该技能通过三个规划文件来组织工作：task_plan.md 记录阶段、进度与决策，在每个阶段完成后更新；findings.md 记录研究与发现，在任一发现后更新；progress.md 记录会话日志与测试结果，贯穿整个会话更新。资料还给出了脚本支持：scripts/init-session.sh 用于初始化全部规划文件，scripts/check-complete.sh 用于校验所有阶段是否完成，scripts/session-catchup.py 用于从上一个会话恢复上下文（v2.2.0）。
使用方式
在开始任何复杂任务前，先创建 task_plan.md、findings.md 和 progress.md（可参考 templates/ 下的模板），在做决策前重新阅读计划以刷新目标，每完成一个阶段后更新状态、记录错误与创建或修改的文件。规划文件应放在项目根目录，而非技能安装目录；模板、脚本和参考文档位于 ${CLAUDE_PLUGIN_ROOT}/ 下。
技能强调若干关键规则：必须先创建计划文件；遵循“2-Action 规则”，每进行两次查看、浏览器或搜索操作后立即把关键发现写入文本文件，以防视觉或多模态信息丢失；决策前先读计划；行动后更新计划；记录所有错误；绝不重复同一次失败操作。错误处理采用三振协议：第一次诊断并修复，第二次换一种方法，第三次更广泛地重新思考，三次失败后升级给用户说明尝试内容与具体错误并请求指导。
资料还提供了读与写的决策矩阵，例如刚写完文件不必读取、查看图片或 PDF 后应立即写发现、浏览器返回数据应写入文件、开始新阶段前应读计划与发现、发生错误时应读相关文件、间隔后恢复任务应读全部规划文件。另有“5 问重启测试”，通过回答我在哪里、我要去哪、目标是什么、我学到了什么、我做了什么来检验上下文管理是否可靠。
对于 v2.2.0，技能要求先检查上一个会话是否有未同步的上下文，资料给出了 Linux/macOS 与 Windows PowerShell 的调用命令，并说明若检查报告显示未同步上下文，应运行 git diff --stat 查看实际代码变更、阅读当前规划文件，并据检查结果与 git diff 更新规划文件，然后再继续任务。
适用场景
资料建议在以下情况使用：多步骤任务（3 步以上）、研究任务、构建或创建项目、跨越多次工具调用的任务，以及任何需要组织的工作。以下情况可跳过：简单问题、单文件编辑、快速查找。
限制与注意事项
资料列出了反模式：不要用 TodoWrite 做持久化而应创建 task_plan.md 文件；不要只陈述一次目标就遗忘而应在决策前重读计划；不要隐藏错误并静默重试而应把错误记录到计划文件；不要把一切都塞进上下文而应把大段内容存入文件；不要立即开始执行而应先创建计划文件；不要重复失败操作而应跟踪尝试并改变方法；不要在技能目录中创建文件而应在项目目录中创建。
关于收费、价格、支持平台与具体效果等信息，资料暂未提供。