para-memory-files

para-memory-files

基於 Tiago Forte 的 PARA 方法所建立的檔案型記憶系統。每當你需要跨工作階段儲存、擷取、更新或組織知識時,請使用此技能。涵蓋三個記憶層:(1) PARA 資料夾中的知識圖譜,包含原子化的 YAML 事實;(2) 作為原始時間軸的每日筆記;(3) 關於使用者模式的內隱知識。同時處理規劃檔案、記憶衰減、每週綜合整理,以及透過 qmd 進行回憶。在執行任何記憶操作時觸發:儲存事實、撰寫每日筆記、建立實體、執行每週綜合整理、回憶過去脈絡,或管理計畫。

1星標
0分支
更新於 2026/7/10
SKILL.md
readonlyread-only
name
para-memory-files
description

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)

以實體為基礎的儲存。每個實體有一個資料夾,包含兩層:

  1. summary.md -- 快速脈絡,優先載入。
  2. 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.mdTOOLS.md 或相關的技能檔案。
  • 犯錯 -> 記錄下來,讓未來的自己不再重蹈覆轍。
  • 磁碟上的文字檔案永遠比暫存在臨時脈絡中更好。

記憶回憶——使用 qmd

使用 qmd 而非 grep 搜尋檔案:

qmd query "聖誕節發生了什麼"   # 語意搜尋搭配重新排序
qmd search "特定詞組"              # BM25 關鍵字搜尋
qmd vsearch "概念性問題"         # 純向量相似度搜尋

為你的個人資料夾建立索引:qmd index $AGENT_HOME

向量 + BM25 + 重新排序,即使措辭不同也能找到內容。

規劃

將計畫存放在專案根目錄的 plans/ 資料夾中(位於個人記憶之外,以便其他代理程式存取),並使用時間戳記命名。使用 qmd 搜尋計畫。計畫會過時——如果存在較新的計畫,不要讓自己混淆於舊版本。若發現過時,請更新檔案,註明其被哪個版本取代(supersededBy)。