Memory Checkpoint 技能 (記憶檢查點)

描述

在對話被 Summarize 壓縮前，主動將詳細記憶外部化到 Memory Bank，避免重要上下文遺失。

觸發條件

• 「記憶檢查點」、「checkpoint」、「存檔」
• 「保存記憶」、「外部化記憶」
• 「sync memory」、「dump context」
• 對話較長時主動觸發（建議每 10-15 輪對話或重大進展後）

⚠️ 為什麼需要這個 Skill？

當對話過長時，系統會自動 Summarize（摘要）對話歷史，可能導致：

• 詳細的程式碼變更記錄被省略
• 決策背後的討論脈絡遺失
• 檔案路徑和具體實作細節模糊化
• 需要花時間重建上下文

解決方案：在被 Summarize 前，主動將關鍵記憶寫入 memory-bank/ 目錄。

📋 Checkpoint 內容

1️⃣ activeContext.md - 當前工作焦點

markdown
1## 當前工作焦點
2<!-- 當前正在做什麼 -->
3
4## 進行中的變更
5<!-- 具體的檔案和修改 -->
6
7## 待處理事項
8<!-- 下一步要做什麼 -->
9
10## 關鍵決策
11<!-- 本次對話做的重要決定 -->
12
13## 相關檔案
14<!-- 涉及的檔案路徑列表 -->

2️⃣ progress.md - 進度追蹤

markdown
1## Done (已完成)
2- [x] 具體完成的事項（含檔案路徑）
3
4## Doing (進行中)
5- [ ] 正在進行的工作
6
7## Next (下一步)
8- [ ] 計劃要做的事項

3️⃣ decisionLog.md - 決策日誌

markdown
1## YYYY-MM-DD
2
3### 決策：[決策標題]
4- **背景**：為什麼需要這個決定
5- **選項**：考慮過的方案
6- **決定**：最終選擇
7- **原因**：選擇的理由

4️⃣ architect.md - 架構記錄（如有變更）

markdown
1## 架構變更記錄
2
3### YYYY-MM-DD: [變更標題]
4- **變更內容**：
5- **影響範圍**：
6- **相關檔案**：

🚀 Checkpoint 執行步驟

自動執行（推薦）

當偵測到以下情況，AI 應主動執行 Checkpoint：

1. 對話長度指標

   • 對話超過 10 輪
   • 累積修改超過 5 個檔案
   • 完成一個重要功能/修復

2. 工作階段轉換

   • 從設計階段轉到實作
   • 完成一個 PR 或 Commit
   • 切換到不同的功能區塊

3. 明確指標

   • 使用者說「先記一下」、「checkpoint」
   • 使用者說「等等繼續」、「我先去忙」

手動執行

使用者可隨時說：

• 「記憶檢查點」
• 「同步 memory bank」
• 「存檔目前進度」

📝 Checkpoint 範本

Quick Checkpoint（快速檢查點）

更新 activeContext.md：

markdown
1# Active Context
2
3> Last checkpoint: 2024-XX-XX HH:MM
4
5## 🎯 當前焦點
6[一句話描述當前在做什麼]
7
8## 📝 本次對話摘要
91. [做了什麼 1]
102. [做了什麼 2]
113. [做了什麼 3]
12
13## 📁 變更的檔案
14- `path/to/file1.py` - [變更摘要]
15- `path/to/file2.ts` - [變更摘要]
16
17## ⚠️ 待解決
18- [ ] 問題 1
19- [ ] 問題 2
20
21## 💡 重要決定
22- 決定 A：[原因]
23- 決定 B：[原因]
24
25## 🔜 下一步
261. [下一步 1]
272. [下一步 2]

Full Checkpoint（完整檢查點）

更新所有相關 Memory Bank 檔案：

memory-bank/
├── activeContext.md  ← 當前焦點 + 變更檔案
├── progress.md       ← Done/Doing/Next
├── decisionLog.md    ← 新決策（如有）
├── architect.md      ← 架構變更（如有）
├── productContext.md ← 技術棧變更（如有）
└── systemPatterns.md ← 新模式/慣例（如有）

🔄 與其他 Skills 整合

搭配 git-precommit

git commit 前 → 觸發 memory-checkpoint → 同步 Memory Bank → commit

搭配 memory-updater

memory-checkpoint = 批次更新
memory-updater = 增量更新

💬 對話範例

使用者觸發

User: checkpoint

AI: 📸 執行記憶檢查點...

已更新 Memory Bank：
- ✅ activeContext.md - 記錄當前焦點與 5 個變更檔案
- ✅ progress.md - 新增 3 個已完成項目
- ✅ decisionLog.md - 記錄 2 個決策

下次對話可從此處繼續，即使被 Summarize 也不會遺失關鍵資訊。

AI 主動觸發

AI: 💡 偵測到對話較長且有多項進展，建議執行記憶檢查點。
    是否要我同步 Memory Bank？

User: 好

AI: 📸 執行記憶檢查點...
    [更新 Memory Bank]

⚙️ 配置選項

在 .vscode/settings.json 中可配置：

json
1{
2  "claude.skills.memoryCheckpoint": {
3    "autoTrigger": true,
4    "triggerThreshold": {
5      "conversationTurns": 10,
6      "filesModified": 5
7    },
8    "includeFiles": [
9      "activeContext.md",
10      "progress.md",
11      "decisionLog.md"
12    ]
13  }
14}

📊 Checkpoint 品質檢查

好的 Checkpoint 應包含：

🛠️ 實作提示

對 AI 的指示

在 CLAUDE.md 或 AGENTS.md 中加入：

markdown
1## Memory Checkpoint 規則
2
31. **主動觸發時機**
4   - 對話超過 10 輪時，主動建議 checkpoint
5   - 完成重大功能後，主動執行 checkpoint
6   - 使用者說要離開時，主動執行 checkpoint
7
82. **Checkpoint 內容**
9   - 必須包含：具體檔案路徑、變更摘要、下一步
10   - 避免：過於籠統的描述、遺漏重要細節
11
123. **格式要求**
13   - 使用時間戳記
14   - 檔案路徑使用相對路徑
15   - 保持簡潔但完整