Planning with Files (Chinese Edition)
Keeps complex, multi-step work on track by persisting task_plan.md, findings.md and progress.md to disk and re-injecting the plan via hooks.
What it does
A Chinese-language build of the Manus-style "filesystem as working memory" workflow. Before any complex task it creates and maintains three files in your project root:
| File | Purpose |
|------|---------|
| task_plan.md | Phases, status, key decisions |
| findings.md | Research and discoveries |
| progress.md | Session log, test results |
It registers UserPromptSubmit, PreToolUse, PostToolUse, Stop and PreCompact hooks so the current plan is re-injected before tool calls, and ships session-catchup.py to restore context after /clear or compaction. The doc also codifies a three-strike failure protocol, a read-vs-write decision matrix, and a security boundary rule: untrusted web content goes only into findings.md, never into the hook-read task_plan.md.
Who it's for
- Anyone running tasks that exceed ~5 tool calls (refactors, migrations, research)
- Users frustrated by Claude drifting from the original goal in long sessions
- Teams that want an auditable, git-friendly trail of decisions and errors
- Chinese-speaking users who prefer localized planning docs
Examples
- Multi-phase refactor: ask it to break a payment module rewrite into phases; it writes a 6-phase
task_plan.md, flips each phase tocomplete, and logs every error in a table. - Competitive research: after every two searches or page fetches, key findings are flushed to
findings.mdso nothing is lost to context truncation. - Resuming next day: the catch-up script plus
git diff --statdetects un-synced changes and refreshes the plan files before work continues.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/planning-with-files-zh folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/planning-with-files-zh/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files && cp -r /tmp/planning-with-files/skills/planning-with-files-zh ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/OthmanAdi/planning-with-files.git - Copy the skill:
cp -r planning-with-files/skills/planning-with-files-zh ~/.claude/skills/ - Make scripts executable:
chmod +x ~/.claude/skills/planning-with-files-zh/scripts/*.sh - Verify Python is available (
python3 --version) for the session catch-up script. - Restart Claude Code and ask something like "plan this project step by step" to trigger the skill.
- If you installed to a non-standard path, export
PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files-zh/scriptsin your shell profile. - Review the hook commands first if you work under strict security policies — they run shell snippets on every prompt and tool call.