用途:为多步骤、跨文件或可能跨会话的复杂任务提供持久化规划。适用于涉及 3 个以上阶段、多个 REST API 封装、跨文件重构迁移、研究型任务、超过 5 次工具调用或组件间存在依赖的工作;简单问答、单文件编辑等 1-2 次工具调用可完成的任务不使用。
主要能力:核心思路是上下文窗口相当于易失内存,文件系统相当于持久磁盘,重要信息写入磁盘。所有规划文件放在 .agent_cache/<task-name>/ 目录,任务名用小写加连字符。三个文件各有分工:task_plan.md 记录阶段、进度与当前状态,每阶段完成后更新;findings.md 记录研究、发现与技术决策,每次发现后更新;progress.md 记录会话日志、测试结果与错误,贯穿整个会话。
使用方式:先 mkdir -p .agent_cache/<task-name> 创建目录,再按模板建立三个文件。每次重大决策前重读计划,完成阶段后更新状态并记录创建或修改的文件与错误。工作循环为:读取计划、分析下一任务、执行一个逻辑动作、更新文件、重复。