Agent skill

memory-updater

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/memory-updater

SKILL.md

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

markdown
# Active Context

> Last updated: 2026-01-15

## 🎯 當前焦點

[一句話描述正在處理的主要任務]

## 📁 相關檔案

- `path/to/file1.py` - [用途說明]
- `path/to/file2.ts` - [用途說明]

## ⚠️ 待解決問題

- [ ] 問題 1
- [ ] 問題 2

## 💡 備註

[其他需要記住的事項]

progress.md

markdown
# Progress

## Done ✅

- [x] 已完成任務 1 (2026-01-15)
- [x] 已完成任務 2 (2026-01-14)

## Doing 🚧

- [ ] 進行中任務 1
- [ ] 進行中任務 2

## Next 📋

- [ ] 計劃任務 1
- [ ] 計劃任務 2

decisionLog.md

markdown
# 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」

Didn't find tool you were looking for?

Be as detailed as possible for better results