planning-with-files-zh

Organizes complex multi-step tasks using persistent Markdown planning files.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Pgooone/oh-pgone-claudecode --skill planning-with-files-zh-pgooone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-with-files-zh
Source: https://github.com/Pgooone/oh-pgone-claudecode/tree/main/.claude/plugins/cache/planning-with-files/planning-with-files/2.23.0/skills/planning-with-files-zh
Command: npx skills add https://github.com/Pgooone/oh-pgone-claudecode --skill planning-with-files-zh-pgooone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long-running or multi-step tasks lose context when the conversation window fills up or the session is cleared. This Skill persists goals, phases, findings, and progress into Markdown files on disk so work can be tracked, resumed after /clear, and audited at any time. ## Core Features & Use Cases - Persistent Planning Files: Creates and maintains task_plan.md, findings.md, and progress.md in your project directory as a durable working memory. - Session Recovery: A session-catchup script detects unsynced context from the previous session and supports automatic recovery after /clear. - Lifecycle Hooks: UserPromptSubmit, PreToolUse, PostToolUse, and Stop hooks re-inject the plan into context and remind you to update progress. - Use Case: When asked to plan and execute a multi-phase project (e.g., 拆解一个需要超过5次工具调用的开发任务), the Skill creates the three planning files, tracks phase status from pending to complete, logs errors, and verifies completion before stopping. ## Quick Start Ask the assistant to create a task plan for your multi-step project using the planning-with-files-zh skill, then let it initialize task_plan.md, findings.md, and progress.md in your project directory.

Frequently Asked Questions about planning-with-files-zh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track progress on a multi-step task with Claude Code?▼

Create task_plan.md, findings.md, and progress.md in your project root using the provided templates or the init-session script. Update phase status as work proceeds and read the plan before major decisions to keep goals in context.

How to recover context after /clear in a Claude Code session?▼

Run the session-catchup.py script with your project path. It scans the previous session transcript, finds the last planning file update, and prints unsynced messages so you can reconcile the planning files with actual work done.

Does this planning skill work on Windows PowerShell?▼

Yes. The scripts directory includes PowerShell versions (init-session.ps1, check-complete.ps1) alongside the Bash scripts, and the Stop hook automatically falls back between PowerShell and shell execution.

When should I not use file-based task planning?▼

Skip it for simple questions, single-file edits, and quick queries. The pattern is designed for tasks with three or more steps, research work, or anything spanning multiple tool calls where context loss is a risk.

Why should web content not be written into task_plan.md?▼

The PreToolUse hook re-reads task_plan.md before every tool call, so injected instructions in that file would be amplified repeatedly. External or untrusted content should only go into findings.md to reduce prompt injection risk.