前言¶

每次會話都會把 .workbuddy/memory/ 裏的文件讀進上下文。文件越多、越大，消耗的 token 越多，成本越高、響應也越慢。常規做法是手動刪減、加檢索過濾，或者乾脆把整個目錄重寫一遍——這些做法要麼一刀切，要麼缺乏治理。Memory Manager EN-V4.0.6 的定位是”token 節流閥”：不是把記憶刪除，而是讓進入上下文的記憶更小、更精確，並且在每次寫入前後都有治理和回滾手段。下面介紹這個 Skill 是什麼、能做什麼、怎麼用。

這是什麼¶

Memory Manager EN-V4.0.6 是一個面向 AI Agent 的記憶管理 Skill，座標 @indiv-aakook/memory-manager-en，社區（community）來源，版本 4.0.6，分類 ai-agent，無需 API Key。它圍繞 .workbuddy/memory/ 這個目錄，把”省 token”拆成四件事：寫入治理、安全加固、檢索可見性、按相關性加載，並附帶 token 計量與預算壓縮。

核心功能¶

寫入治理循環（governance loop）¶

• 寫入衛生審計（write-hygiene audit）：檢查記憶文件是否寫得過長、結構混亂。
• 快照與回滾（snapshot rollback）：每次寫入前自動做快照，任何時候都能回滾。
• 壓縮（compact compaction）：對記憶內容做壓縮，減小進入上下文的體積。
• token 節約看板（dashboard token-savings board）：展示省下了多少 token。
• 五維健康檢查（health five-dimension checkup）：從五個維度體檢記憶目錄狀態。

安全加固（security hardening）¶

• 寫命令需要確認門（confirmation gates on write commands），避免誤寫。
• SHA256SUMS 完整性清單，備份和快照都支持 --verify 校驗。
• 權限收緊到 0700 / 0600。
• 拒絕 ZIP 路徑穿越和超大成員，防止惡意壓縮包寫入。

選擇器可見性（selector visibility）¶

• selector-audit 只讀就緒檢查：告訴你當前哪些記憶會被選進上下文。
• describe 回填 front-matter 描述：給缺少描述的記憶補上 front-matter，提升被正確選擇的概率。

按相關性加載（task-relevance loading）¶

通過 --query / --tags / --top-k 三個參數按需加載，匹配邏輯是零依賴的 CJK 雙字組合（bigram）加 keyword/tag 相關性，並帶 90 天新近度衰減（recency decay）——越久沒動過的記憶權重越低。

token 計量與預算¶

• 使用真實 tiktoken 做計量，不是估算公式。
• 超出預算自動觸發壓縮（over-budget auto-compaction）。
• 一鍵節流（throttle one-click budget compression）：手動壓縮預算。
• 三色預算告警（tri-color budget alerts）：用顏色提示預算消耗程度。
• --json 覆蓋各個子命令，方便程序化調用。
• 內置自檢（self-test）。

性能與易用性¶

• 並行摘要（parallel summaries）、排名緩存（rank cache）、讀取短路（read short-circuit）。
• 33 個短別名，覆蓋日常操作。
• 所有 token 數字標註 “estimated”（估算值），避免把估算當實測。

安裝與啓用¶

SkillHub 頁面（https://www.skillhub.cn/skills/indiv-aakook/memory-manager-en）目前無法抓取，官方安裝命令、目錄結構與配置字段未能在本次覈對中核實。本篇不給出未經覈實的安裝命令，請以官方頁面爲準。啓用方式按通用 SKILL.md 格式：在支持 Skill 的客戶端（Cursor / Codex CLI / Claude Code 等）中加載該 Skill 後即可使用。

典型用法¶

以下用法來自官方簡介中已覈實的能力描述，具體命令與參數示例以官方頁面爲準。

1、按需加載記憶：--query 按查詢詞、--tags 按標籤、--top-k 限制返回條數，只把相關的記憶帶進上下文。

2、校驗備份與快照：執行備份或快照相關操作時加 --verify，用 SHA256SUMS 清單校驗完整性。

3、審計選擇情況：運行 selector-audit，查看哪些記憶會被選進上下文，再用 describe 回填缺失的 front-matter 描述。

4、查看 token 消耗：運行 dashboard 看板，或對任意子命令加 --json 獲取結構化的 token 數據。

5、寫入前快照：每次寫入自動做快照，需要時回滾到寫入前狀態。

適用場景與注意¶

適合以下場景：

• 記憶目錄隨會話越滾越大、token 成本明顯上升的 Agent 工作流。
• 需要審計記憶爲什麼沒被選進上下文的情況。
• 需要對記憶做定期體檢、備份校驗、壓縮治理的團隊。

不適合以下場景：通用文件操作、代碼分析、系統清理、文檔編輯——這些不是它的職責範圍。

注意：本篇中所有命令與參數的能力描述均來自官方簡介，未在本次覈實中逐條運行驗證；安裝命令與配置字段未能從官方頁面覈實，請以官方頁面爲準。

結尾¶

Memory Manager EN-V4.0.6 的價值在於把”省 token”這件事從一次性的刪減變成持續的治理：寫入有審計和快照、加載按相關性、消耗有計量和預算、損壞有校驗。如果你的工作流在上下文裏塞了越來越多的記憶文件，值得把它放進候選名單。

• SkillHub 頁面：https://www.skillhub.cn/skills/indiv-aakook/memory-manager-en
• 官方地址：https://api.skillhub.cn/indiv-aakook/memory-manager-en