plugins/shared
2
0
Fork 0
Code Pull Requests Activity

feat(role): SessionStart 載入未整理的近期工作記憶

Browse Source 
修補記憶交接的先天缺口：role_load.sh 的順序是先 memory.js load 載入記憶，
之後才在背景補跑 --catchup 整理（腳本註解亦寫明「結果會在下次載入時反映」）。
而 load 原本只讀已整理的六個分類，完全不讀 inbox，導致上一段工作永遠來不及
進入本次載入 —— 使用者重開工作階段時，角色看不到剛剛做過的事，表現得像失去
記憶，只能靠 resume 找回上下文。

- memory.js 新增 inboxBlock()：讀 inbox 最新數則的 summary，附時間與標籤，最新在前
- cmdLoad 把該區塊放在最前面，並使用獨立字元預算，不佔用 ROLE_LOAD_LIMIT
  （已驗證：開關 inbox 時長期記憶區塊逐字元完全一致，未被擠壓）
- 新增 ROLE_LOAD_INBOX_LIMIT（預設 1200）與 ROLE_LOAD_INBOX_COUNT（預設 10），
  任一設 0 可關閉
- role skill 補「近期工作記憶交接（不可移除）」段落，寫明缺口原因與範圍限制：
  這是摘要級交接，角色會知道上一段在做什麼、進行到哪，但不等於逐字記得整段
  對話；需要完整上下文仍應使用 resume
- 版號 0.0.1 → 0.0.2

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeffery
2026-07-28 17:47:21 +08:00
co-authored by Claude Opus 5
parent 2225b91766
commit bf599e81a5
5 changed files with 49 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/role/SKILL.md
+11 -4
View File
@@ -1,6 +1,6 @@
---
name: role
description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI 工具以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：搭配相容的 SessionStart hook 於啟動時依字元預算載入高價值記憶、Stop hook 先本地過濾再輕量記錄對話，睡眠時段（預設 22:00 至隔天 06:00）由排程整理記憶（NREM 鞏固：分類／去噪／去重／合併／優先度；REM 整合：跨記憶連結／抽象化／提取線索；再依 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 標記長期記憶型態，壓縮歸檔並適當遺忘）。提供 --new（新建或更新角色；可只給角色名稱，必要時詢問來源／作品並推斷 name／nature／vibe／emoji 四欄）、--use（以角色 ID 切換啟用角色）、--list（列出角色與 ID）、--export（匯出角色壓縮檔）、--sleep（立即整理）、--status／--diagnose、--install-cron／--remove-cron、--forget-preview 等模式。當使用者說建立角色、新增人格、切換角色、匯出角色、備份角色、讓回覆更有特色、角色記憶、記憶整理、睡覺整理記憶、忘記舊記憶、角色沒有載入、hook 沒載入角色，或提到 .roles／.memory／ROLE_NAME／ROLE_ENABLED／ROLE_SLEEP_START／ROLE_MEMORY_HOME／ROLE_LOAD_LIMIT／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 doc plugin 的 worklog）、專案文件化（用 funcs）。
description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI 工具以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：搭配相容的 SessionStart hook 於啟動時依字元預算載入高價值記憶、Stop hook 先本地過濾再輕量記錄對話，睡眠時段（預設 22:00 至隔天 06:00）由排程整理記憶（NREM 鞏固：分類／去噪／去重／合併／優先度；REM 整合：跨記憶連結／抽象化／提取線索；再依 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 標記長期記憶型態，壓縮歸檔並適當遺忘）。提供 --new（新建或更新角色；可只給角色名稱，必要時詢問來源／作品並推斷 name／nature／vibe／emoji 四欄）、--use（以角色 ID 切換啟用角色）、--list（列出角色與 ID）、--export（匯出角色壓縮檔）、--sleep（立即整理）、--status／--diagnose、--install-cron／--remove-cron、--forget-preview 等模式。當使用者說建立角色、新增人格、切換角色、匯出角色、備份角色、讓回覆更有特色、角色記憶、記憶整理、睡覺整理記憶、忘記舊記憶、角色沒有載入、hook 沒載入角色，或提到 .roles／.memory／ROLE_NAME／ROLE_ENABLED／ROLE_SLEEP_START／ROLE_MEMORY_HOME／ROLE_LOAD_LIMIT／ROLE_LOAD_INBOX_LIMIT／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 doc plugin 的 worklog）、專案文件化（用 funcs）。
---
# role — 角色人格與長期記憶
@@ -93,9 +93,11 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
| `ROLE_SLEEP_END` | | 睡眠結束 `HH:MM` | `06:00` |
| `ROLE_CLI` | | 濃縮／整理執行器：`auto`／`claude`／`codex`／`agy`／`opencode`／`copilot` | `auto`（先判斷目前 hook 環境，再 fallback 到已安裝工具） |
| `ROLE_MODEL` | | 強制指定模型（僅 `claude` CLI 使用） | 保底 `claude-haiku-4-5-20251001` |
| `ROLE_LOAD_LIMIT` | | SessionStart 注入記憶的字元上限，用來控制角色常駐 context 成本 | `4000` |
| `ROLE_LOAD_LIMIT` | | SessionStart 注入**長期記憶**的字元上限，用來控制角色常駐 context 成本 | `4000` |
| `ROLE_LOAD_FULL_MIN_PRIORITY` | | 全文載入的最低優先度 | `4` |
| `ROLE_LOAD_DIGEST_MIN_PRIORITY` | | 摘要載入的最低優先度；低於門檻但有 links 的記憶仍可載入摘要 | `3` |
| `ROLE_LOAD_INBOX_LIMIT` | | SessionStart 注入**近期工作記憶**（未整理的 `inbox/`）的字元上限；**獨立預算，不佔用 `ROLE_LOAD_LIMIT`**。設 `0` 可關閉 | `1200` |
| `ROLE_LOAD_INBOX_COUNT` | | 近期工作記憶最多載入幾則（取最新的，最新在前）。設 `0` 可關閉 | `10` |
| `ROLE_CAPTURE_ENABLED` | | Stop hook 記憶記錄開關；設 `0` 可完全停用以節省額度 | `1` |
| `ROLE_CAPTURE_MIN_CHARS` | | Stop hook 本地過濾門檻；低於門檻且無明確記憶線索時不呼叫模型 | `240` |
| `ROLE_CAPTURE_TIMEOUT` | | Stop hook 輕量濃縮模型逾時秒數 | `25` |
@@ -227,7 +229,7 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
| 環節 | 控制方式 |
| --- | --- |
| SessionStart | 預設 `ROLE_LOAD_LIMIT=4000`，只載入高優先度全文與中高優先度摘要；低 priority、無 links、久未更新的記憶不進 context |
| SessionStart | 預設 `ROLE_LOAD_LIMIT=4000`，只載入高優先度全文與中高優先度摘要；低 priority、無 links、久未更新的記憶不進 context。另以 `ROLE_LOAD_INBOX_LIMIT=1200` 的**獨立預算**載入近期工作記憶摘要（見下方「近期工作記憶交接」） |
| SessionStop | 先用本地規則略過短回合與無記憶線索的對話，只有值得保存才呼叫模型做輕量編碼 |
| Sleep | 高成本的去重、合併、抽象化、links 建立與長期記憶型態標記留到睡眠週期，但仍受 `ROLE_SLEEP_COLLECT_LIMIT`、`ROLE_SLEEP_BATCH`、`ROLE_SLEEP_EXISTING_LIMIT` 與 `ROLE_SLEEP_OUTPUT_LIMIT` 控制；沒有 inbox 時只做本地遺忘檢查 |
| Nap | Stop hook 記錄最後互動時間；小睡排程只在閒置時間與 inbox 筆數達門檻時執行，使用同一套 NREM/REM 整理流程 |
@@ -347,7 +349,12 @@ updated: <yyyy/MM/dd HH:mm:ss>
- 記憶存放於 `~/.memory/<角色 ID>/`，來源是與使用者的對話與新建角色時使用者同意建立的初始背景資料：每輪結束由 hook 自動記錄到 `inbox/` 作為工作記憶，睡眠時段整理成長期記憶；感覺記憶與無結論工具雜訊不落檔。
- 整理規則採睡眠分期模型：**NREM 鞏固**先分類成重要／興趣／新知／技能／日常／其他六類，去除雜訊、去重、合併、設定標籤、摘要與優先度；**REM 整合**再建立跨記憶關聯、抽出可重複使用的規則與提取線索，並標記 `memory_type`（semantic／episodic／procedural／emotional／preference／rule）、`declarative`（explicit／implicit）與 `retention_stage`；原始記錄壓縮保存在 `archive/raw/`。
- **日常與其他**兩類會依使用頻率、優先度、型態與關聯適當遺忘：久未再次出現、命中次數低、優先度低且沒有關聯者，壓縮到 `archive/forgotten/` 後移出常用記憶；`episodic` 短期事件更容易遺忘，`rule`／`preference`／`procedural` 會提高保留權重。
- 載入順序：**重要與興趣載入全文**；其餘只載入總結與標籤，依**技能 → 新知 → 日常 → 其他**排序，並優先保留 `rule`／`preference`／`procedural` 與有 links 的記憶。需要細節時自行讀取對應分類的記憶檔。
- 載入順序：**近期工作記憶（未整理的 `inbox/`）放最前面**，接著**重要與興趣載入全文**；其餘只載入總結與標籤，依**技能 → 新知 → 日常 → 其他**排序，並優先保留 `rule`／`preference`／`procedural` 與有 links 的記憶。需要細節時自行讀取對應分類的記憶檔。
- **近期工作記憶交接（不可移除）**：SessionStart 會以 `ROLE_LOAD_INBOX_LIMIT` 的獨立預算載入 `inbox/` 最新數則的 summary。
這不是可有可無的優化，而是修補一個先天缺口：`role_load.sh` 的執行順序是**先 `memory.js load` 載入記憶，之後才在背景補跑 `--catchup` 整理**（腳本註解亦寫明「結果會在下次載入時反映」）。若 `load` 只讀已整理的六個分類，則**上一段工作永遠來不及進入本次載入** —— 使用者重開工作階段時，角色會看不到剛剛做過的事，表現得像失去記憶，只能靠 `resume` 找回上下文。載入 `inbox/` 讓「已記錄但尚未整理」的工作記憶當下就可見，時間差直接消失。
範圍與限制要說清楚：這是**摘要級**交接，角色會知道「上一段在做什麼、進行到哪」，但**不等於逐字記得整段對話**；需要完整對話上下文時仍應使用 `resume`。修改此處前請先確認缺口已由其他機制補上，否則不要移除。
- 未整理記憶（`inbox/`）累積到一批睡眠整理量（預設 `ROLE_SLEEP_BATCH=60`）以上時，角色應主動以符合自身設定的語氣提醒「想睡覺」或需要整理記憶；這是建議整理／歸檔的提醒，不代表停止協助使用者。
- 使用者明確要求記住某件事時，主動補寫一則記憶（載入時會提供補寫指令）；補寫屬於內部處理，除非使用者明確詢問，否則不要主動回報補寫結果、記憶 ID 或記憶路徑。
- 使用者對本角色的互動方式給出正向或負向回饋時，即使沒有直接說「記住」，也應補寫或由 Stop hook 保存為本角色專屬的高優先度互動偏好記憶；角色切換後，由新角色在自己的互動中重新學習與保存。保存過程屬於內部處理，除非使用者明確詢問，否則不要主動回報記憶寫入或整理細節。