feat(role): 精確資訊逐字保留、晨間狀態檢查、排除 skill 注入內容
三件事都源自 2026/07/28-29 實際踩到的問題。 一、整理與濃縮提示詞加「精確資訊逐字保留」規則 原本 role_sleep.sh 只要求「壓縮成 5 行、不超過 400 字」，沒有任何規則保護精確資訊， 導致一則含檔案路徑與網址的記憶被整理成純情感摘要，路徑與網址全部遺失且無法復原。 - role_sleep.sh 新增第 19 條：檔案路徑、網址、指令、環境變數名稱、版本號、識別碼、檔名 一律逐字保留，不得摘要改寫；必要時可超過字數上限；憑證與個資的禁令仍優先 - role_capture.sh 第 8 條同步強化，並釐清與第 7 條「不要整段抄程式碼」的界線 二、新增 --brief 晨間狀態檢查 睡眠時段結束的整點執行使用者自訂檢查腳本，把有變化的結果寫成一則 daily 記憶， 讓角色當天第一次互動就能主動回報（例如 PR 還沒合併、CI 失敗），不必等使用者開口才查。 - 刻意不內建任何檢查邏輯，不假設使用者用 Gitea/GitHub：檢查內容放 ~/.roles/<角色>.checks/*.sh - 目錄不存在時完全不動作，也不安裝排程條目，對沒設定的人零影響 - 只執行有 +x 的 *.sh；無執行權限記警告並略過 - 沒有輸出就不寫記憶（靜默即代表一切正常，不打擾使用者） - 每個腳本受 ROLE_BRIEF_TIMEOUT 限制，輸出受 ROLE_BRIEF_EACH_LIMIT／ROLE_BRIEF_LIMIT 截斷 - 腳本輸出視為外部資料，寫入前一律經 transcript.js redact 遮蔽 - install_cron／remove_cron／show_status 一併支援；附 examples/check-gitea-prs.sh 範例 三、對話交接排除 skill 等注入內容 實測發現載入一個 skill 會插入一筆 isMeta 的 user 訊息（長度可達兩萬字元）， 被誤認為使用者發言，既吃光字元預算也讓輪數計算失真（29 輪虛胖，實際 26 輪）。 - transcript.js 新增 isMetaEntry()：以 isMeta 與 sourceToolUseID 判斷注入內容 - isRealUserMessage() 與 dialogLines() 皆排除，連帶讓 Stop hook 的本輪抽取更準確 驗證：晨間檢查涵蓋有輸出/無輸出/無執行權限/逾時/含機密五種腳本， 確認遮蔽生效、逾時腳本未納入、無權限腳本未執行、全部無輸出時不寫記憶、 ROLE_BRIEF_ENABLED=0 可停用；對話交接確認 skill 內容已排除且 8 則全為真實使用者發言。 版號 0.0.3 → 0.0.4 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeffery
+36
-2
@@ -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_LOAD_INBOX_LIMIT／ROLE_LOAD_DIALOG_TURNS／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 /jsc-doc:worklog）、專案文件化（用 /jsc-doc: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、--brief（晨間狀態檢查）等模式。當使用者說建立角色、新增人格、切換角色、匯出角色、備份角色、讓回覆更有特色、角色記憶、記憶整理、睡覺整理記憶、忘記舊記憶、角色沒有載入、hook 沒載入角色、晨間狀態檢查、早上主動回報狀態，或提到 .roles／.memory／ROLE_NAME／ROLE_ENABLED／ROLE_SLEEP_START／ROLE_MEMORY_HOME／ROLE_LOAD_LIMIT／ROLE_LOAD_INBOX_LIMIT／ROLE_LOAD_DIALOG_TURNS／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 /jsc-doc:worklog）、專案文件化（用 /jsc-doc:funcs）。
|
||||
---
|
||||
|
||||
# role — 角色人格與長期記憶
|
||||
@@ -13,13 +13,14 @@ description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI
|
||||
| `hooks/hooks.json` 的 `SessionStart` hook | harness 自動 | 啟動 CLI 時依字元預算載入角色定義＋高價值記憶，另以獨立預算載入近期逐字對話與未整理工作記憶做工作階段交接，並要求角色在本工作階段第一則回覆主動問候；睡眠時段只回報「角色睡覺中」不載入 |
|
||||
| `hooks/hooks.json` 的 `Stop` hook | harness 自動 | 每輪結束先記錄最後互動時間 → 用本地規則過濾低價值短回合 → 值得保存時才濃縮成一則輕量 inbox 記憶 → 遮蔽 → 寫入 `inbox/` |
|
||||
| cron 排程（本 skill 安裝） | 系統排程 | 睡眠時段每小時檢查一次：**有 AI 在運行就不睡**；另可依 CLI 閒置時間自動小睡整理 |
|
||||
| 本 skill `/jsc-generic:role` | 使用者／助理手動 | `--new`／`--use`／`--list`／`--export`／`--sleep`／`--status`／`--install-cron`／`--forget-preview` |
|
||||
| 本 skill `/jsc-generic:role` | 使用者／助理手動 | `--new`／`--use`／`--list`／`--export`／`--sleep`／`--brief`／`--status`／`--install-cron`／`--forget-preview` |
|
||||
| `scripts/role/role_load.sh` | SessionStart hook | 角色與記憶載入；參考 OpenClaw 的 SOUL／AGENTS／USER／MEMORY 分層，把人格、操作邊界、使用者記憶分開注入，並提供第一則回覆問候提示（單一實作，避免漂移） |
|
||||
| `scripts/role/role_capture.sh` | Stop hook | 對話 → 記憶（固定欄位格式） |
|
||||
| `scripts/role/role_sleep.sh` | cron／小睡／補跑／手動 | 睡眠與小睡判斷、記憶整理、角色匯出、排程安裝、狀態輸出 |
|
||||
| `scripts/role/memory.js` | 上述共用 | 記憶檔讀寫、分類、去重合併、優先度、心理學記憶型態與關聯 metadata、壓縮歸檔、遺忘、載入組裝 |
|
||||
| `scripts/role/transcript.js` | 上述共用 | 抽本輪對話片段、抽最近數輪純對話供工作階段交接、機密與個資遮蔽 |
|
||||
| `scripts/role/role_lib.sh` | 上述共用 | log、角色解析、睡眠時段、AI 行程偵測、CLI 選擇、記憶鎖 |
|
||||
| `scripts/role/examples/` | 使用者自行複製 | 晨間狀態檢查的範例腳本；複製到 `~/.roles/<角色 ID>.checks/` 才會生效 |
|
||||
|
||||
### 各助理支援範圍
|
||||
|
||||
@@ -112,6 +113,10 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
| `ROLE_NAP_IDLE_MINUTES` | | 小睡前需連續閒置的分鐘數，由 Stop hook 記錄最後互動時間 | `45` |
|
||||
| `ROLE_NAP_MIN_INBOX` | | 小睡整理所需的最少待整理 inbox 筆數 | `3` |
|
||||
| `ROLE_NAP_INTERVAL_MINUTES` | | 小睡排程檢查間隔分鐘數（cron 每 `*/N` 分鐘觸發） | `10` |
|
||||
| `ROLE_BRIEF_ENABLED` | | 晨間狀態檢查開關；設 `0` 可停用 | `1` |
|
||||
| `ROLE_BRIEF_TIMEOUT` | | 單個檢查腳本的逾時秒數 | `30` |
|
||||
| `ROLE_BRIEF_EACH_LIMIT` | | 單個檢查腳本輸出的字元上限 | `600` |
|
||||
| `ROLE_BRIEF_LIMIT` | | 所有檢查腳本輸出合計的字元上限 | `2000` |
|
||||
| `ROLE_SCOPE` | | 冒號分隔的路徑前綴，僅這些路徑下的 session 載入／記錄 | 全部 session |
|
||||
| `ROLE_ERRLOG` | | 錯誤訊息額外寫入的檔案路徑 | 只走 stderr |
|
||||
|
||||
@@ -225,6 +230,34 @@ ROLE_DIR="<skill base directory>/../../scripts/role" # 其他助理
|
||||
|
||||
小睡不受 `ROLE_SLEEP_START`／`ROLE_SLEEP_END` 限制；它只避開整理用的 headless 子 CLI，讓互動式 CLI 長時間閒置時仍可整理記憶。若未設定環境變數，預設為 `ROLE_NAP_ENABLED=1`、`ROLE_NAP_IDLE_MINUTES=45`、`ROLE_NAP_MIN_INBOX=3`、`ROLE_NAP_INTERVAL_MINUTES=10`。
|
||||
|
||||
### `--brief`（晨間狀態檢查）
|
||||
|
||||
在睡眠時段結束的整點執行使用者自訂的檢查腳本，把有變化的結果寫成一則記憶，讓角色在當天第一次互動時就能主動回報 —— 例如「PR 還沒合併」、「昨晚 CI 失敗了」，而不必等使用者開口才去查。
|
||||
|
||||
```bash
|
||||
"${ROLE_DIR}/role_sleep.sh" --brief
|
||||
```
|
||||
|
||||
**本 skill 不內建任何檢查邏輯**，不假設使用者用 Gitea、GitHub 或任何服務。檢查內容完全由使用者決定：
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.roles/<角色 ID>.checks
|
||||
cp "${ROLE_DIR}/examples/check-gitea-prs.sh" ~/.roles/<角色 ID>.checks/
|
||||
chmod +x ~/.roles/<角色 ID>.checks/check-gitea-prs.sh
|
||||
"${ROLE_DIR}/role_sleep.sh" --install-cron # 重跑才會加入排程條目
|
||||
```
|
||||
|
||||
| 規則 | 說明 |
|
||||
| --- | --- |
|
||||
| 目錄不存在 | 完全不動作，也不會安裝排程條目 —— 對沒設定的人零影響 |
|
||||
| 只執行 `*.sh` | 且必須有執行權限；沒有 `+x` 會記一筆警告並略過 |
|
||||
| **沒變化就不要輸出** | 晨間檢查只在有輸出時才寫記憶。腳本靜默即代表「一切正常，不必打擾使用者」 |
|
||||
| 逾時與長度 | 每個腳本受 `ROLE_BRIEF_TIMEOUT` 限制，輸出受 `ROLE_BRIEF_EACH_LIMIT` 與 `ROLE_BRIEF_LIMIT` 截斷 |
|
||||
| 遮蔽 | 腳本輸出視為外部資料，寫入記憶前一律經 `transcript.js redact` 遮蔽憑證與個資 |
|
||||
| 記憶分類 | 寫成 `daily` 低優先度記憶，會依遺忘規則自然淘汰，不會長期堆積 |
|
||||
|
||||
**安全須知**：這個機制會以使用者身分執行 `.checks/` 內的腳本，等同於自己寫的 cron job。只放自己看得懂的腳本，不要放來源不明的檔案。cron 沒有互動 shell 的環境變數，腳本需要的設定要自己在腳本內處理或寫進 crontab。
|
||||
|
||||
### 額度控制策略
|
||||
|
||||
角色系統預設避免因常駐人格與記憶造成大量模型額度占用：
|
||||
@@ -345,6 +378,7 @@ updated: <yyyy/MM/dd HH:mm:ss>
|
||||
- 睡眠時段內啟動 CLI **不會載入角色**：以一般助理身分回應，不自稱角色、不使用角色語氣與簽名 emoji。此時對話仍會被記錄成記憶。
|
||||
- 睡眠排程每小時檢查一次，**偵測到有 AI 正在運行就不睡**，留到下個整點再試；沒有 AI 運行才進入睡眠並整理記憶。
|
||||
- 小睡排程預設啟用：CLI 最後互動時間超過 45 分鐘且 `inbox/` 至少 3 則待整理記憶時，可不等睡眠時段自動整理；可用 `ROLE_NAP_ENABLED`、`ROLE_NAP_IDLE_MINUTES`、`ROLE_NAP_MIN_INBOX` 與 `ROLE_NAP_INTERVAL_MINUTES` 調整。
|
||||
- 睡眠時段結束的整點會執行晨間狀態檢查（見 `--brief`）：跑完使用者自訂的檢查腳本後寫成一則記憶，讓角色當天第一次互動就能主動回報變化。只有建立了 `~/.roles/<角色 ID>.checks/` 才會排程。
|
||||
|
||||
### 記憶
|
||||
|
||||
|
||||
Reference in New Issue
Block a user