memory-management

memory-management 技能總覽

memory-management 技能實際在做什麼

memory-management skill 讓 Claude 能用可重複執行的方式，把專案脈絡跨工作階段保存下來，不必每次都重新摸索同一批事實。這個 repository 裡的設計主要面向 SEO 與 GEO 工作流，採用三層式記憶模型：把高頻資訊放在 CLAUDE.md 的 hot cache、把結構化專案記憶放在 memory/ 底下，較舊的細節則移到封存層。

哪些人適合安裝 memory-management

這個 memory-management skill 最適合持續進行、會跨多個 session、而且脈絡很容易流失的工作情境：像是關鍵字追蹤、競品監控、稽核、活動進度、術語表，以及週期性報表。對於在做 memory-management for Context Engineering 的團隊尤其有用，因為真正的難題往往不是生出單次答案，而是如何讓正確的事實能在一段時間內持續可用。

真正要解決的工作需求

多數使用者其實想達成以下四種結果之一：

• 把重要的專案決策留到之後可查
• 不用重新上傳全部資料，也能直接問「我們目前知道哪些事？」
• 讓正在進行的優先事項保持可見，同時把笨重細節移去封存
• 在例行事件發生後，例如 rank check 或 audit，能一致地更新記憶

這個技能的價值，在於它把模糊的「記住這件事」轉成明確的檔案結構與更新流程。

它和一般 prompt 真正不同在哪裡

一般 prompt 也可以叫 Claude 記住事情，但這個技能補上了操作規則：

• 明確的 HOT/WARM/COLD 結構
• CLAUDE.md 與 memory/glossary.md 的模板
• 決定哪些內容要升級／降級可見性的規則
• 在 audit、report、ranking check 後觸發更新的事件式邏輯

因此輸出結果會比把臨時筆記全塞進單一檔案更容易維護。

最適合與不適合的使用情境

最適合：

• 會持續更新的 SEO 專案
• 週期長、不中斷的 campaign 工作
• 已經把 CLAUDE.md 納入日常工作流的 repository
• 想要一套有文件依據的記憶系統，而不只是聊天紀錄的使用者

不適合：

• 一次性任務
• 幾乎沒有重複脈絡的小型專案
• 期待像資料庫一樣自動持久化、但不想維護檔案的使用者
• 非檔案式工作流，且沒有人會檢查或更新記憶產物的情境

如何使用 memory-management 技能

安裝前的環境與相容性

這個 repository 標示支援 Claude Code ≥1.0、skills.sh marketplace、ClawHub marketplace 與 Vercel Labs skills ecosystem。不需要額外安裝系統套件。只有在你想接上 SEO 工具時，才會牽涉到可選的 MCP 網路存取；核心的 memory-management install 與工作流程本身仍然是以檔案為基礎。

如果你的環境支援 marketplace 風格的 skill 安裝，常見用法是：

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill memory-management

如果你的環境使用不同的 skill loader，就把它指向 repo 中的 cross-cutting/memory-management。

使用 memory-management 前，先讀這些檔案

想快速上手，不必照順序把整個 repository 看完。建議先從這些開始：

1. cross-cutting/memory-management/SKILL.md
2. cross-cutting/memory-management/references/hot-cache-template.md
3. cross-cutting/memory-management/references/update-triggers-integration.md
4. cross-cutting/memory-management/references/promotion-demotion-rules.md
5. cross-cutting/memory-management/references/examples.md
6. cross-cutting/memory-management/references/glossary-template.md

這條閱讀路徑可以讓你先掌握操作模型、檔案長相、更新觸發條件，以及具體範例，減少自己猜的成本。

這個技能需要你提供哪些輸入

memory-management usage 的效果，非常取決於你一開始提供的專案脈絡。至少要給出：

• 專案名稱
• 專案類型與範圍
• 目前主要目標關鍵字或優先事項
• 核心競爭對手
• 正在進行的 campaign 或 audit
• 你希望記憶儲存在 repo 的哪裡
• 哪些內容要保持「hot」，哪些要封存

如果缺少這些資訊，Claude 雖然還是能幫你建立結構，但結果通常會偏通用、實用性也較低。

初始化記憶結構

第一次實際操作時，建議先請 Claude 初始化：

• 把 CLAUDE.md 設成 hot cache
• 建立 memory/glossary.md
• 視需要建立 audits、research、monitoring、archives 等子資料夾

適合的第一個 prompt：

Initialize the memory-management skill for this SEO project. Create CLAUDE.md as a hot cache, create memory/glossary.md, and propose a minimal memory/ folder structure for rankings, competitors, audits, and reports. Use only sections we will realistically maintain.

最後一句很重要。模板本身設計得不錯，但如果一開始把整棵記憶樹搭得太大，很快就會累積維護債。

把模糊目標改寫成更有效的啟動 prompt

弱的 prompt：

Remember this project.

強的 prompt：

Use the memory-management skill for this project. Save the following into a hot/warm/cold structure:

• Project: Acme SEO
• Hero keywords: technical seo audit, free backlink checker, content optimization guide
• Priority this month: recover rankings after migration
• Top competitors: example1.com, example2.com
• Recent event: technical audit completed on 2025-01-10
• Keep active priorities in CLAUDE.md
• Archive full audit details under memory/audits/technical/
  Then show me what was stored where.

這樣寫有效，原因在於：

• 明確點出 skill 的使用意圖
• 把目前活躍的事實和詳細產物分開
• 要求的是內容放置位置，而不只是摘要
• 讓最後輸出可被稽核、可回頭檢查

適合長期專案的 memory-management 工作流

日常使用中，一份高訊號的 memory-management guide 通常會長這樣：

1. 初始化 CLAUDE.md 與核心 memory/ 資料夾。
2. 先填入 hero keywords、competitors、priorities 與 key metrics。
3. 每次重大事件後，同步更新 hot cache 與帶日期的產物檔案。
4. 定期把已過時的項目從 CLAUDE.md 降級移出。
5. 先請 Claude 從 hot cache 做摘要，只有真的需要時再往下拉更深層紀錄。

這樣可以讓高頻脈絡維持快速可取，同時把細節妥善留在其他地方。

什麼情況下應該觸發這個技能

這個 repository 提供了像下面這些 trigger language：

• “remember project context”
• “save SEO data”
• “track campaign progress”
• “what did we decide last time”
• “what do we know so far”
• “remember this for next time”

實務上，應該在對話中產生了可重複利用的專案狀態時觸發 memory-management，而不是每次出現一次性推理內容都存。

用更新觸發條件，不要隨手亂倒筆記

這個技能最強的一部分之一，是 references/update-triggers-integration.md 裡的事件驅動更新邏輯。典型模式如下：

• rank check 後，更新關鍵字表格並儲存帶日期的排名歷史
• competitor analysis 後，更新 hot cache 並保存完整報告
• audit 後，把最高優先的行動項目抽進 CLAUDE.md，完整 audit 另存
• monthly report 後，刷新 metrics，並把已過時工作移去封存

這就是可長期使用的記憶系統，和一堆散亂筆記之間的差別。

如何判斷哪些內容該放進 CLAUDE.md

CLAUDE.md 只應該放你經常需要用到的項目：

• 核心關鍵字
• 主要競爭對手
• 目前活躍的優化優先事項
• 最近的重要指標
• 當前 campaign 狀態

不要把每一條觀察都丟進去。repo 裡的升級／降級規則之所以實用，是因為它逼你做判斷：哪些資訊需要立即取回，哪些可以先放在 memory/，等有需要再提取？

能提升輸出品質的實用 prompt 寫法

盡量使用能強制結構與門檻的 prompt：

• “Promote only keywords mentioned 3+ times recently.”
• “Demote anything stable and inactive for 60+ days.”
• “Extract only the top 5 action items from this audit into hot cache.”
• “Save the full report, but keep the summary under 150 words in CLAUDE.md.”

這些寫法呼應了 repository 裡的規則，比起開放式的 “store this” 指令，通常能產出更乾淨的記憶結構。

常見導入錯誤：把它當成自動記憶

成功使用 memory-management usage 最大的阻礙，通常是以為它會自動、隱性地持久保存。這個技能是一套工作流，不是會魔法般自動回想的功能。你仍然需要：

• 初始化檔案
• 在有意義的事件後主動要求更新
• 檢查 hot cache 是否過載
• 維持命名與資料夾慣例的一致性

如果沒有人維護這層記憶，後續檢索品質就會逐步下滑。

memory-management 技能 FAQ

memory-management 只能用在 SEO 專案嗎？

不是，但這個實作很明顯是為 SEO/GEO 工作最佳化。範例、模板與更新觸發條件，幾乎都圍繞在 keywords、competitors、audits 與 reports。你可以把它改造成其他長週期知識工作流，但如果是開箱即用的契合度，SEO 營運場景仍然最合適。

這比直接用 chat history 更好嗎？

如果工作會跨很多個 session，或會有多人協作，那答案是是的。chat history 很難查詢、很容易遺失，也不適合拿來承載專案狀態。memory-management skill 會把重要脈絡外部化成檔案，讓 Claude 能系統化地回看與更新。

memory-management 對新手友善嗎？

整體來說算友善。模板能明顯降低起手設定成本，尤其是 hot-cache-template.md 和 glossary-template.md。新手最大的難點，通常是判斷哪些內容該進 hot cache、哪些應該進 archive。只要一開始不要做太大，這套系統是好上手的。

什麼情況下不該使用 memory-management？

以下情況可以直接略過：

• 你的工作是一次性的
• 專案幾乎沒有重複脈絡
• 你不希望 repository 檔案被修改
• 你不太可能長期維護 memory 資料夾

在這些情境裡，一般 prompt 或單一摘要檔案可能就已經夠用。

memory-management 需要外部工具嗎？

不需要。核心運作是檔案式的。外部 SEO 工具或 MCP 存取都只是可選配，主要是在需要更新 rankings 或 audits 時，幫你取得新的資料。

它和寫一份大型專案總結有什麼不同？

單一摘要檔很容易變得過時又膨脹。memory-management for Context Engineering 之所以更有效，是因為它把不同性質的資訊拆開：

• 把活躍脈絡放在 CLAUDE.md
• 把結構化參考資料放在 memory/
• 把歷史細節封存在其他位置

這種分層能同時提升檢索速度與維護性。

如何把 memory-management 技能用得更好

一開始的 hot cache 要比你想像中更小

最常見的失敗模式，就是 CLAUDE.md 塞太滿。如果所有東西都算「重要」，就沒有任何資訊能被快速取回。hot cache 應該只聚焦在目前進行中的決策、當前目標與最新狀態；細節則推到 memory/ 底下帶日期的檔案。

提供更強的來源輸入

memory-management 的結果好不好，很大程度取決於你的來源材料品質。與其寫：

Save our audit findings.

不如寫成：

Save this technical audit. Put the full report in memory/audits/technical/2025-01-10-core-web-vitals.md. Extract the top 3 issues, expected impact, and owner into CLAUDE.md. Add any new recurring terms to memory/glossary.md.

這樣 Claude 才知道要存什麼、存到哪裡，以及哪些內容應該進 hot layer。

使用一致命名與帶日期的產物檔案

當檔案命名遵循固定模式時，後續檢索會明顯更順，例如：

• memory/audits/technical/YYYY-MM-DD-name.md
• memory/research/competitors/YYYY-MM-DD-analysis.md
• memory/monitoring/rank-history/YYYY-MM-DD-ranks.csv

這點很重要，因為之後的 prompt 就可以直接引用命名模式，而不是每次都去翻找臨時取的檔名。

明確套用升級與降級規則

不要只靠直覺判斷。repository 裡的規則相當務實：

• 經常被引用或變化很快的項目升級
• 穩定、不活躍或已完成的項目降級
• 按固定週期檢查 hot cache

如果你要求 Claude 明確執行這些規則，整套記憶系統能維持可用的時間會更長。

每次更新後都要求放置摘要

每次儲存後，建議補一句：

Show exactly what you updated in CLAUDE.md, what you stored in memory/, and what you decided not to keep hot.

這樣可以提早抓出分類錯誤，也能讓你更信任自己圍繞這個技能建立的 memory-management guide。

第一版輸出後要再迭代

第一次產出通常不是太廣，就是太淺。可以用下面這類追問逐步修正：

• “Reduce hot cache to only this quarter’s priorities.”
• “Move completed campaign details out of CLAUDE.md.”
• “Add missing competitor shorthand to memory/glossary.md.”
• “Create a monthly archive routine from the existing files.”

好的記憶系統通常不是一次做對，而是經過幾輪調整後才會順手。

把檢索請求和更新請求綁在一起

面對長期工作時，最好把提問與維護一起做：

What do we know so far about hero keywords, and update the hot cache if any targets are stale?

這種寫法能讓記憶在使用過程中同步維護，而不是等到之後才另外安排清理，結果越放越漂移。