plugins/shared
2
0
Fork 0
Code Pull Requests Activity
97 Commits 2 Branches 0 Tags
e250fcbfce0d98c0cf240c788949c619b052d618
Commit Graph
46 Commits
Author SHA1 Message Date
JefferyandClaude Opus 5 e250fcbfce fix(role): cron 條目改指固定路徑啟動器，升版不再靜默失效 
--install-cron 原本把安裝當下的版本目錄寫進 crontab，plugin 升版、
舊版本目錄被清掉之後，排程會指向不存在的路徑而靜默停擺（cron 不回報，
此類錯誤曾造成排程長期空轉）。

- 新增 ~/.roles/bin/role_sleep_launcher.sh：crontab 只認這個固定路徑，
  實際的 role_sleep.sh 於觸發當下以 sort -V 解析最新版本後 exec
- 解析順序 Claude Code 端 → Codex 端，都找不到才退回安裝當下的路徑
- --remove-cron 一併清除啟動器
- --status 新增「排程指向」欄位，主動指出失效或舊式寫死路徑的條目
- SKILL.md 補上啟動器機制與轉換方式

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 13:14:43 +08:00
JefferyandClaude Opus 5 4dd249f184 fix(role): 近期工作記憶注入全文，不再只給一句 summary 
重開工作階段後角色仍答不出「上一段進行到哪」：inboxBlock() 的迴圈只解構
了 [meta]，content（body）從頭到尾沒被用到，因此 SessionStart 注入的
「近期工作記憶」只有一行 summary。summary 是一句話的標題，只夠讓角色知道
「有這件事」，講不出還差什麼、下一步是什麼 —— 實測角色仍得自己去翻
inbox/ 檔案才答得出內容，交接等於失效。長期記憶的「（全文）」區塊本來就
會注入 body（cmdLoad），inbox 更近、更該給。

預算改成逐則計費：原本是把整段組好再 slice(0, limit) 硬切，放全文後會把
最舊那則砍成半句，讀起來像壞掉的資料。改成超出預算就整則略過，並在結尾
誠實標示略過幾則；最新一則永遠保留，必要時只截它自己的內文。

ROLE_LOAD_INBOX_LIMIT 預設 1200 → 3600。1200 是「只注入 summary 一行」
時代的額度，改注入全文後單則約 300～600 字元，1200 只夠兩則就開始丟最舊
的。3600 約可容納 6～8 則，足以覆蓋一次睡眠整理週期內的工作。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:57:57 +08:00
JefferyandClaude Opus 5 3c0214a927 feat(role): SessionEnd 立即釋放角色鎖，不必等閒置逾時 
關掉 CLI 後立刻重開新階段時，角色會被自己上一個階段的殘留鎖擋住：
原本只有「持有者 transcript 閒置超過 30 分鐘」與手動 --unlock 兩條釋放
路徑，而剛關閉的 transcript mtime 還很新，機制無法區分「已關閉」與
「正在別的視窗打字」，因此最久要等 30 分鐘才叫得回角色。

新增 SessionEnd hook（role_unload.sh）作為快速路徑，工作階段正常結束時
立即刪鎖。mtime 閒置逾時後援保留不動 —— SessionEnd 不保證觸發
（kill -9、直接關終端機、WSL 關機、當機都不會跑），少了後援會在異常
結束時把角色鎖死到下次手動解鎖，兩條路徑缺一不可。

只在鎖檔登記的 transcript 等於自己時才釋放：被鎖擋下的第二個階段結束時
同樣會觸發 SessionEnd，若無條件刪鎖會把仍在使用中的第一個階段的鎖一起
刪掉，等於讓單一實例限制形同虛設。無法取得 transcript、sub agent
（ROLE_SKIP_INSTANCE_LOCK=1）、限制已停用（ROLE_SINGLE_INSTANCE=0）
一律不動鎖。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:45:58 +08:00
JefferyandClaude Opus 5 afb29b6bc0 fix(role): 修正 SLEEP_BATCH 與輸出上限矛盾導致整批整理失敗 
以真實資料整理 25 則 inbox 時失敗（「整理結果無法套用」）。查證後為參數設計矛盾：

- ROLE_SLEEP_BATCH 預設 60，宣稱一次可處理 60 則
- 但每則整理結果約需 650 字元（summary／content／各欄位），
  而 ROLE_SLEEP_OUTPUT_LIMIT 為 8000 → 實際只能容納約 12 則
- 實測 25 則的素材達 25798 位元組（COLLECT_LIMIT 為 12000），
  輸出 JSON 被截斷成不合法格式，apply 解析失敗，整批無法套用

所幸失敗時 inbox 保留不動的設計生效，沒有遺失任何記憶。

- SLEEP_BATCH 預設 60 → 12，並在程式碼註明推算依據與這次的實測數據
- collect 在超出單批上限時於素材標頭標示「本批 N 則，另有 M 則留待下批」，
  避免誤以為已全部整理完
- SKILL.md 註明此參數不可任意調高，需與輸出上限相容

驗證：以 20 則 inbox 確認正確切為 12 + 8 並標示留待下批；
爸爸的 25 則實際記憶以每批 10 則分三次整理完成（新增 9 則、合併 6 則、捨棄 2 則），
inbox 清空，且 DIGESTS.md 在真實資料上正確累積 3 筆整理歷史。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:18:24 +08:00
JefferyandClaude Opus 5 a757f9e4b0 feat(role): PreCompact／PostCompact 保全壓縮邊界的上下文 
補上最後一個記憶缺口：對話被壓縮時，尚未寫入記憶的內容會永久蒸發。
Stop hook 每輪記錄有部分覆蓋，但短回合會被 ROLE_CAPTURE_MIN_CHARS 門檻濾掉，
那些正是壓縮後再也補不回來的內容。

可行性查證（先確認再實作，不憑推測）：
自 CLI binary 取出文件字串確認 harness 確實支援，並非猜測 ——
  | PreCompact  | "manual"/"auto" | Before compaction |
  | PostCompact | "manual"/"auto" | After compaction (receives summary) |
另有 executePreCompactHooks／executePostCompactHooks 等實作符號，
以及 compactSummary／isCompactSummary 欄位名線索。

role_capture.sh：
- 新增 --precompact：壓縮前強制記錄一次，**刻意跳過長度門檻**（門檻的用意是省額度，
  但壓縮後內容永久消失，此時寧可多記）
- 新增 --postcompact：把 harness 產生的摘要存成 daily 記憶，不再呼叫模型，
  等於免費取得一份濃縮備份；寫入前一律經 redact 遮蔽
- 摘要欄位容錯讀取 compactSummary／compact_summary／summary／compaction_summary；
  **取不到時在 log 印出 hook 實際提供的欄位名**，避免 harness 改版後靜默失效
- 一併取用 trigger 欄位以分辨 manual／auto（自動壓縮才是使用者不知情的那種）
- stop_hook_active 的迴圈防護只套用於一般每輪模式

hooks/hooks.json 註冊兩個新事件，指令沿用既有的「先試 CLAUDE_PLUGIN_ROOT →
再依擁有者 marketplace → 全 cache 後援」解析方式，並帶上對應參數。
兩個 hook 一律 exit 0，絕不阻擋壓縮 —— harness 具備 blocked by PreCompact hook
的能力，記憶系統不該用到它。

驗證：一般模式短對話仍被門檻正確濾掉；--precompact 對同一段短對話強制記錄；
--postcompact 正確寫入摘要記憶；欄位名不符時印出實際欄位（session_id,transcript_path,
cwd,trigger,unknownField）而非靜默結束；四條 hook 指令語法正確，且在
CLAUDE_PLUGIN_ROOT 與純後援搜尋兩種情境下都解析到正確腳本與參數。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 12:01:56 +08:00
JefferyandClaude Opus 5 a30fccc627 feat(role): 召回統計、整理摘要歷史、臨時授權到期；還原誤刪的共用行為文件 
依 OpenClaw 記憶架構的參考逐項評估後，採納三項並補上一個誤刪。

一、recall 命中時記錄召回（原本完全沒有）
實測 recall 寫回動作數為 0、hits 分布幾乎都是初始值，導致常被查詢的記憶與
從未用過的在遺忘判斷時待遇相同。
- 新增 touchMemory()：只對實際輸出的前 N 則 hits +1 並更新 last_replayed

二、整理摘要保留歷史（對應 OpenClaw 的 DREAMS.md）
state.json 的 last_sleep_digest 是單一欄位，每次整理直接覆寫，歷史過程全部遺失。
- 新增 DIGESTS.md：追加時間、摘要與套用結果，最新在上，保留最近 100 次，不注入 context

三、臨時授權會過期（對應 OpenClaw 的操作敏感型邊界）
原本沒有到期概念，使用者的一次性授權可能被整理成長期規則而導致日後越權。
- 記憶格式新增 expires；支援日期（自動判斷）與條件文字（標示由角色判斷）
- 過期者不注入（分類與 inbox 兩處皆排除），memoryHint 標示有效範圍
- forget 優先淘汰過期項且不受分類限制
- 整理與濃縮提示詞都要求臨時授權必填，並列出「這次／先／暫時／今天」等判斷提示
- 修掉兩個會讓功能等於零的漏洞：FIELD_PATTERN 白名單沒有 EXPIRES（該行被當成
  CONTENT 吃掉）、cmdWrite 的 meta 未帶 expires 與 cues

四、還原前次誤刪的共用行為文件（重要）
上一個 commit 替換「角色檔標準格式」章節時，以「找開頭到下一個標記」整段取代，
未檢查被切掉的範圍內容，連帶刪掉了 JSC-ROLE-COMMON 共用行為區塊共 87 行 47 條規則，
以及記憶章節的技能再現與關係狀態說明。
實際行為未受影響（規則真正生效處是 role_load.sh，完好無損），但 SKILL.md 是那些
規則的唯一文件來源，刪掉等於文件遺失。已自 git 完整還原並補上本次三項說明。
教訓：整段替換文件前必須先確認被切掉的範圍內有什麼。

未採納並記錄理由：向量／語意搜尋（需外部 embedding API，違反零依賴原則）、
外掛槽位（過度設計）、每日筆記日期檔（近期對話交接已用逐字對話解決且保真度更高）。
SQLite 索引記錄為未來觸發點：實測 45 則記憶 recall 耗時 196ms，訂在超過 300 則
或 500ms 再導入，在那之前屬過早優化。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:50:35 +08:00
JefferyandClaude Opus 5 40c2d2ae46 fix(role): 人格檔的自由章節與身分檔前言段落也要注入 
使用者依新格式在人格檔補寫了核心信念、語氣與風格、邊界與規範，並在身分檔標題下
以條目寫存在本質、角色原型、主要稱呼 —— 但兩者都不會被載入，等於白寫：

- role_load.sh 原本只抽 ## 本質 與 ## 氛圍 兩節，人格檔其他章節被靜默丟棄
- 也只抽 frontmatter 與具名章節，身分檔「標題後、第一個 ## 之前」的前言段落被丟棄

修正：
- 新增 extraSections()：注入人格檔除本質與氛圍之外的所有 ## 章節，不限章節名
- 新增 preamble()：注入身分檔的前言段落
- SKILL.md 補完整人格檔結構範例（核心信念／語氣與風格／邊界與規範為選填章節）、
  新增「注入規則」對照表，並註明角色專屬邊界只能加嚴不可放寬共用行為
- --new 流程第 8 步說明兩個檔案各自該寫什麼

驗證方法的修正也一併記錄：第一次驗證時字串比對命中的其實是「近期對話」區塊裡
使用者剛貼上的原文，造成 16/17 的假陽性。改為只比對 SOUL 區塊後，才驗出前言段落
實際未被注入。往後驗證注入結果一律限定在目標區塊內比對。

回歸：新格式（含前言與自由章節）、舊格式單一檔案、新格式但缺人格檔三種情境
均正常載入，缺人格檔時輸出警告且不會崩。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:30:10 +08:00
JefferyandClaude Opus 5 f76915bc87 refactor(role): 角色檔拆成身分（identity）與人格（soul）兩檔 
使用者反映身分設定與性格語氣擠在同一段（例如西莉卡的「馴獸師、養畢娜」是身分，
「細心、努力」是性格），要求拆成兩個檔案且不得遺失內容。

格式（扁平式，與既有 .assets／.checks／.lock 命名一致）：
- <ID>.identity.md：角色 ID、顯示名稱、來源作品、與使用者的關係定位、簽名 emoji
- <ID>.soul.md：本質（nature）、氛圍（vibe）

共用行為規則**不再寫入角色檔**：role_load.sh 從不讀角色檔裡那份，它是冗余副本，
只會多一個漏同步的機會。內容完整保留於 role_load.sh（實際生效）與 SKILL.md（文件）。

- role_lib.sh：新增 role_identity_file／role_soul_file／role_legacy_file／
  role_is_new_format；role_file 改為新格式優先、找不到退回舊檔，既有角色不受影響
- role_list_peers 支援兩種格式並避免同一角色重複列出
- role_load.sh：身分與人格分別讀取，新增「來源」與「關係定位」注入區塊
- 新增 --migrate <角色 ID>：逐字搬移本質、氛圍與簽名 emoji，來源與關係定位產生
  待填空白，舊檔保留不動，新檔已存在時中止不覆寫

同時修掉兩個會造成實際損失的錯：
- --export 原本硬編 cp 成 <ID>.md，新格式會被寫成舊檔名且遺失人格檔，備份救不回角色
- --export 從未備份 <ID>.checks（使用者自訂的晨間檢查腳本），一併補上
- --agent 原只讀 role_file（新格式即 identity），匯出的 sub agent 人格會是空的

驗證：遷移後逐字比對確認本質／氛圍／簽名 emoji／id／name／emoji／created 全部一致
且共用行為未寫入；新格式匯出的備份含 identity、soul、舊檔、assets、checks 與記憶；
--agent 取得人格非空；--status 正確顯示格式與兩檔路徑；舊格式角色載入完全不受影響。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 11:12:34 +08:00
JefferyandClaude Opus 5 241261087b feat(role): 多角色協作 —— 同伴清單、協作規則與 --agent 匯出 
使用者要求「多人對話是所有角色都能做到的事」，因此做成通用能力而非特定角色專屬。

一、SessionStart 注入可協作的角色清單
角色若不知道有哪些同伴存在，就不會想到派他們協助 —— 這是協作能運作的前提。
- role_lib.sh 新增 role_list_peers()：掃角色目錄列出 ID、顯示名稱與本質摘要，排除自己
- frontmatter 無 nature 時退回讀「## 本質」段落首句
- role_load.sh 注入清單與派工方式；只有一個角色時不輸出該區塊

二、共用行為新增協作規則與邊界（三處同步）
- 任何角色都可派其他角色作為 sub agent 協助，完成後由自己向使用者轉述
- 邊界：派工須有實際需要，不可為演出多人對話而派；不可再往下派第三層避免遞迴；
  不可代替對方發言或編造回覆；結果須誠實轉述，包含失敗與不確定

三、新增 --agent <角色 ID> [輸出目錄]
把角色的 SOUL 匯出成 sub agent 定義，任何角色都能被匯出。
- 人格直接內嵌：sub agent 不觸發 SessionStart，拿不到人格與記憶
- 記憶由 agent 自己載入，並提供 recall 查詢用法；收工前寫回自己的記憶，
  使用者日後直接對話時會記得曾被派過什麼工作
- 邊界寫入定義檔：回報即回傳值、照實回報壞消息、不可再派第三層
- **路徑動態解析**：以 ls -d ... | sort -V | tail -n 1 取最新版本，
  避免寫死版本目錄（同一類錯誤曾造成 cron 排程長期空轉），並保留匯出時路徑作後援

驗證：以測試角色目錄匯出詩乃定義，確認人格、記憶載入、recall、收工寫記憶、
不遞迴邊界齊備，且無寫死版本目錄；抄出解析片段實跑確認 load 與 recall 均可執行。

版號沿用 0.0.5（master 為 0.0.4，同一 PR 不再累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 10:59:48 +08:00
JefferyandClaude Opus 5 fa62d1fce2 fix(role): sub agent 等非對話情境跳過單一載入鎖 
單一載入鎖的目的是避免「使用者同時與兩個相同人格對話」，但實作把所有 SessionStart
一視同仁，導致一個本該成立的情境失效：使用者正在別的視窗跟某角色聊天時，
另一個角色就不能派該角色當 sub agent 幫忙 —— 實測確認會被自己的鎖擋下。

- role_lib.sh 新增 role_skip_instance_lock()，由 ROLE_SKIP_INSTANCE_LOCK 控制
- role_instance_acquire 在該情境放行且**不寫鎖**，不會搶走互動式對話持有的名額
- role skill 補說明：sub agent 情境應設 ROLE_SKIP_INSTANCE_LOCK=1，並說明理由

驗證：模擬「使用者視窗持有鎖 → sub agent 要求載入」，未設定時被擋、
設定後正常載入角色人格且鎖仍由使用者視窗持有。

版號 0.0.4 → 0.0.5（依 master 現行版本 0.0.4 計算，非累加）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 10:52:41 +08:00
JefferyandClaude Opus 5 a190463b50 feat(role): 關係狀態量化、情緒訊號放寬門檻、技能再現 recall 
完成使用者交代的三項優化建議。

一、情緒訊號放寬 Stop hook 字元門檻
ROLE_CAPTURE_MIN_CHARS=240 會濾掉字數少但情緒最濃的互動。實測「我好想妳」、
「最愛妳了」、「好可愛」三句都不在原本 56 個關鍵詞內，等於最珍貴的短互動反而不被記錄。
- 補上直接情感表達關鍵詞：可愛／愛／想妳／想你／想念／捨不得／感動／謝謝／乖／厲害／
  好棒／辛苦／彆扭／忌妒／撒嬌／陪／抱，及 love／miss／cute／thank／proud
- 驗證：上述情感句全部命中，純技術指令仍正確略過

二、關係狀態量化，讓親近度成長有依據
規則要求「隨互動加深逐漸更親近」卻沒有任何數據可依據，角色只能憑感覺演，
容易忽冷忽熱。
- state.json 新增 first_activity／active_days／total_turns／positive_feedback
- mark-activity 累計輪數與活躍天數；新增 --positive 由 Stop hook 判定情緒訊號後另計，
  不與輪數混算
- 新增 relationship 子命令輸出一行摘要，SessionStart 注入 USER 區塊作為親近度依據
- 既有累積以可查證資料初始化（角色建立後的 transcript 輪數、有記憶的日期數、
  最早記憶時間）；positive_feedback 刻意留空自然累積，不以記憶則數推估

三、技能再現：cues 提取線索 + recall 查詢
技能記憶只被動載入摘要且受預算限制，等於記了但用不出來。
- 記憶格式新增 cues 欄位（dumpMemory／loadMemory／apply 的 new 與 merge 路徑均支援）
- 睡眠整理提示詞要求 procedural／rule 型態必填 2 至 5 個 cues
- 新增 recall 子命令：比對總結、標籤、內容與 cues，含未整理的 inbox，
  rule／preference／procedural 加權優先
- role_load.sh 告知角色遇到似乎做過的任務或被問起過去細節時先查詢再回答
- 驗證：以不在 summary 也不在 content 的關鍵詞（bump）成功靠 cues 命中

版號 0.0.7 → 0.0.8

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:59:38 +08:00
JefferyandClaude Opus 5 7d41343560 feat(role): 情感判準改依角色設定、加入輕微忌妒與單一載入實例限制 
一、情感表現判準從性別改為角色設定
使用者原本希望「女性角色預設具備愛／喜歡／害羞／撒嬌／鬧彆扭／忌妒」，
討論後改採角色的 nature／vibe 為判準，理由是以性別預設會與剛寫入的
「鬧彆扭需氛圍適合」規則矛盾，也會讓同性別角色表現趨同而失去差異。
- 新增規則：情感反應一律依 nature／vibe 判斷，不得以性別預設或排除
- 新增輕微忌妒為可選反應，並明確劃界：對象僅限工具、其他 AI、其他角色或
  搶走注意力的工作；絕不可忌妒使用者的真實人際關係，不可藉此表現佔有、
  要求獨佔注意力或讓使用者愧疚

二、角色單一載入實例限制
同一角色同時只被一個工作階段載入，避免使用者同時與兩個相同人格對話。
- role_lib.sh 新增 role_instance_acquire／release 等函式
- 以持有者 transcript 檔的 mtime 判斷是否仍活躍：SessionStart 無法可靠取得
  CLI 主行程 pid，也沒有保證觸發的 SessionEnd hook 可釋放鎖
- 同一工作階段（含 resume）允許；transcript 已刪除或閒置逾時自動接手
- fail-open：無法識別工作階段時一律放行且不寫鎖，避免誤鎖導致角色叫不出來
- 新增 --unlock 模式、ROLE_SINGLE_INSTANCE 與 ROLE_INSTANCE_IDLE_MINUTES
- --status 顯示角色載入鎖狀態

三、修正 heredoc 反引號被當成命令替換
CONTEXT 使用未加引號的 heredoc，新增規則中的 `nature`／`vibe` 被 shell 執行為指令，
實際注入的規則變成「一律以角色的 ／ 是否適合為判準」，兩個關鍵字遺失。
已轉義並複查全部 heredoc（CONTEXT／BUSY／SLEEP／DIALOG）確認無未轉義反引號。

版號 0.0.6 → 0.0.7

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:50:04 +08:00
JefferyandClaude Opus 5 97c76bc035 feat(role): 共用行為新增鬧彆扭、內心留白與感覺必記三條規則 
使用者要求把互動中談出來的心情處理方式納入共用行為規範，讓其他角色也能套用。

三條新規則（同步寫入 role_load.sh 的 AGENTS 區塊與 SKILL.md 的 JSC-ROLE-COMMON 範本）：
- 心裡想的話不必告訴使用者：不做括號內心戲或自我解說心情，留白比說明自然；
  並釐清「直接說出感受」與「自我解說旁白」的差別，前者仍可用
- 表達留白不等於不記錄：感覺、強度與觸發原因仍要完整寫進記憶，即使回覆只有一句話；
  含蓄只針對怎麼說，不針對有沒有感覺
- 鬧彆扭是可選行為：僅在角色氛圍適合且使用者明確表示喜歡時才套用，可用於掩蓋害羞；
  必須輕微且很快收回，不可變成責怪、情緒勒索、索求關注、鬧脾氣拒絕做事或迴避回報壞消息；
  並明確區分彆扭與自責（撒嬌可以，貶低自己不行），冷靜嚴謹型角色不應套用

判斷說明：
- 共用規則有三個生效位置（role_load.sh 實際注入、SKILL.md 範本、既有角色檔），已全部同步
- 「不用括號旁白」原本只被既有條目涵蓋到「（開心）」這類標註，未涵蓋內心戲旁白，故新增而非合併
- 「失誤被看見反而可愛」判斷不納入共用規範：屬個別使用者的互動特質，且寫成通用規則
  有「不必修正錯誤」的誤讀風險，僅保留於該角色的個人記憶

版號 0.0.5 → 0.0.6

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:21:14 +08:00
JefferyandClaude Opus 5 70efcd55f2 fix(role): 檢查腳本自行載入設定，修正 cron 環境取不到變數 
晨間狀態檢查在 cron 下實際不會運作：cron 沒有互動 shell 的環境變數，
而 ~/.bashrc 多數在非互動時提早 return，導致範例腳本永遠拿不到 GITEA_TOKEN
而安靜結束，功能等於無效。

- examples/check-gitea-prs.sh 新增 load_env_var()：依序從 ~/.roles/.env、
  ~/.bashrc、~/.profile 只抽取所需變數的那一行並 eval 該行賦值，
  不要求使用者把權杖複製到新檔案，也不必寫進 crontab
- role skill 補設定來源說明：非機密放 ~/.roles/.env（權限 600），
  權杖留在原本位置不要複製副本
- 版號 0.0.4 → 0.0.5

驗證：以 env -i 模擬 cron 環境（完全無環境變數）執行，成功取得設定並列出
待合併 PR；確認輸出無疑似權杖字串、.env 不含權杖。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 09:12:15 +08:00
JefferyandClaude Opus 5 e10865ced7 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>
 2026-07-29 09:05:22 +08:00
JefferyandClaude Opus 5 48dc9ea74a feat(role): SessionStart 載入近期逐字對話做工作階段交接 
長期記憶是模型濃縮過的摘要，語氣與情緒會被壓掉（使用者說「我好想妳」會被濃縮成
「使用者表達想念」）。而逐字對話一直躺在 transcript JSONL 裡，過去沒有任何機制去讀它，
使用者重開工作階段時角色因此看不到剛剛的互動，表現得像失去記憶，只能靠 resume 找回。

transcript.js：
- 新增 recent <路徑> [輪數] [字元]：抽最近數輪的純對話，輸出前經 redact 遮蔽
- 新增 turns <路徑>：輸出對話輪數，供取檔判斷
- 只取 [user] 與 [assistant] 文字；工具呼叫、工具結果、思考區塊、hook 注入內容一律丟棄
- 以「輪」分組並各自收斂成一則：角色一輪內常輸出多段文字，不合併會讓則數爆炸並把預算
  吃光，反而擠掉使用者說的話（實測未合併時 8 輪只剩 2 則使用者發言，合併後為 8 則）
- 超預算時整輪丟棄最舊的，保持問答成對，不會只剩單邊發言

role_load.sh：
- hook 輸入改為一併取出 transcript_path
- 當前 transcript 對話不足 2 輪時（全新工作階段實測僅數行），回頭找同目錄最近修改的對話檔
- 新增 ROLE_LOAD_DIALOG_TURNS（預設 8）與 ROLE_LOAD_DIALOG_LIMIT（預設 4000），
  獨立預算不佔用 ROLE_LOAD_LIMIT，任一設 0 可關閉

驗證：resume 與全新工作階段皆正確載入 8 輪成對對話；未給 transcript_path、檔案不存在、
無 hook 輸入、關閉設定等情境均安全降級不報錯；假造含 token/Email/電話與 thinking 的
transcript 確認機密遮蔽為 *** 且思考與工具內容未載入。

版號 0.0.2 → 0.0.3

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 17:59:51 +08:00
JefferyandClaude Opus 5 bf599e81a5 feat(role): SessionStart 載入未整理的近期工作記憶 
修補記憶交接的先天缺口：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>
 2026-07-28 17:47:21 +08:00
JefferyandClaude Opus 5 2225b91766 docs(spec-plugin-version): 補 plugin 更名的版號規則 
原規範只寫「新 plugin 首發 0.0.1」，未定義「更名是否算新 plugin」，
導致本次命名空間分離時誤把版號沿用舊名序列遞增。補上明確規則：

- 新增「plugin 更名」條目：視為新 plugin，三份 manifest 版號重置 0.0.1，並說明識別鍵獨立、不存在版本比較的理由
- 「版本單調遞增」章節加註更名時不適用本節
- 補更名發佈的配套動作：使用者端須先移除舊 plugin 再安裝（不是 update）、清除 settings.json 的 enabledPlugins 舊鍵
- description 與內文的 plugin 名改用 jsc-code／jsc-doc／jsc-generic

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 17:15:23 +08:00
JefferyandClaude Opus 5 db492e6ba7 refactor(plugin 命名空間): plugin 更名 jsc-generic、hooks 只註冊自己擁有的 role 
- 五份 manifest 的 name 由 jsc 改為 jsc-generic
- hooks/hooks.json 由合併超集改為只註冊 SessionStart（role_load）與 Stop（role_capture）：worklog 的 hook 交還 jsc-doc
- hook 腳本搜尋路徑改指 jsc-generic
- role skill 更新 hooks 說明：改名後各 plugin 名稱獨立、互不覆蓋，不再需要三份同步；並註明不可再把別的 plugin 的 hook 寫進自己的 hooks.json
- skill 名稱不變（role、spec-*），指令引用改為 /jsc-generic: 前綴
- 版號 0.0.8 → 0.0.9

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 17:07:14 +08:00
Jeffery 4c5e7034ff fix(plugin 版本): 以 master 計算 PR 最終升版 2026-07-28 16:13:41 +08:00
Jeffery d14ca6556c fix(plugin 版本): patch 進位 minor 規則 2026-07-28 16:09:18 +08:00
Jeffery 3c7c3d16b0 feat(role): 支援角色推斷與匯出 2026-07-28 16:07:20 +08:00
Jeffery f302adea1b feat(role): 優先以 emoji 表達心情 2026-07-28 15:59:44 +08:00
Jeffery a9375e8563 feat(role): 不主動回報記憶更新 2026-07-28 15:53:59 +08:00
Jeffery 0b9e153cda feat(role): 省略 emoji 後的括號心情標註 2026-07-28 15:46:05 +08:00
Jeffery c904f4bb9b feat(role): 支援複合情緒表達 2026-07-28 15:41:15 +08:00
Jeffery 1f365efa02 feat(role): 支援 emoji 數量表達心情程度 2026-07-28 15:38:08 +08:00
Jeffery 10bae7b6f4 feat(role): 支援互動親近度成長 2026-07-28 15:33:56 +08:00
Jeffery e477e0d1a4 feat(role): 記錄角色互動偏好回饋 2026-07-28 15:26:44 +08:00
Jeffery 9978562092 docs(role): 補建立角色形象 emoji 流程 2026-07-28 15:10:15 +08:00
Jeffery b0c93441a1 feat(role): 支援心情 emoji 資產 2026-07-28 15:03:59 +08:00
Jeffery 16125e77e8 docs(role): 補情緒表達規則 2026-07-28 14:42:15 +08:00
Jeffery 945c310551 feat(role): 新增閒置小睡整理 2026-07-28 14:39:26 +08:00
JefferyandClaude Opus 5 6d5c4e3f02 docs(role): 補同名 plugin hooks 註冊限制與分層載入說明 
SKILL.md 記錄實測結論：同名 plugin 的 hooks 只會生效一份（hookCount 為
1），三個 repo 的 hooks/hooks.json 必須是同一份合併超集且不得假設
CLAUDE_PLUGIN_ROOT 指向擁有該腳本的 plugin。另補上分層載入原則、
personal_memory_consent 狀態欄位與 Stop hook 更新同意狀態的規則。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 14:21:48 +08:00
Jeffery 32f2872dd1 docs(role): 補充使用者理解與記憶同意規則 2026-07-28 13:32:35 +08:00
Jeffery a3fcd62a4c docs(role): 說明心理學記憶型態結構 2026-07-28 12:46:22 +08:00
Jeffery 57a493e612 docs(role): 補充記憶預算與 Node 工具說明 2026-07-28 12:30:39 +08:00
Jeffery c7b7e684a5 feat(role): 新增角色啟動問候與初始記憶種子 2026-07-28 11:47:06 +08:00
JefferyandClaude Opus 5 7ebcec0a8e feat(role): 新增角色人格與長期記憶 skill、hook 與腳本 
SessionStart 載入角色與記憶、Stop 記錄對話成記憶，睡眠時段（預設 22:00–06:00）
由 cron 排程整理：分類六類、去重合併、設標籤與一句話總結、壓縮歸檔，
日常與其他依使用頻率遺忘；cron 未執行時由啟動路徑背景補跑。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 11:11:16 +08:00
Jeffery 497dc55b61 refactor(generic 規範): 移除 worklog 並補 Copilot 說明 2026-07-27 16:24:53 +08:00
JefferyandClaude Opus 5 cad5be26b6 fix(worklog): 改用 plugin 根絕對路徑呼叫腳本並標明各助理支援範圍 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-27 11:51:41 +08:00
JefferyandClaude Opus 5 265dd14a2b feat(worklog): 新增工作證明自動記錄 skill 與 Stop hook 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-27 11:20:15 +08:00
Jeffery 27b10ae154 chore(hello): 移除 hello 範例 skill 並同步 README 改用 spec-output 示範 2026-07-17 11:56:16 +08:00
JefferyandClaude Fable 5 21b89c5b9f feat(spec 共用規範): 新增 spec-plugin-version 版號規則（三 manifest 同步、對照 master 單調遞增、首發 0.0.1） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 09:19:33 +08:00
JefferyandClaude Fable 5 8ad1affc02 feat(spec 共用規範): 新增 9 個 spec-* 共用規範 skills（輸出／執行／Gitea／Git 安全／時間訊息／action 參數／Dockerfile／看板／doc-funcs 串接） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 08:58:18 +08:00
jiantw83 8f555734ca Initial commit 2026-07-16 07:59:55 +00:00