planning-with-files-zh

# 文件规划系统

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

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

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

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

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

```bash

# Linux/macOS

$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"

```

```powershell

# Windows PowerShell

& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zh\scripts\session-catchup.py" (Get-Location)

```

如果恢复报告显示有未同步的上下文：

1. 运行 `git diff --stat` 查看实际代码变更

2. 读取当前规划文件

3. 根据恢复报告和 git diff 更新规划文件

4. 然后继续任务

重要：文件存放位置

• **模板**在 `${CLAUDE_PLUGIN_ROOT}/templates/` 中
• **你的规划文件**放在**你的项目目录**中

| 位置 | 存放内容 |

|------|---------|

| 技能目录 (`${CLAUDE_PLUGIN_ROOT}/`) | 模板、脚本、参考文档 |

| 你的项目目录 | `task_plan.md`、`findings.md`、`progress.md` |

快速开始

在任何复杂任务之前：

1. **创建 `task_plan.md`** — 参考 [templates/task_plan.md](templates/task_plan.md) 模板

2. **创建 `findings.md`** — 参考 [templates/findings.md](templates/findings.md) 模板