计划留痕 / Plan Trail

像 Manus 那样工作：把持久化的 Markdown 文件当作「磁盘上的工作记忆」。 Work like Manus: Use persistent markdown files as your "working memory on disk."

核心模型 / The Core Pattern

上下文窗口 = 内存（易失、有限）
文件系统   = 磁盘（持久、无限）

→ 任何重要的东西，都写进磁盘。
→ Anything important gets written to disk.

三个文件的用途 / File Purposes

| 文件 / File | 用途 / Purpose | 何时更新 / When to Update | |------|---------|----------------| | task_plan.md | 阶段、进度、决策 | 每个阶段完成后 | | findings.md | 研究、发现 | 任何一次发现之后 | | progress.md | 会话日志、测试结果 | 整个会话过程中 |

这三个文件放在你当前项目的任务目录里（不是技能安装目录）。 Your planning files go in your project's task directory (not the skill install directory).

关键规则 / Critical Rules

1. 先建计划 / Create Plan First

任何复杂任务，没有 task_plan.md 绝不开工。不可商量。 Never start a complex task without task_plan.md. Non-negotiable.

2. 两步一存规则 / The 2-Action Rule

「每完成 2 次查看/浏览/搜索操作，立刻把关键发现存进文本文件。」 "After every 2 view/browser/search operations, IMMEDIATELY save key findings to text files."

这能防止视觉/多模态信息丢失。 This prevents visual/multimodal information from being lost.

3. 决策前先读 / Read Before Decide

做重大决定前，先读计划文件。让目标留在你的注意力窗口里。 Before major decisions, read the plan file. This keeps goals in your attention window.

4. 行动后更新 / Update After Act

完成任一阶段后： After completing any phase:

• 把阶段状态从 in_progress 改为 complete Mark phase status: in_progress → complete
• 记录遇到的错误 Log any errors encountered
• 记下创建/修改了哪些文件 Note files created/modified

每当阶段状态变化，也刷新 task_plan.md 里的 ## 下一步 / Next Step，让它指向下一个单一动作。 Whenever a phase status changes, also refresh ## Next Step in task_plan.md so it names the single next action.

5. 记录所有错误 / Log ALL Errors

每个错误都进计划文件。这积累知识、避免重复。 Every error goes in the plan file. This builds knowledge and prevents repetition.

## 遇到的错误 / Errors Encountered
| 错误 / Error | 尝试 / Attempt | 解决 / Resolution |
|-------|---------|------------|
| FileNotFoundError | 1 | 创建默认配置 / Created default config |
| API timeout | 2 | 加了重试逻辑 / Added retry logic |

6. 别重复失败 / Never Repeat Failures

if action_failed:
    next_action != same_action

记录你试过什么，变换打法。 Track what you tried. Mutate the approach.

7. 完成后继续 / Continue After Completion

所有阶段做完、用户又要加活时： When all phases are done but the user requests additional work:

• 往 task_plan.md 加新阶段（如 Phase 6、Phase 7）
• 在 progress.md 写一条新的会话记录
• 像平常一样继续规划流程
• Add new phases to task_plan.md
• Log a new session entry in progress.md
• Continue the planning workflow as normal

三次重试协议 / The 3-Strike Error Protocol

尝试 1：诊断并修复 / Diagnose & Fix
  → 仔细读错误 → 找根因 → 精准修复

尝试 2：换条路 / Alternative Approach
  → 同样的错？换方法 → 换工具？换库？
  → 绝不重复一模一样的失败动作

尝试 3：更大范围重想 / Broader Rethink
  → 质疑假设 → 搜解决方案 → 考虑改计划

三次都失败：升级给用户 / Escalate to User
  → 说明你试过什么 → 给出具体错误 → 请求指引

读 vs 写 决策矩阵 / Read vs Write Decision Matrix

| 情况 / Situation | 动作 / Action | 理由 / Reason | |-----------|--------|--------| | 刚写完一个文件 | 不要读 / DON'T read | 内容还在上下文里 | | 看过图片/PDF | 立刻写发现 / Write findings NOW | 多模态内容会丢失 | | 浏览器返回数据 | 写进文件 / Write to file | 截图不会持久 | | 开始新阶段 | 读计划/发现 / Read plan/findings | 上下文陈旧时重新定向 | | 出错了 | 读相关文件 / Read relevant file | 需要当前状态来修 | | 间隔后回来 | 读全部规划文件 / Read all planning files | 恢复状态 |

五问自检 / The 5-Question Reboot Test

能答上这些，说明你的上下文管理是稳的： If you can answer these, your context management is solid:

| 问题 / Question | 答案来源 / Answer Source | |----------|---------------| | 我在哪？ | task_plan.md 里的当前阶段 | | 我去哪？ | 剩余阶段 | | 目标是什么？ | 计划里的目标陈述 | | 我学到了什么？ | findings.md | | 我做了什么？ | progress.md | | 我准备做什么？ | task_plan.md 里的下一步 |

何时使用 / When to Use

用： Use for:

• 多步骤任务（3 步以上） Multi-step tasks (3+ steps)
• 研究型任务 Research tasks
• 构建/创造项目 Building/creating projects
• 跨很多工具调用的任务 Tasks spanning many tool calls
• 任何需要组织的任务 Anything requiring organization

跳过： Skip for:

• 简单问题 Simple questions
• 单文件编辑 Single-file edits
• 快速查询 Quick lookups

反模式 / Anti-Patterns

| 不要 / Don't | 改成 / Do Instead | |-------|------------| | 用任务列表做持久化 | 建 task_plan.md 文件 | | 定一次目标就忘 | 决策前重读计划 | | 掩盖错误、静默重试 | 把错误记进计划文件 | | 什么都塞进上下文 | 大块内容存文件 | | 立刻开干 | 先建计划文件 | | 重复失败的动作 | 记录尝试、变换打法 | | 在技能目录里建文件 | 在项目里建文件 | | 把网页内容写进 task_plan.md | 外部内容只写进 findings.md |