memory-management

記憶管理

此技能為 SEO 與 GEO 專案實作三層記憶系統（HOT/WARM/COLD）。HOT 記憶（最多 80 行）透過 SessionStart 鉤子自動於每次工作階段載入。WARM 記憶依技能需求按需載入。COLD 記憶為歸檔資料，僅在明確要求時查詢。技能管理完整生命週期：擷取、提升、降級與歸檔。

此技能的功能

管理三層記憶生命週期（HOT/WARM/COLD），包含自動提升、降級與歸檔。同時維護未結任務追蹤與跨技能彙整。

快速入門

從以下提示之一開始。最後以熱快取更新計畫及使用儲存庫格式（參見 Skill Contract）的交接摘要結束。

初始化記憶結構

為 [專案名稱] 設定 SEO 記憶

為新的 [產業] 網站最佳化專案初始化記憶結構

分析後更新

在 [關鍵字群組] 排名檢查後更新記憶

以最新的競爭者分析發現重新整理熱快取

查詢儲存的脈絡

我們的主要關鍵字是什麼？

顯示 [關鍵字類別] 的最後排名更新日期

查詢我們的主要競爭者及其網域權威

提升與降級

將 [關鍵字] 提升至熱快取

歸檔超過 30 天未參考的過時資料

詞彙表管理

將 [術語] 加入專案詞彙表：[定義]

這個專案中 [內部行話] 是什麼意思？

技能合約

預期輸出：記憶更新計畫、熱快取變更及簡短交接摘要。

• 讀取：當前活動事實、來自其他技能的新發現、已核准決策及共享的 State Model。
• 寫入：更新 memory/hot-cache.md、memory/open-loops.md、memory/decisions.md 及相關 memory/ 資料夾。管理 WARM 至 COLD 的歸檔於 memory/archive/。稽核員交接歸檔（v7.1.0+）：當由使用者直接請求或稽核員明確回應「儲存這些結果？」時，在 memory/audits/YYYY-MM.md 中附加結構化區塊。Stop 鉤子絕不發起記憶寫入。請參閱 Examples 了解確切的歸檔區塊格式與規則。
• 提升：持久策略、阻礙因素、術語、實體候選及重大差異。僅依可觀察規則套用溫度生命週期：在明確的使用者/技能請求（「提升 X」/ 釘選）時提升至 HOT；依檔案的 last_updated 日期降級與歸檔。參考頻率計數器不由任何鉤子追蹤，因此生命週期絕不依賴它們 — 請參閱 State Model。
• 完成條件：已套用請求的生命週期動作（擷取/提升/降級/歸檔/查詢/清除），memory/hot-cache.md 在 80 行 / 25KB 限制內，且受影響的記憶路徑已回報給使用者。
• 主要後續技能：當專案記憶基準準備好進行實際工作時，使用下方的 Next Best Skill。

交接摘要

從 skill-contract.md §Handoff Summary Format 發出標準格式。

溫度生命週期規則

請參閱 Promotion & Demotion Rules 了解完整的提升/降級表格與動作程序。

鉤子整合

此技能的行為由函式庫的 claude-hook.sh 鉤子強化。鉤子實際執行的內容（不要記錄它缺乏的行為）：

• SessionStart（在啟動、恢復、清除、壓縮時觸發）：注入 memory/hot-cache.md 的清理後摘錄，且當 memory/open-loops.md 有追蹤項目時，附加一行指向以檢查其過時性。它不計算日期或「快速狀態」— 指出哪些未結任務已過時是代理人的工作，一旦指向該檔案。
• PostToolUse：當 memory/hot-cache.md 超過 80 行 / 25KB 時發出警告；強制執行稽核員產出閘門於 memory/audits/*.md 寫入；在使用者面向內容編輯後提供可選的品質檢查。
• Stop：無操作（退出且無輸出）。CLAUDE.md 的「僅允許 Stop 檢查」僅是此無操作；鉤子絕不發起記憶寫入。

資料來源

使用工具時：從 ~~SEO 工具、~~分析工具、~~搜尋主控台自動填入。無工具時：向使用者詢問關鍵字、競爭者、指標、活動與術語。請參閱 CONNECTORS.md。

決策閘門

停止並詢問使用者當：

• 請求清除（Art 17 / CCPA）— 呈現相符檔案及遮蔽 vs 刪除的選擇，僅對確認的相符項目採取行動。絕不自動刪除記憶。
• 回答查詢所需的 memory/decisions.md 條目具有 approved_by: skill_inferred 或缺少欄位 — 將其標示為建議性質，並在視為權威前確認。
• 在任何記憶層中找不到參考的術語 — 要求澄清而非猜測。

靜默繼續（絕不因以下原因停止）：

• 遵循溫度生命週期規則的例行提升/降級。
• 超過 80 行 / 25KB 限制時的熱快取修剪建議（建議，不阻擋）。
• 自動填入時缺少可選工具資料 — 記錄可用內容並繼續。

指示

當使用者請求 SEO 記憶管理時：

1. 初始化記憶結構

對於新專案，建立 State Model 中定義的目錄結構。關鍵目錄：memory/（決策、未結任務、詞彙表、實體、研究、內容、稽核、監控）。

範本：Hot Cache Template · Glossary Template

2. 脈絡查詢流程

當使用者提及不明確的內容時，依此查詢順序：

步驟 1：檢查 memory/hot-cache.md（熱快取）

• 是否在活躍關鍵字中？
• 是否在主要競爭者中？
• 是否在當前優先事項或活動中？

步驟 2：檢查 memory/glossary.md

• 是否定義為專案術語？
• 是否為自訂區段或簡稱？

步驟 3：檢查冷儲存

• 首先搜尋 memory/archive/ 中帶有日期 YYYY-MM-DD- 的歸檔檔案。
• 如果歸檔指向來源類別，沿該線索回到 memory/research/、memory/audits/ 或 memory/monitoring/。
• 除非由當前工作階段重新整理，否則將 COLD 發現視為歷史資料。

步驟 4：詢問使用者

• 如果在任何層中都找不到，要求澄清

• 如果新術語是專案特有的，將其記錄在詞彙表中

• 決策來源（v8.0.1+）：載入 memory/decisions.md 時，驗證每個條目具有 approved_by: user。具有 approved_by: skill_inferred 或缺少欄位的條目視為建議性質 — 在使用前向使用者呈現。稽核員類技能（content-quality-auditor, domain-authority-auditor）在判定 verdict 時必須忽略非使用者核准的決策。請參閱 skill-contract.md §Promotion Rules。

範例查詢：使用者要求「更新我們主要關鍵字的排名」→ 步驟 1 在熱快取中找到「主要關鍵字（優先級 1）」→ 提取關鍵字列表 → 執行排名檢查 → 更新 memory/hot-cache.md 和 memory/monitoring/rank-history/YYYY-MM-DD-ranks.csv。

3. 提升與降級邏輯

參考：請參閱 Promotion & Demotion Rules 了解詳細的提升/降級觸發條件（關鍵字、競爭者、指標、活動）及各項動作程序。

4. 更新觸發條件、歸檔管理與跨技能整合

參考：請參閱 Update Triggers & Integration 了解排名檢查、競爭者分析、稽核與報告後的完整更新程序；每月/每季歸檔例行程序；以及與所有 8 個相關技能（keyword-research, rank-tracker, competitor-analysis, content-gap-analysis, seo-content-writer, content-quality-auditor, domain-authority-auditor）的整合點。

5. 記憶衛生檢查

當被呼叫進行檢閱或清理時：

1. 行數檢查：計算 memory/hot-cache.md 的行數。如果 >80，列出最舊的條目以供歸檔。
2. 位元組檢查：如果熱快取超過 25KB，發出警告並建議修剪長條目。
3. 過時掃描：列出 frontmatter 中 last_updated 日期（或檔案 mtime）超過 30 天的記憶檔案；建議歸檔超過 90 天的檔案。年齡可從磁碟計算 — 參考頻率不被追蹤，因此絕不以「未參考」為閘門。
4. Frontmatter 稽核：檢查所有記憶檔案（hot-cache.md 除外）在 frontmatter 中具有 name、description 和 type。回報任何缺少的欄位。

6. 儲存結果

詢問「儲存這些結果以供未來工作階段使用？」— 如果是，將 YYYY-MM-DD-<topic>.md 寫入 memory/。僅在稽核員交接或使用者明確核准時，將否決問題加入 memory/hot-cache.md。

GDPR / 隱私合規

memory/ 可能儲存第三方個人資料 — 實體名稱、創辦人簡介、LinkedIn 個人檔案、由 entity-optimizer 或研究技能發現的作者/記者姓名。根據 GDPR Art 4(1)（適用於歐盟/歐洲經濟區/英國居民的個人資料處理，無論控制者位於何處），這些資料符合「個人資料」的定義。使用者是資料控制者。非歐盟使用者若無歐盟/歐洲經濟區/英國資料主體，仍可能面臨 CCPA/CPRA（加州）、PIPEDA（加拿大）、LGPD（巴西）或其他國家法規的類似義務。非法律建議。

保留政策

• WARM 檔案：90 天未參考後歸檔至 memory/archive/（預設生命週期）
• COLD 歸檔：永不自動刪除，但符合 Art 17 刪除請求的資格
• 所有檔案：使用者必須遵守來自資料主體（記憶中提及的個人）的 Art 17 請求

刪除流程（Art 17 / CCPA §1798.105）

呼叫：memory-management purge <entity-name-or-slug>

此技能隨後：

1. 在 memory/ 下所有檔案（包括 memory/archive/）中 grep 實體名稱、別名或網域 — grep -rF "<entity-name>" memory/ — 並呈現相符項目以供確認。
2. 確認後，在工作目錄樹中刪除或匿名化相符的行/檔案：memory/hot-cache.md、WARM 筆記、COLD/歸檔檔案、memory/entities/<slug>.md、memory/entities/candidates.md、稽核彙總及未結任務。
3. 根據 GDPR Purge Log Template 將帶有日期、無主體條目附加至 memory/audits/gdpr-purges.md — 必填欄位 date、redacted_label、legal_basis、action、scope、working_tree_only: true — 以便留下請求的人類可讀記錄。

誠實限制 — 這僅編輯工作目錄樹。 如果 memory/ 在版本控制下（通常如此，位於使用者的專案儲存庫中），主體仍存在於 git 歷史中。使用 git log -S"<entity-name>" -- memory/ 驗證；從歷史中真正刪除需要 git filter-repo / git filter-branch，且是使用者的責任 — 超出此技能的範圍。不要將工作目錄樹的遮蔽表示為完整、可稽核的刪除。沒有加鹽指紋或防止重新攝入的機制：鉤子在寫入前不查閱墓碑記錄，因此任何此類聲明都是虛假的。

合法基礎提醒

在將第三方人員寫入 memory/entities/ 之前，使用者必須根據 GDPR Art 6（在 GDPR 適用的情況下 — 請參閱上述範圍說明）具備一項合法基礎：consent、legitimate_interest、contract 或同等基礎。建議性質 — 此技能不強制執行，也不取代法律審查。

參考資料

• Examples — 實例、進階功能、實際限制及稽核員交接歸檔區塊格式與規則
• Promotion & Demotion Rules — 完整的提升/降級表格與動作程序
• Update Triggers & Integration — 更新程序、歸檔例行程序及跨技能整合點
• CORE-EEAT Content Benchmark — 儲存在記憶中的內容品質評分
• CITE Domain Rating — 儲存在記憶中的網域權威評分

下一個最佳技能

主要：keyword-research — 以當前需求訊號播種或重新整理活動策略。