Community程式設計與開發github.com

記憶同步

在會話開始時載入記憶,結束時整理壓縮,保持記憶溫熱且精簡。

記憶同步 是什麼?

這個技能(TheElephantCoder/memory-sync)旨在解決 AI 助手在多次會話中「冷啟動」的問題。其核心原理是採用結構化的目錄佈局,將記憶分為「始終載入」(如 MEMORY.md、熱層)、「關鍵字觸發」(溫層)和「明確讀取」(冷層、原始會話)等不同層級,以平衡上下文窗口與反應速度。在每次會話開始時,它只快速讀取精選記憶(目標低於 15 秒);在會話結束時,透過命令或退出鉤子自動執行同步,將本次會話的摘要提煉進 MEMORY.md,清理過期 session 記錄,並對重要決策自動撰寫輕量的架構決策記錄。此技能支援 Claude Code 等基於檔案系統的工具,適用於需要長期記憶且每次啟動時間有限的開發者,能幫助 AI 維持對專案和使用者的一致認知,同時避免記憶體膨脹。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheElephantCoder/agent-harness/tree/main/skills/memory-sync

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

記憶同步 是做什麼的?

避免會話從冷啟動開始。

目錄結構

memory/
  MEMORY.md        # 精選記憶,始終載入,保持在 8k 以下
  SOUL.md          # 定義 AI 的角色定位
  USER.md          # 使用者資訊
  sessions/        # 每次會話的原始筆記,約 30 天後清理
  decisions/       # 簡短的架構決策記錄
  tiers/
    hot.md         # 始終載入
    warm.md        # 關鍵字觸發時載入
    cold/          # 僅在明確要求時讀取

生命週期

開始:讀取 MEMORY.md 和 tiers/hot.md。如果任務匹配,可選讀 warm.md。除非需要追溯歷史,否則不要讀取 sessions/。整個過程應在 15 秒內完成。

結束:執行 harness memory sync 或讓退出鉤子自動處理。它會將會話記錄提煉進 MEMORY.md,修剪過時內容,並在做出實際決策時新增一則 ADR。

提示

  • MEMORY.md 是經過精心策劃的,不是單純附加。保持在 8k token 以下,進行精準編輯。
  • 如果你考慮過兩種以上方案並選擇了其中一種,請撰寫簡短的 decisions/ADR-###.md。
  • 記憶中不要存放機密資料,系統會自動將其移除。

命令:

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能