name: memory-updater description: Update and maintain Memory Bank files (activeContext, progress, decisionLog). Triggers: MB, memory, 記憶, 進度, 更新記憶, update memory, 記錄進度, 更新上下文, sync, 同步, 記下來, note, 筆記, context, 脈絡, 追蹤, track, 狀態, status. version: 2.2.0 category: memory compatibility:
- claude-code
- github-copilot
- vscode
- codex-cli dependencies: [] allowed-tools:
- read_file
- write_file
- replace_string_in_file
- memory
Memory Bank 更新技能
描述
維護和更新專案的 Memory Bank 記憶系統,確保專案狀態在對話間持久化。
觸發條件
- 「更新 memory bank」「MB」「記錄進度」
- 「更新上下文」「sync」「同步」
- 工作階段結束時
- 完成重要任務後
📁 Memory Bank 檔案結構
memory-bank/
├── activeContext.md # 當前工作焦點(最常更新)
├── progress.md # 進度追蹤 Done/Doing/Next
├── decisionLog.md # 重要決策記錄
├── architect.md # 架構文檔
├── productContext.md # 專案上下文
├── projectBrief.md # 專案簡介
└── systemPatterns.md # 系統模式
🔧 操作步驟
Step 1: 讀取現有內容
使用 read_file 工具讀取要更新的檔案:
read_file("memory-bank/activeContext.md")
read_file("memory-bank/progress.md")
Step 2: 判斷更新類型
| 情況 | 更新檔案 | 更新方式 |
|---|---|---|
| 開始新任務 | activeContext.md, progress.md | 新增 Doing |
| 完成任務 | progress.md | Doing → Done |
| 做出決策 | decisionLog.md | 新增條目 |
| 架構變更 | architect.md | 更新相關區塊 |
Step 3: 執行更新
使用 replace_string_in_file 進行精確更新(推薦):
replace_string_in_file(
filePath="memory-bank/progress.md",
oldString="## Doing\n\n- [ ] 任務 A",
newString="## Doing\n\n- [ ] 任務 A\n- [ ] 新任務 B"
)
或使用 write_file 完整覆寫(適合大幅修改)。
📝 檔案格式規範
activeContext.md
# Active Context
> Last updated: 2026-01-15
## 🎯 當前焦點
[一句話描述正在處理的主要任務]
## 📁 相關檔案
- `path/to/file1.py` - [用途說明]
- `path/to/file2.ts` - [用途說明]
## ⚠️ 待解決問題
- [ ] 問題 1
- [ ] 問題 2
## 💡 備註
[其他需要記住的事項]
progress.md
# Progress
## Done ✅
- [x] 已完成任務 1 (2026-01-15)
- [x] 已完成任務 2 (2026-01-14)
## Doing 🚧
- [ ] 進行中任務 1
- [ ] 進行中任務 2
## Next 📋
- [ ] 計劃任務 1
- [ ] 計劃任務 2
decisionLog.md
# Decision Log
## 2026-01-15
### 決策:選擇 React 作為前端框架
- **背景**:需要選擇前端框架
- **選項**:React, Vue, Svelte
- **決定**:React
- **原因**:團隊熟悉度高,生態系完整
---
## 2026-01-14
### 決策:...
⚡ 更新原則
1. 增量更新
✅ 正確:只修改相關區塊
❌ 錯誤:每次都覆寫整個檔案
2. 保持簡潔
✅ 正確:「完成用戶認證模組」
❌ 錯誤:「今天我們完成了用戶認證模組的開發工作,包括...」
3. 時間標記
✅ 正確:- [x] 完成功能 A (2026-01-15)
❌ 錯誤:- [x] 完成功能 A
4. 檔案路徑完整
✅ 正確:`src/domain/entities/User.py`
❌ 錯誤:`User.py`
🔄 與其他 Skills 整合
| Skill | 整合方式 |
|---|---|
memory-checkpoint | checkpoint 後呼叫 updater 寫入 |
git-precommit | commit 前強制更新 progress.md |
feature-development | 功能完成後更新 Done |
📊 輸出格式
執行完成後回報:
📝 Memory Bank 已更新
更新內容:
- ✅ activeContext.md - 更新當前焦點
- ✅ progress.md - 新增 1 個 Done 項目
- ⏭️ decisionLog.md - 無變更
下次記得:完成重要任務後執行「更新 memory bank」