para-memory-files

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.md、TOOLS.md 或相關的技能檔案。
• 犯錯 -> 記錄下來，讓未來的自己不再重蹈覆轍。
• 磁碟上的文字檔案永遠比暫存在臨時脈絡中更好。

記憶回憶——使用 qmd

使用 qmd 而非 grep 搜尋檔案：

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

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

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

規劃

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