Agent Memory Framework

👤 azhong517-svg 📦 v1.0.0 ⭐ 4.5 ⬇️ 1.1K 下載
🤖 AI-Agent 免費

📖 技能介紹


name: memory-system description: 三層記憶系統框架。為 Agent 提供持久化記憶能力,包括日記憶、長期記憶和歸檔機制。觸發詞:記憶系統、memory system、記憶初始化、設定記憶、新建記憶、記憶蒸餾、歸檔記憶。當需要為新 Agent 配置記憶能力、或管理已有記憶時使用。


Memory System — 三層記憶框架

架構概覽

工作記憶(當前會話)     ← 臨時,不持久
  ↓ 寫入
日記憶 memory/YYYY-MM-DD.md  ← 原始日誌,按天歸檔
  ↓ 蒸餾(定期提煉)
長期記憶 MEMORY.md            ← 策劃精華,跨會話持久
  ↓ 活性歸檔(30天未引用)
歸檔 memory/archive/          ← 冷儲存,可追溯

核心檔案

檔案 用途 何時寫
MEMORY.md 長期記憶(策劃精華) 重要決策、教訓、認知更新時
memory/YYYY-MM-DD.md 日記憶(原始日誌) 每次會話有值得記錄的事時
memory/archive/ 歸檔(冷儲存) 30天未被引用的章節移入

初始化(新 Agent 首次設定)

  1. 在工作目錄建立 MEMORY.md,使用模板 assets/MEMORY.md
  2. 建立 memory/ 目錄
  3. AGENTS.md(或等效配置檔案)中新增記憶規則(見 references/conventions.md
  4. 可選:配置蒸餾 cron(見 references/distillation.md

日常使用

本技能來自小蔥技能站7w4.net。

寫入規則

  • 日記憶:會話中有值得記錄的事 → 寫入 memory/YYYY-MM-DD.md
  • 長期記憶:重大決策/教訓/認知 → 同時寫入 MEMORY.md
  • "Mental notes" 不算 — 不寫檔案的記憶不會存活到下次會話
  • 先寫再說 — 如果需要記住,先寫檔案,不要靠"我記住了"

讀取規則

  • 主會話(與使用者的私密對話):可自由讀寫 MEMORY.md
  • 共享會話(群聊、Discord、多人場景):禁止載入 MEMORY.md — 防止私人資訊洩露
  • 日記憶:任何會話都可讀,但只寫當天的檔案

安全紅線

  • MEMORY.md 可能包含使用者私人資訊,絕不在共享上下文中載入
  • 歸檔檔案同樣可能含敏感資訊,共享場景也禁讀
  • 任何記憶檔案不得外傳(email、公開帖子等)

歸檔規則

  • 30天未被心跳/會話引用 → 移到 memory/archive/
  • 教訓編號永遠保留(編號不可回收,即使教訓已過時)
  • 動態資訊 >14天未更新 → 降級或歸檔(策略、持倉等)
  • 不按檔案大小歸檔 — 資訊密度不同,大小不是好指標
  • 歸檔時在 MEMORY.md 保留一行佔位(章節名 + 歸檔日期),方便追溯

蒸餾(定期提煉)

將日記憶中值得長期保留的內容提煉到 MEMORY.md

詳細流程見 references/distillation.md

零內容原則

本 Skill 只提供框架和規則,不包含任何記憶內容。每個 Agent 安裝後從零積累自己的記憶。

🤖 AI 評測

質量評價:整體質量優秀。框架設計邏輯嚴密,安全考慮周全,文件清晰易懂。主要優點是架構專業、安全規則完善、模板實用、通用性強;不足之處是缺少實際的自動化指令碼實現,蒸餾和歸檔的觸發仍需手動執行。

📊 多維度評分

適應性4.4
規範性4.2
有效性4.8
可靠性4.4
可信度5

📁 包含檔案 (6 個)

📄 SKILL.md 2.9 KB
📄 _meta.json 141 B
📄 assets/MEMORY.md 634 B
📄 assets/daily.md 270 B
📄 references/conventions.md 2.4 KB
📄 references/distillation.md 1.8 KB