Manus Planning Files — OpenClaw Edition 🚀

> Persistent markdown files as your "working memory on disk."

> Checkpoint, recovery, auto-pivot, multi-phase execution, live progress dashboard.

> Zero external dependencies. Zero-config cron auto-registration.

⚡ Quick Start — 强制自举

≥2 个工具调用 → 强制 init-session → auto-track.sh --now → 自动注册 cron

单步定义： 1 个工具调用完成。只要 ≥2 步，先 init-plan，再干活。宁可多建十个计划不少建一个。

触发（任一即建）

跳过（仅限这些）

纯问答 / 单文件看一眼 / 一次搜索 / 打招呼

怎么建

bash skills/planning-with-files/scripts/init-session.sh "简短任务描述"

然后填 task_plan.md（goal + phases），开工。建完后立即：

bash skills/planning-with-files/scripts/auto-track.sh --now

第一次运行输出 ⚡ AUTOTRACK_CRON_MISSING / ⚡ REVIEW_CRON_MISSING → AI 看到信号立即注册 cron（详见 Rule 14）。

Core Pattern

Context Window = RAM (volatile, limited)
Filesystem     = Disk (persistent, unlimited)

→ Anything important gets written to disk.

File Purposes

Critical Rules

1. Create Plan First

≥2 tool calls → init-session.sh FIRST. No exceptions.

2. The 2-Action Rule

After every 2 view/browser/search operations, save findings to findings.md.

3. Read Before Decide

Re-read the plan file before major decisions.

4. Update After Act

After any phase: mark complete, log errors, note files created.

5. Log ALL Errors

Every error goes in the plan file's error table. Track attempts.

6. Never Repeat Failures

if action_failed: next_action ≠ same_action. Mutate the approach.

7. Continue After Completion

Phases done but work continues → add new phases + new session entry.

8. Pivot Rule

在每个 phase 标记完成前做全局校准：findings.md vs 原规划 → 必要时增删改 phases，不要硬撑。仅在 phase 边界触发。

9. Checkpoint After Each Phase

bash skills/planning-with-files/scripts/snapshot.sh

JSON checkpoint → .planning//checkpoints/，保留最近 10 个。markdown 给人读，checkpoint 给 agent 恢复用。

10. Auto-Resume After Context Loss

上下文丢失后不逐个读文件，一键恢复：

bash skills/planning-with-files/scripts/resume.sh

输出直接告诉你：当前位置、下一步操作、已有发现数。无 checkpoint 时自动降级解析 plan 文件。

11. Progress Dashboard

bash skills/planning-with-files/scripts/status.sh        # 可视化仪表盘
bash skills/planning-with-files/scripts/status.sh --oneline  # 单行
bash skills/planning-with-files/scripts/status.sh --json     # 供脚本消费

12. Validate Before Delivery

bash skills/planning-with-files/scripts/validate-plan.sh

检查：phase 标 complete 但 checklist 不全 / 多个 phase 同时 in_progress / 文件缺失。不带腐化 plan 交付。

13. Snapshot After Status Change

状态变更即快照：pending→in_progress、in_progress→complete、checklist 更新 → 立即 snapshot.sh。checkpoint 越密集恢复越精确。

14. Auto-Track & 双 Cron 零配置自举 🆕

用户安装 skill 后零配置。AI 首次 auto-track.sh --now，脚本输出信号 → AI 立即注册 cron。

每个 phase 切换、init-session 后、交付前，必须运行 --now。

信号 1: ⚡ AUTOTRACK_CRON_MISSING

→ 写哨兵 + 注册 cron（每 5 分钟，isolated，delivery=none）

• name: auto-track-plan-maintenance
• schedule: every 300s
• payload: agentTurn 执行 auto-track.sh --cron --json

信号 2: ⚡ REVIEW_CRON_MISSING

→ 写哨兵 + 注册 cron（每天 03:00 Asia/Shanghai）

• name: review-distill-plans
• schedule: cron 0 3 * tz=Asia/Shanghai
• payload: agentTurn 执行 review-plans → distill to MEMORY.md → archive → clean sentinels

信号 3: 🎉 PLAN_COMPLETED:

所有 phase 完成 → auto-track 自动写 .needs_review 哨兵。review cron 每天自动蒸馏。

哨兵过期：24h 自动过期，防止 cron 被误删后无人知晓。

The 3-Strike Error Protocol

The 5-Question Reboot Test

Read vs Write Decision Matrix

Plan Lifecycle

 init-plan ──▶ execute + checkpoint ──▶ complete ──▶ review ──▶ distill to MEMORY.md
     │               │                        │            │
     ▼               ▼                        ▼            ▼
 task_plan.md   findings.md           .needs_review   MEMORY.md
                checkpoint/           哨兵自动触发    [archived]
                                      review cron

Scripts Reference

Anti-Patterns