planning-with-files-zht

# 檔案規劃系統

像 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-zht\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) 範本