# Planning With Files

> 用于需要文件化计划的长任务：当任务够大，需要 task plan、进度跟踪、研究记录、迁移方案或 `/clear` 后恢复时使用。Best for 多步骤项目、研究、迁移和明显会超过少量 tool calls 的任务；Combine with the domain skill that owns the actual work；Do not use for 很小的一次性任务或只需口头澄清的问题。

- Skill: `hebertzhu/planning-with-files` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hebertzhu/planning-with-files`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hebertzhu/planning-with-files/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hebertzhu (https://skillmd.com/u/hebertzhu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hebertzhu/planning-with-files

---


# planning-with-files

## Intent
- 用于需要文件化计划的长任务：当任务够大，需要 task plan、进度跟踪、研究记录、迁移方案或 `/clear` 后恢复时使用。Best for 多步骤项目、研究、迁移和明显会超过少量 tool calls 的任务；Combine with the domain skill that owns the actual work；Do not use for 很小的一次性任务或只需口头澄清的问题。

## Default operating pattern
1. Capture the goal, constraints, and success criteria before acting.
2. Create or refresh lightweight planning files in the working repository.
3. Sequence phases, discoveries, and blockers so the task can survive long sessions.
4. Re-read the plan before major decisions and update it after each phase.
5. Hand off with explicit status, evidence, and the next recommended move.

## Pack fit
- Included in: `engineering-workflow`, `context-systems`, `skill-authoring`
- Keep examples generic, privacy-safe, and portable across hosts.

## Boundary
- Do not use for trivial one-shot edits or single-answer questions.