planning-with-files-zh

SKILL.md

Manus-style file-based planning system for organizing and tracking multi-step project progress.

Creates three persistent markdown files—task_plan.md, findings.md, and progress.md—that serve as disk-based working memory across sessions

Automatically detects and loads active plans on each prompt, with tamper detection and attestation to prevent injection attacks

Includes session recovery via catchup script to restore context from previous interrupted work and sync untracked changes

Supports scoped plans (nested in .planning/ directories) and root-level plans, with clear rules for when to read, write, and update each file

Provides templates, error tracking matrices, and a three-failure protocol to prevent repeated mistakes and guide decision-making before major actions

文件规划系统

像 Manus 一样工作：用持久化的 Markdown 文件作为你的「磁盘工作记忆」。

第一步：恢复上下文（v2.2.0）

在做任何事之前，检查规划文件是否存在并读取它们：

如果 task_plan.md 存在，立即读取 task_plan.md、progress.md 和 findings.md。

然后检查上一个会话是否有未同步的上下文：

# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-zh}"
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" "$(pwd)"