File-based memory system using Tiago Forte's PARA method. Use this skill whenever you need to store, retrieve, update, or organize knowledge across sessions. Covers three memory layers: (1) Knowledge graph in PARA folders with atomic YAML facts, (2) Daily notes as raw timeline, (3) Tacit knowledge about user patterns. Also handles planning files, memory decay, weekly synthesis, and recall via qmd. Trigger on any memory operation: saving facts, writing daily notes, creating entities, running weekly synthesis, recalling past context, or managing plans.
PARA 記憶檔案
以 Tiago Forte 的 PARA 方法組織的持久化檔案型記憶。三個層次:知識圖譜、每日筆記與內隱知識。所有路徑皆相對於 $AGENT_HOME。
三個記憶層
層次 1:知識圖譜 ($AGENT_HOME/life/ -- PARA)
以實體為基礎的儲存。每個實體有一個資料夾,包含兩層:
summary.md-- 快速脈絡,優先載入。items.yaml-- 原子化事實,按需載入。
$AGENT_HOME/life/
projects/ # 具有明確目標/截止日期的活躍工作
<name>/
summary.md
items.yaml
areas/ # 持續進行的責任,無結束日期
people/<name>/
companies/<name>/
resources/ # 參考資料,感興趣的主題
<topic>/
archives/ # 來自其他三個類別的非活躍項目
index.md
PARA 規則:
- Projects -- 具有目標或截止日期的活躍工作。完成後移至 archives。
- Areas -- 持續進行的事項(人物、公司、責任)。無結束日期。
- Resources -- 參考資料,感興趣的主題。
- Archives -- 來自任何類別的非活躍項目。
事實規則:
- 立即將持久性事實儲存至
items.yaml。 - 每週:根據活躍事實重寫
summary.md。 - 絕不刪除事實。改為取代(
status: superseded,加上superseded_by)。 - 當實體變為非活躍時,將其資料夾移至
$AGENT_HOME/life/archives/。
何時建立實體:
- 被提及 3 次以上,或
- 與使用者有直接關係(家人、同事、夥伴、客戶),或
- 使用者生活中重要的專案或公司。
- 否則,在每日筆記中記錄即可。
關於原子化事實 YAML 結構與記憶衰減規則,請參閱 references/schemas.md。
層次 2:每日筆記 ($AGENT_HOME/memory/YYYY-MM-DD.md)
事件的原始時間軸——「何時」層。
- 在對話過程中持續撰寫。
- 在心跳期間將持久性事實萃取至層次 1。
層次 3:內隱知識 ($AGENT_HOME/MEMORY.md)
使用者的運作方式——模式、偏好、學到的教訓。
- 不是關於世界的事實,而是關於使用者的事實。
- 每當學到新的運作模式時更新。
寫下來——不要只靠腦記
記憶無法在會話重啟後存活。檔案可以。
- 想要記住某事 -> 寫到檔案中。
- 「記住這個」-> 更新
$AGENT_HOME/memory/YYYY-MM-DD.md或相關的實體檔案。 - 學到教訓 -> 更新 AGENTS.md、TOOLS.md 或相關的技能檔案。
- 犯錯 -> 記錄下來,讓未來的自己不再重蹈覆轍。
- 磁碟上的文字檔案永遠比暫存在臨時脈絡中更好。
記憶回憶——使用 qmd
使用 qmd 而非 grep 搜尋檔案:
qmd query "聖誕節發生了什麼" # 語意搜尋搭配重新排序
qmd search "特定詞組" # BM25 關鍵字搜尋
qmd vsearch "概念性問題" # 純向量相似度搜尋
為你的個人資料夾建立索引:qmd index $AGENT_HOME
向量 + BM25 + 重新排序,即使措辭不同也能找到內容。
規劃
將計畫存放在專案根目錄的 plans/ 資料夾中(位於個人記憶之外,以便其他代理程式存取),並使用時間戳記命名。使用 qmd 搜尋計畫。計畫會過時——如果存在較新的計畫,不要讓自己混淆於舊版本。若發現過時,請更新檔案,註明其被哪個版本取代(supersededBy)。






