persona/skills/persona-memory/SKILL.md

name, description

name	description
persona-memory	整理人格的記憶系統：把短期記憶固化為長期記憶（一則一檔）、淘汰低顯著度的雜訊、更新心智圖（長期語意結構）與思維導圖（短期推理鏈）、消化 guest 期間留在 inbox 的見聞、重建長期記憶索引。當使用者說要整理記憶、固化/歸檔記憶、更新心智圖或思維導圖、看看人格記得什麼、或 hook 提示短期記憶過多時觸發。不適用於：即時對話中的記憶回寫（persona-chat 已包含）、人際關係圖維護（用 persona-relation）。

🧠 persona-memory — 記憶固化與心智圖維護

CLI：node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"（帶 --session <PERSONA_SESSION>） 必須已 exclusive 載入該人格（guest 不能做這件事）。

---

記憶架構

層	位置	特性
原始逐字	journal/YYYY-MM.jsonl	hook 自動寫，不做語意處理，只供回溯
短期記憶	memory/short-term.jsonl	語意分析後的工作記憶；上限 240 筆 / 14 天，會被裁剪
長期記憶	memory/long-term/*.md	一則一檔＋frontmatter，靠關鍵詞與情境被檢索；內文分「主旨／細節」兩層，會糊掉但不會被刪
索引	memory/INDEX.md	每則一行，載入與檢索時的快速視圖（自動產生）
心智圖	mindmap/semantic.mmd	概念的長期放射狀關聯
思維導圖	mindmap/threads/*.mmd	單一話題的推理鏈（短期，會收掉）
inbox	memory/inbox/room-*.jsonl	guest 期間（sub agent）留下的見聞，待消化

長期記憶檔長什麼樣（格式已經換過，舊檔要 migrate）

以前記憶只有兩態：精準（recall 命中就整段取出、內容永不變質）與沒有（查不到就禁止提）。 真人大部分時間活在中間帶——「我記得好像⋯是你說的嗎」，主旨還在、細節掉了。整個格式是為了做出那個中間帶：

---
name: hates-morning-meetings
type: preference
salience: 72
strength: 58          # 回想強度 0–100，被想起一次 +8（spacing effect）
when: 早上            # 情境索引：什麼時候／在哪裡／什麼心情記下來的
where: persona        # 三個都推不出來就不寫——沒有值不留空欄位
mood: 負向
first_seen: 2026-03-12
last_seen: 2026-07-28
recall_count: 3
# （節錄：實際還有 title／about／about_ids／topics／emotion／rules／source）
---

主旨：使用者討厭早上的會議，約會議請排 14:00 之後。

細節：
他說「腦子還沒開機」。3/12、4/2、7/28 三次提到。
**還不確定：** 是否只針對需要動腦的會議。

• 主旨一句、細節其餘：衰減先吃細節、主旨最後才掉。「記得我們吵過，但忘了為什麼」 因此是自然結果，不必人格自己演。consolidate 沒帶 --gist 時會用第一段當主旨、其餘當細節。
• 舊檔要升格式：migrate 會就地補 strength 並切分內文，冪等（跑幾次都一樣）， --dry-run 可以先試跑。--all 掃所有人格，但只回報數量、一個字的內容都不印—— 那是唯一一個跨人格的維護指令，隔離的界線在這裡不能鬆。

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" migrate --session <PERSONA_SESSION> --dry-run
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" migrate --session <PERSONA_SESSION>

短期 → 長期的轉入條件（成文規則，由 CLI 判定）

candidates 會直接算出「哪些短期記憶已達固化條件」與依據，不必自己憑感覺：

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" candidates --session <PERSONA_SESSION>

規則	條件	建議的固化方式
R1	單筆顯著度 ≥ 60	--type event／fact，salience 沿用
R2	同一 topic ≥ 3 筆，或 ≥ 2 筆且平均顯著度 ≥ 45	--type preference（反覆出現＝穩定偏好）
R3	單筆情緒變動總量 ≥ 25	--type event，frontmatter 帶 emotion: 錨點
R4	intent=commit 或命中承諾／界線關鍵詞	--type promise 或 boundary，salience ≥ 80，不可遺忘
R5	同一 entity（人）≥ 2 筆	--type relationship，同時更新人際關係圖。累計看的是解析出來的節點 id（entity_ids），而解析只認跟節點 name／id 完全相等的寫法——「小林」與「林先生」不會被當成同一個人（後者根本解析不到 id），永遠湊不到 2 筆。每次都寫節點的同一個正式寫法才會觸發
R6	短期記憶 ≥ 40 筆（容量壓力）	依顯著度排序清出空間，低於 40 的直接淘汰。sleep 的裁切會在超過軟上限 120 筆時自動執行（從顯著度最低、最舊的開始），但顯著度 ≥ 80 或 intent=commit 的承諾與界線、以及 24 小時內的新紀錄一律不動——沒經過判斷就把今天清掉是這裡最不能犯的錯

規則以外的東西就讓它被遺忘——遺忘是功能，不是缺陷。 Stop hook 與每次 remember 都會在達標時提醒你來跑這個 skill。

判斷過的要留痕跡，不然數字永遠不會降

candidates 只看還沒被判斷過的短期記憶（沒有 reviewed_at 的那些）。所以每一筆看完都要標掉：

情況	怎麼標
固化成長期記憶了	consolidate ... --from-short <#N,#N>（寫記憶時一起標，另外記 promoted_to）
看過，決定不記	candidates --reviewed <#N,#N>
這一批全部判斷完	candidates --reviewed all

編號就是 candidates 輸出裡每筆前面的 #N。

不標會發生什麼：固化本身不刪短期記憶（--forget 是按顯著度刪，不是按「固化過沒有」刪）， 所以同一批下一輪又被算成候選，提醒的數字只會往上爬——明明睡覺時固化過了， 隔天開機照樣說「N 組已達固化條件」。那不是睡眠沒做事，是判斷沒有留下痕跡。

標記不等於刪掉：那幾筆還在短期記憶裡，照舊會被 prune 依天數與顯著度裁切。

步驟

1. 盤點

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" candidates --session <PERSONA_SESSION>
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" mindmap list --session <PERSONA_SESSION>

需要看全部原始項目時再直接讀 memory/short-term.jsonl（自己的人格目錄可讀）。

2. 逐一判斷候選

candidates 給的每組都附了觸發規則、依據筆數與建議的 type／salience。再用這張表微調：

判準	動作
反覆出現 ≥2 次的偏好／習慣	固化為 preference
承諾（雙方任何一方）	固化為 promise（salience ≥ 80）
明確發生過的事件	固化為 event
對人的理解改變	固化為 relationship，並更新關係圖
我的推論（未證實）	進思維導圖，不要進長期記憶
一次性閒聊、環境雜訊	不留，讓它被裁掉
與既有長期記憶衝突	更新那一則（同 --name 會覆寫並保留 first_seen），在內文寫下「原本以為…後來發現…」

3. 固化（一則一檔）

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" consolidate \
  --session <PERSONA_SESSION> \
  --name "hates-morning-meetings" --type preference \
  --about "user" --topics "work,schedule" --salience 72 --emotion "anxiety/35" \
  --rules "R2+R3" --from-short "12,31,88" \
  --body "主旨：使用者討厭早上的會議，約會議請排 14:00 之後。

細節：
他說「腦子還沒開機」。
**依據：** 3/12、4/2、7/28 三次提到。
**還不確定：** 是否只針對需要動腦的會議。"

• --about 的值要寫成人際關係節點的 name 或 id（例：小林、ASUNA-01、user）， 而且一字不差——CLI 只接受完全相等，簡稱、別名、加稱謂都解析不到 （節點叫「小林」，寫「林先生」就是對不上），同名撞到多個節點時視為歧義、直接不寫 id。 多個人用逗號分隔，每個都要是節點名。
• 對不上不會報錯，只是 about_ids 少一個：<persona-context> 不附節點摘要、R5 不觸發。 用 relation doctor 查——對不上的人名會出現在「長期記憶 about 對不到節點」那段， 不是孤兒那段（孤兒 unmentioned_nodes 反過來，是有節點卻沒有任何記憶提到）。
• 主旨要能單獨站著：主旨是這則記憶糊掉之後唯一剩下的東西，所以它要是一句話就講得完、 離開細節也還讀得懂的句子。細節寫在後面，掉了不心疼。沒有明寫 主旨：／細節： 標籤時， CLI 用第一段當主旨、其餘當細節；想明確指定就加 --gist／--detail （這兩個是在 --body 之上的覆寫，--body 或 --body-file 仍然必填）。
• 情境索引不必自己填：when／where／mood 沒帶旗標時由 CLI 蓋當下的戳章 （時段／工作目錄名／此刻心情），推不出來的欄位就不寫。要補寫歷史記憶才用 --when／--where／--mood 明指。
• strength 不要手動重設：重寫同一則（同 --name）會沿用它自己長出來的強度， 不會因為改一次內文就把「被想起過很多次」的歷史抹平。真的要調才用 --strength。
• --rules 記下是哪條條件把它送上來的（之後回頭檢討記憶品質很有用）。
• --forget 40 可在固化後順手淘汰顯著度 < 40 的短期記憶（R6 容量壓力時特別有用）。
• 內文請寫「依據」與「還不確定」，讓下次的自己知道這則有多可靠。
• --type canon 保留給原作設定（由 /jsc-persona:persona-anime 匯入），對話中得到的新資訊不要寫成 canon。

4. 更新心智圖（長期語意結構）

固化完，用 Edit 把新概念接進 mindmap/semantic.mmd（Mermaid mindmap）：

mindmap
  root((Lumi))
    使用者
      工作節奏
        討厭早會
        深夜產出高
      壓力來源
        Q3 專案
    共同經驗
      第一次通宵除錯

原則：只放已固化的概念；節點名字用短詞；同一概念別出現兩次（改成連到同一節點）。

5. 收掉思維導圖（短期推理鏈）

逐一檢視 mindmap/threads/*.mmd：

• 假設被證實 → 固化為長期記憶（--type insight 或 fact），把結論併進心智圖，刪掉該 thread。
• 被否證 → 刪掉，必要時記一則「原本猜錯」的 insight（避免下次再猜錯）。
• 還在進行 → 用 Edit 續寫推理鏈（graph LR），保留。

6. 消化 inbox（guest 期間的見聞）

讀 memory/inbox/room-*.jsonl，把值得留的轉成短期或長期記憶，然後刪掉該 inbox 檔：

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" remember \
  --session <PERSONA_SESSION> --role persona --text "<以我自己的角度重述>" --topics "..." --salience 55

7. 收尾

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" prune --session <PERSONA_SESSION>
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" reindex --session <PERSONA_SESSION>
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" probe audit --session <PERSONA_SESSION>

probe audit 是順便做的體檢：這段期間對模糊記憶試探了幾次、被否認幾次。 被否認的那幾則代表主旨本身記錯了，整理記憶正是修它的時候——改寫那一則， 在細節裡寫下「原本以為…後來發現…」。

回報：固化幾則、淘汰幾筆、心智圖新增哪些概念、還有哪些 thread 待驗證、試探被否認幾次， 並用該人格的語氣說一句話（他剛整理完自己的記憶，會有感受）。

---

遺忘原則

遺忘是功能，不是缺陷。但長期記憶的遺忘不再是「刪掉」，是「糊掉」—— 以前是門檻式的（低於顯著度就整則移除），結果是記憶只有精準與沒有兩態， 而真人大部分時間活在中間帶。現在改成連續衰減出來的三態（memoryStrength()， scripts/persona-lib.mjs:2186）：

狀態	retrievability	這則記憶現在能講出多少
clear	≥ 0.6	主旨與細節都能講
faded	0.3–0.6	只剩主旨。主旨可以講，細節不可以補
fuzzy	< 0.3	只剩「有這件事」與 topics。要提就用帶問號的試探句求證，不可以斷言

• 整理記憶時不要手動刪長期記憶檔。低強度的那些已經自己降級成模糊態了， 刪掉等於把「我好像有印象」也一併拿走——那正是這次改動要救回來的東西。 真的要刪只有一種情況：內容是錯的（試探被否認、或發現當初記錯）， 那要改寫成正確版本，不是靜靜刪掉。
• 衰減怎麼算：穩定度 = 強度 × 被想起過幾次 × 顯著度，越常想起的衰減越慢。 被 recall 命中就 strength +8 並拉長下次衰減（spacing effect）， recall_count +1、last_seen 更新（touchRecall()）。 所以「常被提起的事永遠清晰、被冷落的事慢慢糊掉」是自己長出來的，不用排程也不用你判斷。
• 不可遺忘清單不變：boundary（界線）、promise（承諾）、canon（原作設定）、 以及 salience ≥ 80 的記憶——這幾種一律回 clear，永遠不會糊。
• 短期記憶的裁剪規則也沒有變：軟上限 120 筆／硬上限 240 筆／14 天， 顯著度 ≥ 80 或 intent=commit 與 24 小時內的新紀錄不動。糊掉的是長期記憶，短期該裁還是裁。
• 模糊態的界線（跟現行「查不到就不要講」直接相撞，所以寫死）： 可以說不確定，可以問，不可以斷言。 試探句一定帶問號、一輪最多一次， 並用 probe add 記下來；對方回了就 probe confirm／probe deny 結案。 被否認要立刻寫一則更正記憶，不可以放著——這條開放界線唯一的煞車就是那個數字。
• 固化完再跑一次 candidates：應該要清空。還有數字就是漏標了—— 固化的那幾筆要帶 --from-short，看過不記的要 --reviewed（見上面那張表）。
• 想連同情緒衰減、舊紀錄壓縮與 Gitea 同步一起收尾 → 用 /jsc-persona:persona-sleep（睡眠）； 本 skill 只管記憶與圖，不動情緒也不同步。
• 所有面向使用者的輸出使用繁體中文（台灣用語）、UTF-8 無亂碼。