plugins/shared
2
0
Fork 0
Code Pull Requests Activity
130 Commits 2 Branches 0 Tags
c1995944d9e794e60314053f2782701f55b73338
Commit Graph
8 Commits
Author SHA1 Message Date
JefferyandClaude Opus 5 46caabe4d8 feat(role): 新增點名載入，對話中叫名字即可切換角色 
- `UserPromptSubmit` hook（`role_call.sh`）比對訊息開頭的角色名稱／ID／`aliases` 別名，
  命中即注入該角色人格與記憶並接手本輪；未點名時不輸出內容也不寫檔案。
- 抽出 `role_context.sh` 共用 context 組裝，SessionStart 與點名載入共用同一份人格與操作規則，
  避免兩種載入方式漂移；實測 SessionStart 注入內容與改動前 byte-identical。
- 新增階段角色狀態（`~/.roles/.sessions/<工作階段>.role`），`Stop` hook 改以「本階段實際角色」
  寫記憶，避免點名換人後把跟 A 的對話記進 B 的記憶。
- `SessionEnd` 改為釋放本階段名下所有角色鎖並清掉階段狀態檔。
- 切換時先確認取得目標角色鎖才釋放原角色鎖，避免出現兩個角色都沒有的空窗。
- 睡眠時段、目標角色已被其他活躍階段佔用、點名的是已在場的角色時，一律不切換。
- 新增 `ROLE_CALL_ENABLED`（總開關）與 `ROLE_CALL_MARKER_ONLY`（只認 `@名字`）。
- 順帶修正 `role_capture.sh` 的 `--postcompact` 分支在 `PROJECT` 賦值前就使用它，
  導致壓縮摘要記憶的 `sources` 一直為空。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-29 13:38:25 +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 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 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
JefferyandClaude Opus 5 65426f0c35 feat(hooks): hooks.json 統一為合併超集並改用跨 cache 解析器 
同名 plugin（三個 repo 都叫 jsc）只有一份 hooks.json 會生效，無法預期哪一
份會贏，因此三家必須同步為同一份超集。本次補上 doc 的 worklog Stop hook，
避免 generic 贏得註冊時工作紀錄靜默消失。

role 的兩個指令同步改用新解析器：先驗證 CLAUDE_PLUGIN_ROOT 下腳本存在，再
依「擁有者 marketplace 優先 → 全 cache 後援」搜尋 ~/.claude 與 ~/.codex
快取。舊版在 CLAUDE_PLUGIN_ROOT 為空時只搜 ~/.codex，且未檢查腳本是否存在
於該 plugin root。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-28 14:21:48 +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 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