多步骤任务或调研项目时，用持久化 markdown…

当任务有 3 个以上步骤、跨度大、需要调研或容易跑偏时，用文件系统代替易失的上下文来保存计划与发现。

适用场景

解决思路

1. 为每个复杂任务在文件系统中创建三个持久化 markdown 文件：`task_plan.md`（跟踪阶段与进度）、`notes.md`（存放调研与发现）、`[deliverable].md`（最终产出）。
2. 先创建 `task_plan.md`，写明目标（Goal）、阶段列表（Phases，用 `- [ ]` 复选框逐条列出）和当前状态（Status，标明当前处于哪个阶段，如 `**Currently in Phase 2**`）。
3. 进入工作流循环第一步：调研，把结果写入 `notes.md`，然后回写更新 `task_plan.md`。
4. 进入循环第二步：读取 `notes.md`，据此生成交付物，再次更新 `task_plan.md`。
5. 循环结束后交付最终输出（deliverable 文件）。
6. 把文件系统当作记忆：所有信息存进文件，而不是全部塞进上下文。
7. 做决策前重读 `task_plan.md`（注意力操控），防止多次工具调用后目标漂移。
8. 把失败和错误记录进 plan 文件（错误持久化），避免同样的错误重复出现。
9. 用复选框的勾选状态（`- [x]` / `- [ ]`）直观跟踪目标进度。
10. 上下文只追加、不修改历史（append-only），保留完整过程记录。
11. 按需安装该技能：把技能目录软链到全局 skills 目录，执行 `ln -s /path/to/agent-playbook/skills/planning-with-files ~/.claude/skills/planning-with-files`。

适用边界 · 注意事项

• 简单问题、单文件编辑、快速查找等轻量任务不要用，纯属额外开销。
• 需要产出 PRD 的任务不适用，应改用 prd-planner skill。