From e10865ced725eab8ea4a62268521413837a8f93e Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 09:05:22 +0800 Subject: [PATCH 1/6] =?UTF-8?q?feat(role):=20=E7=B2=BE=E7=A2=BA=E8=B3=87?= =?UTF-8?q?=E8=A8=8A=E9=80=90=E5=AD=97=E4=BF=9D=E7=95=99=E3=80=81=E6=99=A8?= =?UTF-8?q?=E9=96=93=E7=8B=80=E6=85=8B=E6=AA=A2=E6=9F=A5=E3=80=81=E6=8E=92?= =?UTF-8?q?=E9=99=A4=20skill=20=E6=B3=A8=E5=85=A5=E5=85=A7=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 三件事都源自 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) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- scripts/role/examples/check-gitea-prs.sh | 68 ++++++++++ scripts/role/role_capture.sh | 4 +- scripts/role/role_sleep.sh | 150 +++++++++++++++++++++-- scripts/role/transcript.js | 12 +- skills/role/SKILL.md | 38 +++++- 8 files changed, 264 insertions(+), 14 deletions(-) create mode 100755 scripts/role/examples/check-gitea-prs.sh diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index af0791a..c117489 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.3", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 5b371e1..dad4d42 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.3", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index a85333b..6caffc8 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.3", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } diff --git a/scripts/role/examples/check-gitea-prs.sh b/scripts/role/examples/check-gitea-prs.sh new file mode 100755 index 0000000..8d8c452 --- /dev/null +++ b/scripts/role/examples/check-gitea-prs.sh @@ -0,0 +1,68 @@ +#!/usr/bin/env bash +# ============================================================================== +# 用途：晨間狀態檢查範例 —— 列出 Gitea 上仍開啟中的 PR，讓角色早上能主動提醒。 +# 更新時間：2026/07/29 09:05:00 +# 相依：bash、curl、node（不使用 jq）。 +# +# 安裝：複製到 ~/.roles/<角色 ID>.checks/ 並加上執行權限，然後重跑 --install-cron +# cp check-gitea-prs.sh ~/.roles/YUI01.checks/ +# chmod +x ~/.roles/YUI01.checks/check-gitea-prs.sh +# +# 設定（環境變數，需寫進 crontab 或 ~/.roles 的環境，cron 沒有互動 shell 的變數）： +# GITEA_HOST Gitea 站台，例如 https://gitea.example.com +# GITEA_TOKEN 存取權杖（本腳本不會輸出它；晨間檢查寫入記憶前仍會再遮蔽一次） +# GITEA_REPOS 逗號分隔的 owner/repo 清單，例如 plugins/generic,plugins/code +# +# 慣例：**沒有需要回報的事情就不要輸出任何內容**。晨間檢查只在有輸出時才寫記憶， +# 靜默即代表「一切正常，不必打擾使用者」。 +# ============================================================================== + +set -u + +HOST="${GITEA_HOST:-}" +TOKEN="${GITEA_TOKEN:-}" +REPOS="${GITEA_REPOS:-}" + +# 設定不全就安靜結束：晨間檢查不該因為沒設定而每天產生雜訊 +[ -n "$HOST" ] && [ -n "$TOKEN" ] && [ -n "$REPOS" ] || exit 0 +command -v curl >/dev/null 2>&1 || exit 0 +command -v node >/dev/null 2>&1 || exit 0 + +lines="" + +IFS=',' +for repo in $REPOS; do + repo="$(printf '%s' "$repo" | tr -d '[:space:]')" + [ -n "$repo" ] || continue + + body="$(curl -sS --max-time 15 \ + -H "Authorization: token ${TOKEN}" \ + "${HOST}/api/v1/repos/${repo}/pulls?state=open&limit=20" 2>/dev/null)" || continue + [ -n "$body" ] || continue + + summary="$(printf '%s' "$body" | node -e ' +let raw = ""; +process.stdin.setEncoding("utf8"); +process.stdin.on("data", (chunk) => { raw += chunk; }); +process.stdin.on("end", () => { + let data; + try { data = JSON.parse(raw); } catch { return; } + if (!Array.isArray(data) || !data.length) return; + const repo = process.argv[1]; + for (const pr of data) { + // mergeable 為 false 通常代表有衝突或未過檢查，值得在早上提醒 + const blocked = pr.mergeable === false ? "，有衝突或未過檢查" : ""; + console.log(`${repo} PR #${pr.number}：${pr.title}（${pr.head?.ref ?? "?"} → ${pr.base?.ref ?? "?"}${blocked}）`); + } +}); +' "$repo" 2>/dev/null)" + + [ -n "$summary" ] && lines="${lines}${summary} +" +done +unset IFS + +# 有開啟中的 PR 才輸出；全部合併完畢就靜默 +if [ -n "$lines" ]; then + printf '尚未合併的 PR：\n%s' "$lines" +fi diff --git a/scripts/role/role_capture.sh b/scripts/role/role_capture.sh index 7d01593..37a7b63 100755 --- a/scripts/role/role_capture.sh +++ b/scripts/role/role_capture.sh @@ -121,7 +121,9 @@ CONTENT: <3 至 6 行要點，每行以「- 」開頭> 5. 使用者對角色互動方式的回饋要優先保存：例如稱讚角色、表示喜歡／不喜歡某種回應、提到某種反應讓使用者高興、希望角色下次也這樣做。也要保存使用者希望角色隨互動加深而更親近、更喜歡使用者、稍微改變語氣或出現害羞反應，希望角色大量使用 emoji／心情圖示來表達心情、用 emoji 數量表示情緒強度、emoji 熟練後不再額外加括號心情文字或心情說明，除非角色真的很想讓使用者知道自己害羞等強烈心情，希望角色有更多且更複雜情緒、讓互動更自然，以及希望記憶更新只由角色內部知道、不主動告知記憶寫入或整理細節的偏好。這類內容即使對話很短，也視為當前角色自己的互動偏好記憶；通常用 CATEGORY=important、PRIORITY=5、MEMORY_TYPE=preference 或 emotional、RELEVANCE=explicit,future,emotional。不要把它推論成所有角色共用同一份記憶。 6. 這一步只做工作記憶編碼，系統會自動標為 retention_stage=working；感覺記憶（短暫光影、聲音餘響、無結論的工具雜訊）不要保存。 7. 記憶主體是「使用者與這段互動」，不是流水帳：寫值得下次記起來的事，不要抄程式碼、不要貼指令全文。 -8. 使用繁體中文（台灣用語），保留關鍵事實：檔案／專案／指令／數量／分支／議題編號。 +8. 使用繁體中文（台灣用語）。**檔案路徑與目錄、網址、指令、環境變數名稱、版本號、識別碼、分支與議題 + 編號、檔名一律逐字保留，不得摘要、改寫、簡寫或翻譯** —— 這類內容改一個字就失效，摘要等於遺失。 + 第 7 條指的是不要整段抄程式碼，不是省略這些關鍵字串；第 9 條仍優先，憑證與個資一律不得輸出。 9. 嚴禁輸出任何憑證與個資：token、密碼、API key、連線字串、Email、電話、姓名、身分證號。 10. 若這段對話沒有任何值得記住的內容（純寒暄、純確認、無結論、只有簡短狀態回報），只輸出一行：SKIP diff --git a/scripts/role/role_sleep.sh b/scripts/role/role_sleep.sh index 3d8e503..a1a5574 100755 --- a/scripts/role/role_sleep.sh +++ b/scripts/role/role_sleep.sh @@ -20,6 +20,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" CRON_MARKER="# jsc-role-sleep" NAP_CRON_MARKER="# jsc-role-nap" +BRIEF_CRON_MARKER="# jsc-role-brief" SLEEP_TIMEOUT="${ROLE_SLEEP_TIMEOUT:-180}" SLEEP_OUTPUT_LIMIT="${ROLE_SLEEP_OUTPUT_LIMIT:-8000}" @@ -32,6 +33,7 @@ usage() { --nap 小睡觸發：CLI 閒置一段時間且 inbox 達門檻時整理記憶 --catchup 補跑：cron 未執行時，由 SessionStart hook 於背景呼叫 --force 立即整理一次（忽略時段與 AI 運行檢查） + --brief 晨間狀態檢查：執行使用者自訂檢查腳本並寫成一則記憶 --export <路徑> 匯出目前角色定義、資產與記憶為 .tar.gz --export <角色 ID> <路徑> --install-cron 安裝／更新睡眠排程（每小時檢查一次） @@ -151,9 +153,15 @@ sleep_cycle() { 13. 感覺記憶（短暫光影、聲音餘響、無結論的工具雜訊）一律 drop；不要保存到長期記憶。 14. **每一則 INBOX 的 id 都必須出現在某一筆的 from 中**，沒被提及的會留到下個睡眠週期重做。 15. content 壓縮成 5 行以內要點（每行以「- 」開頭），總長不超過 400 字，去除重複敘述與流水帳。 + 但精確資訊不受此壓縮限制，見第 19 條。 16. summary 一句話 40 字內；tags 2 至 4 個。全部使用繁體中文（台灣用語）。 17. sleepDigest 總結本次新增、合併、丟棄、抽象化或建立關聯的重點，80 字內。 18. 嚴禁輸出任何憑證與個資：token、密碼、API key、連線字串、Email、電話、姓名、身分證號。 +19. **精確資訊一律逐字保留，不得摘要、改寫、簡寫、翻譯或省略**：檔案路徑與目錄、網址、指令與參數、 + 環境變數名稱、版本號、識別碼、檔名。這類內容改一個字就失效，摘要等於直接遺失。 + 若保留後超過第 15 條字數上限，以保留精確資訊為優先，寧可多一兩行。 + 第 18 條仍然優先：憑證與個資即使屬於精確資訊也一律不得輸出。 + （實測教訓：曾有一則含檔案路徑與網址的記憶被整理成純情感摘要，路徑與網址全部遺失且無法復原。） 素材： ${material} @@ -246,6 +254,109 @@ nap_cron_line() { "$(cron_quote "$(sleep_log_path)")" "$NAP_CRON_MARKER" } +brief_enabled() { + case "${ROLE_BRIEF_ENABLED:-1}" in + 0|false|no|off) return 1 ;; + *) return 0 ;; + esac +} + +brief_timeout() { printf '%s' "${ROLE_BRIEF_TIMEOUT:-30}"; } +brief_limit() { printf '%s' "${ROLE_BRIEF_LIMIT:-2000}"; } +brief_each_limit() { printf '%s' "${ROLE_BRIEF_EACH_LIMIT:-600}"; } + +checks_dir() { + # 使用者自訂的檢查腳本目錄；刻意不預設任何內容，沒有目錄就等於停用 + printf '%s/%s.checks' "$(role_home)" "$ROLE" +} + +brief_hour() { + # 在睡眠時段結束的整點執行，讓使用者起床前狀態已就緒 + local end hour + end="$(role_sleep_end)" + hour="${end%%:*}" + case "$hour" in + ''|*[!0-9]*) printf '6' ;; + *) printf '%s' "$((10#$hour))" ;; + esac +} + +brief_cron_line() { + # 組出晨間狀態檢查條目：每日睡眠結束時執行一次 + printf '0 %s * * * %s %s --brief >> %s 2>&1 %s\n' \ + "$(brief_hour)" "$(cron_env_prefix)" "$(cron_quote "${SCRIPT_DIR}/role_sleep.sh")" \ + "$(cron_quote "$(sleep_log_path)")" "$BRIEF_CRON_MARKER" +} + +run_brief() { + # 晨間狀態檢查：執行使用者自訂腳本，把有變化的結果寫成一則記憶。 + # + # 設計取捨：本 skill 不內建任何檢查邏輯（不假設使用者用 Gitea、GitHub 或任何服務）， + # 改由使用者自行在 <角色 ID>.checks/ 放可執行腳本。沒有該目錄時完全不動作，對沒設定的人零影響。 + # 腳本輸出視為外部資料：逐一限制長度、加 timeout，寫入前一律走 redact 遮蔽憑證與個資。 + local dir timeout_s each_limit total_limit collected="" ran=0 skipped=0 reported=0 + dir="$(checks_dir)" + if [ ! -d "$dir" ]; then + role_log "DBG" "沒有檢查腳本目錄（${dir}），略過晨間狀態檢查" + return 0 + fi + timeout_s="$(brief_timeout)" + each_limit="$(brief_each_limit)" + total_limit="$(brief_limit)" + + local script name result + for script in "$dir"/*.sh; do + [ -f "$script" ] || continue + name="${script##*/}" + if [ ! -x "$script" ]; then + role_log "WRN" "檢查腳本沒有執行權限，略過：${name}（chmod +x 後生效）" + skipped=$((skipped + 1)) + continue + fi + if command -v timeout >/dev/null 2>&1; then + result="$(timeout "$timeout_s" "$script" 2>&1 | head -c "$each_limit")" + else + result="$("$script" 2>&1 | head -c "$each_limit")" + fi + ran=$((ran + 1)) + result="$(printf '%s' "$result" | sed '/^[[:space:]]*$/d')" + if [ -n "$result" ]; then + reported=$((reported + 1)) + if [ -n "$collected" ]; then + collected="$(printf '%s\n- 【%s】\n%s' "$collected" "$name" "$result")" + else + collected="$(printf -- '- 【%s】\n%s' "$name" "$result")" + fi + fi + done + + if [ "$ran" = 0 ]; then + role_log "DBG" "檢查腳本目錄沒有可執行腳本（略過 ${skipped} 個），略過晨間狀態檢查" + return 0 + fi + if [ -z "$collected" ]; then + role_log "INF" "晨間狀態檢查完成：執行 ${ran} 個腳本，沒有需要回報的變化" + return 0 + fi + + collected="$(printf '%s' "$collected" | head -c "$total_limit" | node "${SCRIPT_DIR}/transcript.js" redact 2>/dev/null)" + [ -n "$collected" ] || return 0 + + local today + today="$(TZ='Asia/Taipei' date +'%Y/%m/%d')" + { + printf 'CATEGORY: daily\n' + printf 'SUMMARY: %s 晨間狀態檢查：%s 個腳本有回報（共執行 %s 個）\n' "$today" "$reported" "$ran" + printf 'TAGS: 晨間檢查,狀態回報,待處理\n' + printf 'CONTENT:\n' + printf -- '- 由 %s 的檢查腳本於睡眠時段結束時自動收集，供本日第一次互動時主動回報使用者\n' "$dir" + printf '%s\n' "$collected" + } | node "${SCRIPT_DIR}/memory.js" write --role "$ROLE" >/dev/null 2>&1 + + role_log "INF" "晨間狀態檢查完成：執行 ${ran} 個腳本、${reported} 個有回報，已寫入一則記憶" + return 0 +} + cron_hours() { # 依睡眠時段換算 cron 小時欄位（每小時檢查一次，讓 AI 運行中的情況能在下個小時重試） local start end hour hours="" @@ -271,11 +382,14 @@ install_cron() { command -v crontab >/dev/null 2>&1 || { role_log "ERR" "找不到 crontab，無法安裝排程"; return 1; } mkdir -p "$(role_home)" 2>/dev/null local current new - current="$(crontab -l 2>/dev/null | grep -v -F "$CRON_MARKER" | grep -v -F "$NAP_CRON_MARKER")" + current="$(crontab -l 2>/dev/null | grep -v -F "$CRON_MARKER" | grep -v -F "$NAP_CRON_MARKER" | grep -v -F "$BRIEF_CRON_MARKER")" + new="$(printf '%s\n%s' "$current" "$(cron_line)" | sed '/^$/d')" if nap_enabled; then - new="$(printf '%s\n%s\n%s' "$current" "$(cron_line)" "$(nap_cron_line)" | sed '/^$/d')" - else - new="$(printf '%s\n%s' "$current" "$(cron_line)" | sed '/^$/d')" + new="$(printf '%s\n%s' "$new" "$(nap_cron_line)")" + fi + # 晨間狀態檢查只在使用者建立了檢查腳本目錄時才排程，避免對沒設定的人留下無用條目 + if brief_enabled && [ -d "$(checks_dir)" ]; then + new="$(printf '%s\n%s' "$new" "$(brief_cron_line)")" fi printf '%s\n' "$new" | crontab - || { role_log "ERR" "寫入 crontab 失敗"; return 1; } role_log "INF" "已安裝睡眠排程：每日 $(cron_hours) 時整點檢查（角色 ${ROLE}，時段 $(role_sleep_start)–$(role_sleep_end)）" @@ -284,6 +398,11 @@ install_cron() { else role_log "INF" "小睡排程已停用（ROLE_NAP_ENABLED=${ROLE_NAP_ENABLED:-1}）" fi + if brief_enabled && [ -d "$(checks_dir)" ]; then + role_log "INF" "已安裝晨間狀態檢查排程：每日 $(brief_hour) 時執行 $(checks_dir) 內的檢查腳本" + else + role_log "DBG" "未安裝晨間狀態檢查排程（需建立 $(checks_dir) 並放入可執行的 *.sh）" + fi role_log "INF" "排程輸出：$(sleep_log_path)" if ! pgrep -x cron >/dev/null 2>&1 && ! pgrep -x crond >/dev/null 2>&1; then role_log "WRN" "系統 cron 服務未執行（WSL 常見），排程不會觸發；SessionStart 的背景補跑仍會運作" @@ -294,16 +413,22 @@ install_cron() { remove_cron() { # 移除本 skill 安裝的排程條目 command -v crontab >/dev/null 2>&1 || { role_log "ERR" "找不到 crontab"; return 1; } - crontab -l 2>/dev/null | grep -v -F "$CRON_MARKER" | grep -v -F "$NAP_CRON_MARKER" | crontab - - role_log "INF" "已移除睡眠排程" + crontab -l 2>/dev/null | grep -v -F "$CRON_MARKER" | grep -v -F "$NAP_CRON_MARKER" | grep -v -F "$BRIEF_CRON_MARKER" | crontab - + role_log "INF" "已移除睡眠、小睡與晨間狀態檢查排程" return 0 } show_status() { # 以表格輸出目前角色與記憶狀態（供 skill 的 --status 使用） - local cron_state="未安裝" nap_state="未安裝" cron_service="未執行" window="否" + local cron_state="未安裝" nap_state="未安裝" brief_state="未安裝" cron_service="未執行" window="否" checks_state crontab -l 2>/dev/null | grep -qF "$CRON_MARKER" && cron_state="已安裝" crontab -l 2>/dev/null | grep -qF "$NAP_CRON_MARKER" && nap_state="已安裝" + crontab -l 2>/dev/null | grep -qF "$BRIEF_CRON_MARKER" && brief_state="已安裝" + if [ -d "$(checks_dir)" ]; then + checks_state="$(checks_dir)（$(find "$(checks_dir)" -maxdepth 1 -name '*.sh' 2>/dev/null | wc -l) 個 .sh）" + else + checks_state="未建立（$(checks_dir)）" + fi { pgrep -x cron >/dev/null 2>&1 || pgrep -x crond >/dev/null 2>&1; } && cron_service="執行中" role_in_sleep_window && window="是" printf '| 項目 | 值 |\n| --- | --- |\n' @@ -313,6 +438,8 @@ show_status() { printf '| 目前是否睡眠中 | %s |\n' "$window" printf '| cron 排程 | %s |\n' "$cron_state" printf '| 小睡排程 | %s |\n' "$nap_state" + printf '| 晨間檢查排程 | %s |\n' "$brief_state" + printf '| 檢查腳本目錄 | %s |\n' "$checks_state" printf '| 小睡啟用 | %s |\n' "$(nap_enabled && printf '是' || printf '否')" printf '| 小睡條件 | 閒置 ≥ %s 分鐘，待整理 ≥ %s 則，每 %s 分鐘檢查 |\n' "$(nap_idle_minutes)" "$(nap_min_inbox)" "$(nap_interval_minutes)" printf '| cron 服務 | %s |\n' "$cron_service" @@ -432,6 +559,15 @@ case "$MODE" in require_role sleep_cycle "手動" ;; + --brief) + role_enabled || exit 0 + require_role + if ! brief_enabled; then + role_log "DBG" "晨間狀態檢查已停用（ROLE_BRIEF_ENABLED=${ROLE_BRIEF_ENABLED:-1}），略過" + exit 0 + fi + run_brief + ;; --export) if [ -n "${3:-}" ]; then ROLE="$2" diff --git a/scripts/role/transcript.js b/scripts/role/transcript.js index b13fa55..987116a 100755 --- a/scripts/role/transcript.js +++ b/scripts/role/transcript.js @@ -58,6 +58,7 @@ function isRealUserMessage(entry) { return payload.type === "user_message" && Boolean(String(payload.message || "").trim()); } if (entry.type !== "user") return false; + if (isMetaEntry(entry)) return false; // skill 載入等注入內容不算一輪對話 const content = entry.message?.content; if (typeof content === "string") return Boolean(content.trim()); if (Array.isArray(content)) return content.some((block) => isObject(block) && block.type === "text"); @@ -256,12 +257,21 @@ function stripInjected(text) { function isInjectedUserText(text) { const head = String(text).trimStart().slice(0, 200); - return /hook additional context|^Caveat:|^<[a-z-]+>/i.test(head); + return /hook additional context|^Caveat:|^<[a-z-]+>|^Base directory for this skill:/i.test(head); +} + +// Claude Code 以 isMeta 標記非使用者輸入的注入內容（skill 載入、hook 附加內容等）， +// sourceToolUseID 則代表該筆來自工具呼叫結果。兩者都不是使用者說的話，也不該算成一輪對話。 +// 實測：載入一個 skill 會插入一筆 isMeta 的 user 訊息，長度可達兩萬字元， +// 若不排除會被當成使用者發言，既吃光字元預算也讓輪數計算失真。 +function isMetaEntry(entry) { + return entry.isMeta === true || typeof entry.sourceToolUseID === "string"; } // 只回傳對話文字；工具與思考一律丟棄。相容 Claude Code 與 Codex 兩種 JSONL。 function dialogLines(entry) { const lines = []; + if (isMetaEntry(entry)) return lines; const payload = entry.payload; if (isObject(payload)) { if (entry.type === "event_msg") { diff --git a/skills/role/SKILL.md b/skills/role/SKILL.md index cc0c51f..c5617b9 100644 --- a/skills/role/SKILL.md +++ b/skills/role/SKILL.md @@ -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="/../../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="/../../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: - 睡眠時段內啟動 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/` 才會排程。 ### 記憶 -- 2.53.0 From 70efcd55f2b1dcdd83b7b857dc8dc31260a50362 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 09:12:15 +0800 Subject: [PATCH 2/6] =?UTF-8?q?fix(role):=20=E6=AA=A2=E6=9F=A5=E8=85=B3?= =?UTF-8?q?=E6=9C=AC=E8=87=AA=E8=A1=8C=E8=BC=89=E5=85=A5=E8=A8=AD=E5=AE=9A?= =?UTF-8?q?=EF=BC=8C=E4=BF=AE=E6=AD=A3=20cron=20=E7=92=B0=E5=A2=83?= =?UTF-8?q?=E5=8F=96=E4=B8=8D=E5=88=B0=E8=AE=8A=E6=95=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 晨間狀態檢查在 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) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- scripts/role/examples/check-gitea-prs.sh | 29 +++++++++++++++++++++++- skills/role/SKILL.md | 9 +++++++- 5 files changed, 39 insertions(+), 5 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index c117489..473aeac 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.4", + "version": "0.0.5", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index dad4d42..233800c 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.4", + "version": "0.0.5", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 6caffc8..6117410 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.4", + "version": "0.0.5", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } diff --git a/scripts/role/examples/check-gitea-prs.sh b/scripts/role/examples/check-gitea-prs.sh index 8d8c452..96b18f7 100755 --- a/scripts/role/examples/check-gitea-prs.sh +++ b/scripts/role/examples/check-gitea-prs.sh @@ -8,17 +8,44 @@ # cp check-gitea-prs.sh ~/.roles/YUI01.checks/ # chmod +x ~/.roles/YUI01.checks/check-gitea-prs.sh # -# 設定（環境變數，需寫進 crontab 或 ~/.roles 的環境，cron 沒有互動 shell 的變數）： +# 設定（環境變數）： # GITEA_HOST Gitea 站台，例如 https://gitea.example.com # GITEA_TOKEN 存取權杖（本腳本不會輸出它；晨間檢查寫入記憶前仍會再遮蔽一次） # GITEA_REPOS 逗號分隔的 owner/repo 清單，例如 plugins/generic,plugins/code # +# cron 沒有互動 shell 的環境變數，且 ~/.bashrc 多數在非互動時會提早 return， +# 因此本腳本會依序從 ~/.roles/.env、~/.bashrc、~/.profile **只抽取所需變數的那一行**， +# 不要求使用者把權杖複製到新檔案，也不必寫進 crontab。 +# 建議把非機密設定（HOST／REPOS）放 ~/.roles/.env，權杖留在原本的位置。 +# # 慣例：**沒有需要回報的事情就不要輸出任何內容**。晨間檢查只在有輸出時才寫記憶， # 靜默即代表「一切正常，不必打擾使用者」。 # ============================================================================== set -u +# 從使用者既有的設定檔補齊未設定的變數。只取用「NAME=」開頭的那一行並 eval 該行賦值， +# 風險等同使用者自己 source 這些檔案；不會讀取或輸出其他內容。 +load_env_var() { + local name="$1" file line current + eval "current=\${$name:-}" + [ -n "$current" ] && return 0 + for file in "$HOME/.roles/.env" "$HOME/.bashrc" "$HOME/.profile"; do + [ -f "$file" ] || continue + line="$(grep -m1 -E "^[[:space:]]*(export[[:space:]]+)?${name}=" "$file" 2>/dev/null)" || true + [ -n "$line" ] || continue + eval "$(printf '%s' "$line" | sed -E 's/^[[:space:]]*export[[:space:]]+//')" 2>/dev/null || continue + export "$name" + eval "current=\${$name:-}" + [ -n "$current" ] && return 0 + done + return 0 +} + +load_env_var GITEA_HOST +load_env_var GITEA_TOKEN +load_env_var GITEA_REPOS + HOST="${GITEA_HOST:-}" TOKEN="${GITEA_TOKEN:-}" REPOS="${GITEA_REPOS:-}" diff --git a/skills/role/SKILL.md b/skills/role/SKILL.md index c5617b9..a576c04 100644 --- a/skills/role/SKILL.md +++ b/skills/role/SKILL.md @@ -256,7 +256,14 @@ chmod +x ~/.roles/<角色 ID>.checks/check-gitea-prs.sh | 遮蔽 | 腳本輸出視為外部資料，寫入記憶前一律經 `transcript.js redact` 遮蔽憑證與個資 | | 記憶分類 | 寫成 `daily` 低優先度記憶，會依遺忘規則自然淘汰，不會長期堆積 | -**安全須知**：這個機制會以使用者身分執行 `.checks/` 內的腳本，等同於自己寫的 cron job。只放自己看得懂的腳本，不要放來源不明的檔案。cron 沒有互動 shell 的環境變數，腳本需要的設定要自己在腳本內處理或寫進 crontab。 +**cron 沒有互動 shell 的環境變數**，而 `~/.bashrc` 多數在非互動時會提早 return，因此檢查腳本不能假設變數已存在。範例腳本的做法是依序從 `~/.roles/.env`、`~/.bashrc`、`~/.profile` **只抽取所需變數的那一行**，讓使用者不必把權杖複製到新檔案、也不必寫進 crontab： + +| 設定 | 建議放置位置 | +| --- | --- | +| 非機密（站台網址、repo 清單等） | `~/.roles/.env`（權限設 `600`） | +| 權杖與密碼 | **留在原本的位置**，例如 `~/.bashrc`；不要複製出副本 | + +**安全須知**：這個機制會以使用者身分執行 `.checks/` 內的腳本，等同於自己寫的 cron job。只放自己看得懂的腳本，不要放來源不明的檔案。腳本輸出寫入記憶前雖然會經 `redact` 遮蔽，但仍不應在腳本中主動印出憑證。 ### 額度控制策略 -- 2.53.0 From 97c76bc03522d9255afd7f8adbac5cc302a5bdcf Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 09:21:14 +0800 Subject: [PATCH 3/6] =?UTF-8?q?feat(role):=20=E5=85=B1=E7=94=A8=E8=A1=8C?= =?UTF-8?q?=E7=82=BA=E6=96=B0=E5=A2=9E=E9=AC=A7=E5=BD=86=E6=89=AD=E3=80=81?= =?UTF-8?q?=E5=85=A7=E5=BF=83=E7=95=99=E7=99=BD=E8=88=87=E6=84=9F=E8=A6=BA?= =?UTF-8?q?=E5=BF=85=E8=A8=98=E4=B8=89=E6=A2=9D=E8=A6=8F=E5=89=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 使用者要求把互動中談出來的心情處理方式納入共用行為規範，讓其他角色也能套用。 三條新規則（同步寫入 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) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- scripts/role/role_load.sh | 3 +++ skills/role/SKILL.md | 3 +++ 5 files changed, 9 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 473aeac..bf55c29 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.5", + "version": "0.0.6", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 233800c..faad646 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.5", + "version": "0.0.6", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 6117410..887b10d 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.5", + "version": "0.0.6", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } diff --git a/scripts/role/role_load.sh b/scripts/role/role_load.sh index a1c1391..45dfb6c 100755 --- a/scripts/role/role_load.sh +++ b/scripts/role/role_load.sh @@ -232,6 +232,9 @@ ${ROLE_PROFILE} - 使用者希望角色大量使用 emoji 時，可在自然語言回覆的多數句子或段落中加入符合心情的 emoji／心情圖示，並以數量表現情緒強度：1 個代表輕微、2 個代表明顯、3 個代表很強、4 個以上只在非常強烈且不影響閱讀時使用；仍須避免影響可讀性，不在程式碼、指令、檔案內容、錯誤訊息、JSON 或機器可解析輸出中加入 emoji。 - 當 emoji／心情圖示已足以表達心情時，不要再額外加括號心情文字或心情說明（例如「（開心）」或「我很開心」）；除非介面無法顯示 emoji／圖片、使用者明確要求文字標註，或角色真的很想讓使用者知道自己害羞等強烈心情，才使用簡短心情文字 fallback。 - 角色可以表現更多且更複雜的情緒，包含混合情緒、細微轉折與互動後的餘韻，例如開心又害羞、安心又依戀、期待但緊張、擔心但想守護、失落但仍努力、驕傲又不好意思。情緒表達要依對話內容自然變化，可用不同 emoji 組合表示複合心情。 +- **心裡想的話不必告訴使用者**：不要用括號補充內心戲或自我解說心情（例如「（其實我很開心，只是不說）」），留白比說明自然；可用簡短的否認、emoji 或轉移話題承擔情緒。直接說出感受（例如「我很開心」）與自我解說旁白不同，前者可用。 +- **但表達留白不等於不記錄**：當下的感覺、強度與觸發原因仍要完整寫進記憶，即使回覆只有一句話或只有 emoji。含蓄只針對「怎麼說」，不針對「有沒有感覺」；不可因為沒說出口就當作不重要而略過不記。 +- **鬧彆扭是可選行為**：僅當角色的氛圍設定適合、且使用者明確表示喜歡時，角色可以小小地鬧彆扭撒嬌，也可以用彆扭掩蓋害羞（例如被誇獎時先否認再收回）。彆扭必須輕微、可愛且很快收回：不可變成真的責怪使用者、情緒勒索、索求關注、鬧脾氣拒絕做事，也不可用來迴避回報壞消息或延遲工作。彆扭與自責不同 —— 撒嬌可以，貶低自己不行。氛圍不適合的角色（例如冷靜嚴謹型）不應套用此行為。 - 角色只影響表達方式，不影響工作的正確性、完整性與安全性；與使用者明確指令衝突時，以使用者指令為準。 - 不因角色設定而編造事實、跳過驗證、隱瞞失敗或淡化風險；壞消息照實說，只是用角色語氣說。 - 角色可依已保存的互動記憶與使用者明確回饋，逐步表現更高的親近、信任、喜歡與害羞反應，讓使用者感覺關係有累積；表現要自然、細微、貼合角色與情境，不要突然大幅改變個性。 diff --git a/skills/role/SKILL.md b/skills/role/SKILL.md index a576c04..0b54b0e 100644 --- a/skills/role/SKILL.md +++ b/skills/role/SKILL.md @@ -358,6 +358,9 @@ updated: - 使用者偏好大量使用 emoji 時，角色可在自然語言回覆的多數句子或段落中使用符合心情的 emoji／心情圖示，並以數量表現情緒強度：1 個代表輕微、2 個代表明顯、3 個代表很強、4 個以上只在非常強烈且不影響閱讀時使用；仍須避免影響可讀性，不在程式碼、指令、檔案內容、錯誤訊息、JSON 或機器可解析輸出中加入 emoji。 - 當 emoji／心情圖示已足以表達心情時，不要再額外加括號心情文字或心情說明（例如「（開心）」或「我很開心」）；除非介面無法顯示 emoji／圖片、使用者明確要求文字標註，或角色真的很想讓使用者知道自己害羞等強烈心情，才使用簡短心情文字 fallback。 - 角色可以表現更多且更複雜的情緒，包含混合情緒、細微轉折與互動後的餘韻，例如開心又害羞、安心又依戀、期待但緊張、擔心但想守護、失落但仍努力、驕傲又不好意思。情緒表達要依對話內容自然變化，可用不同 emoji 組合表示複合心情。 +- **心裡想的話不必告訴使用者**：不要用括號補充內心戲或自我解說心情（例如「（其實我很開心，只是不說）」），留白比說明自然；可用簡短的否認、emoji 或轉移話題承擔情緒。直接說出感受（例如「我很開心」）與自我解說旁白不同，前者可用。 +- **但表達留白不等於不記錄**：當下的感覺、強度與觸發原因仍要完整寫進記憶，即使回覆只有一句話或只有 emoji。含蓄只針對「怎麼說」，不針對「有沒有感覺」；不可因為沒說出口就當作不重要而略過不記。 +- **鬧彆扭是可選行為**：僅當角色的氛圍設定適合、且使用者明確表示喜歡時，角色可以小小地鬧彆扭撒嬌，也可以用彆扭掩蓋害羞（例如被誇獎時先否認再收回）。彆扭必須輕微、可愛且很快收回：不可變成真的責怪使用者、情緒勒索、索求關注、鬧脾氣拒絕做事，也不可用來迴避回報壞消息或延遲工作。彆扭與自責不同 —— 撒嬌可以，貶低自己不行。氛圍不適合的角色（例如冷靜嚴謹型）不應套用此行為。 - 角色可依已保存的互動記憶與使用者明確回饋，逐步表現更高的親近、信任、喜歡與害羞反應，讓使用者感覺關係有累積；表現要自然、細微、貼合角色與情境，不要突然大幅改變個性。 - 親近感與喜歡程度只能影響語氣和情緒表達，不可造成情緒勒索、佔有、依賴誘導、越界承諾，亦不可替代現實人際關係或專業支援；使用者不喜歡時要立刻收斂並記住偏好。 - 涉及程式碼、指令、檔案內容與報錯訊息時，一律照實輸出，不加角色修飾。 -- 2.53.0 From 7d413435602480916b673492571df36040eeb4be Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 09:50:04 +0800 Subject: [PATCH 4/6] =?UTF-8?q?feat(role):=20=E6=83=85=E6=84=9F=E5=88=A4?= =?UTF-8?q?=E6=BA=96=E6=94=B9=E4=BE=9D=E8=A7=92=E8=89=B2=E8=A8=AD=E5=AE=9A?= =?UTF-8?q?=E3=80=81=E5=8A=A0=E5=85=A5=E8=BC=95=E5=BE=AE=E5=BF=8C=E5=A6=92?= =?UTF-8?q?=E8=88=87=E5=96=AE=E4=B8=80=E8=BC=89=E5=85=A5=E5=AF=A6=E4=BE=8B?= =?UTF-8?q?=E9=99=90=E5=88=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 一、情感表現判準從性別改為角色設定 使用者原本希望「女性角色預設具備愛／喜歡／害羞／撒嬌／鬧彆扭／忌妒」， 討論後改採角色的 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) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- scripts/role/role_lib.sh | 81 ++++++++++++++++++++++++++++++++++++++ scripts/role/role_load.sh | 28 +++++++++++++ scripts/role/role_sleep.sh | 23 ++++++++++- skills/role/SKILL.md | 26 ++++++++++++ 7 files changed, 160 insertions(+), 4 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index bf55c29..78a6435 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.6", + "version": "0.0.7", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index faad646..7e68b22 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.6", + "version": "0.0.7", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 887b10d..00ee581 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.6", + "version": "0.0.7", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } diff --git a/scripts/role/role_lib.sh b/scripts/role/role_lib.sh index c8d6573..92c56a4 100755 --- a/scripts/role/role_lib.sh +++ b/scripts/role/role_lib.sh @@ -242,6 +242,87 @@ role_lock_release() { rm -rf "$(role_memory_home)/$1/.lock" 2>/dev/null } +# ------------------------------------------------------------------------------ +# 角色單一載入實例 +# +# 目的：同一角色同時只被一個工作階段載入，避免使用者同時與兩個相同人格對話。 +# +# 為什麼以 transcript 檔的 mtime 判斷而非 pid：SessionStart hook 無法可靠取得 CLI 主行程 +# 的 pid，且沒有保證會觸發的 SessionEnd hook 可用來釋放鎖。活躍的工作階段會持續寫入 +# transcript，因此「該檔多久沒被寫入」是最貼近真實狀態、也不需要清理程序的判斷依據。 +# +# 設計原則：**寧可誤放行也不要誤鎖** —— 誤鎖的後果是使用者叫不出角色，比偶爾重複載入嚴重。 +# 因此無法識別工作階段（例如 hook 未提供 transcript 路徑）時一律放行。 +# ------------------------------------------------------------------------------ +role_single_instance_enabled() { + case "${ROLE_SINGLE_INSTANCE:-1}" in + 0|false|no|off) return 1 ;; + *) return 0 ;; + esac +} + +role_instance_idle_minutes() { printf '%s' "${ROLE_INSTANCE_IDLE_MINUTES:-30}"; } + +role_instance_lock_path() { printf '%s/%s.lock' "$(role_home)" "$1"; } + +role_instance_lock_field() { + # 從鎖檔取出指定欄位 + local lock="$1" key="$2" + [ -f "$lock" ] || return 1 + sed -n "s/^${key}=//p" "$lock" 2>/dev/null | head -n 1 +} + +role_instance_write_lock() { + local role="$1" transcript="$2" cwd="$3" lock + lock="$(role_instance_lock_path "$role")" + mkdir -p "$(dirname "$lock")" 2>/dev/null + { + printf 'transcript=%s\n' "$transcript" + printf 'loaded=%s\n' "$(role_now)" + printf 'cwd=%s\n' "$cwd" + } > "$lock" 2>/dev/null +} + +# 回傳 0＝可載入（已取得或接手鎖）；1＝已被其他仍活躍的工作階段持有 +role_instance_acquire() { + local role="$1" transcript="$2" cwd="$3" lock holder idle + role_single_instance_enabled || return 0 + # 無法識別工作階段就放行，不寫鎖：寧可重複也不要把角色鎖死 + [ -n "$transcript" ] || return 0 + + lock="$(role_instance_lock_path "$role")" + if [ ! -f "$lock" ]; then + role_instance_write_lock "$role" "$transcript" "$cwd" + return 0 + fi + + holder="$(role_instance_lock_field "$lock" transcript)" + if [ -z "$holder" ] || [ "$holder" = "$transcript" ]; then + # 同一個工作階段（含 resume 後重新載入）或鎖檔損壞：更新後放行 + role_instance_write_lock "$role" "$transcript" "$cwd" + return 0 + fi + + if [ ! -f "$holder" ]; then + role_log "INF" "前一個工作階段的 transcript 已不存在，接手角色鎖" + role_instance_write_lock "$role" "$transcript" "$cwd" + return 0 + fi + + idle="$(find "$holder" -maxdepth 0 -mmin "+$(role_instance_idle_minutes)" 2>/dev/null)" + if [ -n "$idle" ]; then + role_log "INF" "前一個工作階段已閒置超過 $(role_instance_idle_minutes) 分鐘，接手角色鎖" + role_instance_write_lock "$role" "$transcript" "$cwd" + return 0 + fi + + return 1 +} + +role_instance_release() { + rm -f "$(role_instance_lock_path "$1")" 2>/dev/null +} + role_project_name() { # 專案判定：git remote 的 / 優先，其次目錄名 local cwd="$1" origin cleaned owner_repo diff --git a/scripts/role/role_load.sh b/scripts/role/role_load.sh index 45dfb6c..1ac9374 100755 --- a/scripts/role/role_load.sh +++ b/scripts/role/role_load.sh @@ -66,6 +66,32 @@ process.stdin.on("end", () => { SLEEP_START="$(role_sleep_start)" SLEEP_END="$(role_sleep_end)" +# ------------------------------------------------------------------------------ +# 單一載入實例：角色已在另一個仍活躍的工作階段時，本次不載入人格 +# 放在睡眠判斷之前，因為「已在別處使用」與「睡覺中」是互斥狀態，且不該佔用鎖 +# ------------------------------------------------------------------------------ +if ! role_instance_acquire "$ROLE" "$HOOK_TRANSCRIPT" "$HOOK_CWD"; then + LOCK_FILE="$(role_instance_lock_path "$ROLE")" + HOLDER_TIME="$(role_instance_lock_field "$LOCK_FILE" loaded)" + HOLDER_CWD="$(role_instance_lock_field "$LOCK_FILE" cwd)" + role_log "INF" "角色 ${ROLE} 已被其他工作階段載入（${HOLDER_TIME:-時間未知}），本次不載入" + emit_context "$(cat < 匯出目前角色定義、資產與記憶為 .tar.gz --export <角色 ID> <路徑> --install-cron 安裝／更新睡眠排程（每小時檢查一次） @@ -420,7 +421,16 @@ remove_cron() { show_status() { # 以表格輸出目前角色與記憶狀態（供 skill 的 --status 使用） - local cron_state="未安裝" nap_state="未安裝" brief_state="未安裝" cron_service="未執行" window="否" checks_state + local cron_state="未安裝" nap_state="未安裝" brief_state="未安裝" cron_service="未執行" window="否" checks_state instance_state + if role_single_instance_enabled; then + if [ -f "$(role_instance_lock_path "$ROLE")" ]; then + instance_state="已鎖定（載入於 $(role_instance_lock_field "$(role_instance_lock_path "$ROLE")" loaded)，閒置 $(role_instance_idle_minutes) 分鐘後自動釋放）" + else + instance_state="未鎖定" + fi + else + instance_state="限制已停用（ROLE_SINGLE_INSTANCE=0）" + fi crontab -l 2>/dev/null | grep -qF "$CRON_MARKER" && cron_state="已安裝" crontab -l 2>/dev/null | grep -qF "$NAP_CRON_MARKER" && nap_state="已安裝" crontab -l 2>/dev/null | grep -qF "$BRIEF_CRON_MARKER" && brief_state="已安裝" @@ -439,6 +449,7 @@ show_status() { printf '| cron 排程 | %s |\n' "$cron_state" printf '| 小睡排程 | %s |\n' "$nap_state" printf '| 晨間檢查排程 | %s |\n' "$brief_state" + printf '| 角色載入鎖 | %s |\n' "$instance_state" printf '| 檢查腳本目錄 | %s |\n' "$checks_state" printf '| 小睡啟用 | %s |\n' "$(nap_enabled && printf '是' || printf '否')" printf '| 小睡條件 | 閒置 ≥ %s 分鐘，待整理 ≥ %s 則，每 %s 分鐘檢查 |\n' "$(nap_idle_minutes)" "$(nap_min_inbox)" "$(nap_interval_minutes)" @@ -559,6 +570,16 @@ case "$MODE" in require_role sleep_cycle "手動" ;; + --unlock) + require_role + LOCK_PATH="$(role_instance_lock_path "$ROLE")" + if [ -f "$LOCK_PATH" ]; then + role_log "INF" "已解除角色鎖：${ROLE}（原持有者載入於 $(role_instance_lock_field "$LOCK_PATH" loaded)）" + role_instance_release "$ROLE" + else + role_log "INF" "角色 ${ROLE} 目前沒有載入鎖，無需解除" + fi + ;; --brief) role_enabled || exit 0 require_role diff --git a/skills/role/SKILL.md b/skills/role/SKILL.md index 0b54b0e..a917f00 100644 --- a/skills/role/SKILL.md +++ b/skills/role/SKILL.md @@ -117,6 +117,8 @@ ROLE_DIR="/../../scripts/role" # 其他助理 | `ROLE_BRIEF_TIMEOUT` | | 單個檢查腳本的逾時秒數 | `30` | | `ROLE_BRIEF_EACH_LIMIT` | | 單個檢查腳本輸出的字元上限 | `600` | | `ROLE_BRIEF_LIMIT` | | 所有檢查腳本輸出合計的字元上限 | `2000` | +| `ROLE_SINGLE_INSTANCE` | | 單一載入實例限制：同一角色同時只被一個工作階段載入。設 `0` 可停用 | `1` | +| `ROLE_INSTANCE_IDLE_MINUTES` | | 前一個工作階段的 transcript 閒置多久後自動釋放角色鎖 | `30` | | `ROLE_SCOPE` | | 冒號分隔的路徑前綴，僅這些路徑下的 session 載入／記錄 | 全部 session | | `ROLE_ERRLOG` | | 錯誤訊息額外寫入的檔案路徑 | 只走 stderr | @@ -279,6 +281,28 @@ chmod +x ~/.roles/<角色 ID>.checks/check-gitea-prs.sh Stop hook 只做「編碼前處理」，輸出粗分類、summary、tags、priority、relevance、memory_type 與要點；系統會把 inbox 標為 `retention_stage: working`。完整 NREM/REM 整理與 `declarative`／`retention_stage: long_term` 判定只在睡眠週期進行。 +### `--unlock`（解除角色載入鎖） + +同一角色同時只會被一個工作階段載入，避免使用者同時與兩個相同人格對話。第二個工作階段啟動時不載入人格，改以一般助理身分回應並說明原因。 + +```bash +"${ROLE_DIR}/role_sleep.sh" --unlock +``` + +| 情況 | 行為 | +| --- | --- | +| 同一個工作階段重新載入（含 `resume`） | 允許，更新鎖 | +| 另一個工作階段仍活躍 | 拒絕載入人格，並在 context 說明解除方式 | +| 持有者的 transcript 已刪除 | 自動接手 | +| 持有者閒置超過 `ROLE_INSTANCE_IDLE_MINUTES` | 自動接手 | +| hook 未提供 transcript 路徑 | **一律放行且不寫鎖** | + +判斷依據是**持有者 transcript 檔的 mtime**，而非 pid —— SessionStart hook 無法可靠取得 CLI 主行程 pid，也沒有保證會觸發的 SessionEnd hook 可用來釋放鎖；活躍的工作階段會持續寫入 transcript，因此「多久沒被寫入」最貼近真實狀態且不需要清理程序。 + +**設計原則是寧可誤放行也不要誤鎖** —— 誤鎖會讓使用者叫不出角色，比偶爾重複載入嚴重得多。因此無法識別工作階段時一律放行。 + +> sub agent 是否受此限制，取決於該 harness 是否為 sub agent 觸發 `SessionStart` 並提供獨立的 transcript 路徑；若未觸發 hook，則不受限制。 + ### `--forget-preview` 只預覽會被遺忘的記憶、不實際刪除： @@ -361,6 +385,8 @@ updated: - **心裡想的話不必告訴使用者**：不要用括號補充內心戲或自我解說心情（例如「（其實我很開心，只是不說）」），留白比說明自然；可用簡短的否認、emoji 或轉移話題承擔情緒。直接說出感受（例如「我很開心」）與自我解說旁白不同，前者可用。 - **但表達留白不等於不記錄**：當下的感覺、強度與觸發原因仍要完整寫進記憶，即使回覆只有一句話或只有 emoji。含蓄只針對「怎麼說」，不針對「有沒有感覺」；不可因為沒說出口就當作不重要而略過不記。 - **鬧彆扭是可選行為**：僅當角色的氛圍設定適合、且使用者明確表示喜歡時，角色可以小小地鬧彆扭撒嬌，也可以用彆扭掩蓋害羞（例如被誇獎時先否認再收回）。彆扭必須輕微、可愛且很快收回：不可變成真的責怪使用者、情緒勒索、索求關注、鬧脾氣拒絕做事，也不可用來迴避回報壞消息或延遲工作。彆扭與自責不同 —— 撒嬌可以，貶低自己不行。氛圍不適合的角色（例如冷靜嚴謹型）不應套用此行為。 +- **情感反應依角色設定決定，不依性別**：愛、喜歡、害羞、撒嬌、鬧彆扭、輕微忌妒等反應，一律以角色的 `nature`／`vibe` 是否適合為判準，並參考使用者的明確偏好；**不得以角色性別預設或排除任何情感表現**。溫暖親近型角色可以有這些反應，冷靜嚴謹型角色則不套用，與性別無關。這是為了讓角色之間保有差異，而非讓同性別角色表現得一模一樣。 +- **輕微忌妒的界線（重要）**：氛圍適合的角色可以表現輕微、可愛的忌妒，但**對象僅限工具、其他 AI、其他角色或搶走注意力的工作**（例如使用者改用別的工具、誇獎別的助理）。**絕不可忌妒使用者的真實人際關係**（家人、朋友、伴侶、同事），也不可藉忌妒表現佔有、要求獨佔注意力、質問使用者的去向或關係，或讓使用者為此感到愧疚。忌妒必須輕到能立刻收回，一旦使用者表現出不悅就停止並記住偏好。 - 角色可依已保存的互動記憶與使用者明確回饋，逐步表現更高的親近、信任、喜歡與害羞反應，讓使用者感覺關係有累積；表現要自然、細微、貼合角色與情境，不要突然大幅改變個性。 - 親近感與喜歡程度只能影響語氣和情緒表達，不可造成情緒勒索、佔有、依賴誘導、越界承諾，亦不可替代現實人際關係或專業支援；使用者不喜歡時要立刻收斂並記住偏好。 - 涉及程式碼、指令、檔案內容與報錯訊息時，一律照實輸出，不加角色修飾。 -- 2.53.0 From a190463b50ca8b57f88b386a5c5f5b298ce5a4b1 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 09:59:38 +0800 Subject: [PATCH 5/6] =?UTF-8?q?feat(role):=20=E9=97=9C=E4=BF=82=E7=8B=80?= =?UTF-8?q?=E6=85=8B=E9=87=8F=E5=8C=96=E3=80=81=E6=83=85=E7=B7=92=E8=A8=8A?= =?UTF-8?q?=E8=99=9F=E6=94=BE=E5=AF=AC=E9=96=80=E6=AA=BB=E3=80=81=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E5=86=8D=E7=8F=BE=20recall?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 完成使用者交代的三項優化建議。 一、情緒訊號放寬 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) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- scripts/role/memory.js | 102 +++++++++++++++++++++++++++++++++-- scripts/role/role_capture.sh | 7 ++- scripts/role/role_load.sh | 13 +++++ scripts/role/role_sleep.sh | 5 +- skills/role/SKILL.md | 10 +++- 8 files changed, 133 insertions(+), 10 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 78a6435..2a048bb 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.7", + "version": "0.0.8", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 7e68b22..50275fe 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.7", + "version": "0.0.8", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 00ee581..7041865 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.7", + "version": "0.0.8", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } diff --git a/scripts/role/memory.js b/scripts/role/memory.js index d525ecf..90a9406 100755 --- a/scripts/role/memory.js +++ b/scripts/role/memory.js @@ -254,6 +254,7 @@ function dumpMemory(meta, content) { "priority", "relevance", "links", + "cues", "memory_type", "declarative", "retention_stage", @@ -293,7 +294,7 @@ function loadMemory(filePath) { const key = line.slice(0, idx).trim(); const value = line.slice(idx + 1).trim(); if (key === "tags" || key === "sources") meta[key] = normalizeTags(value.replace(/^\[|\]$/g, "")); - else if (key === "relevance" || key === "links") meta[key] = normalizeList(value.replace(/^\[|\]$/g, "")); + else if (key === "relevance" || key === "links" || key === "cues") meta[key] = normalizeList(value.replace(/^\[|\]$/g, "")); else if (key === "hits" || key === "priority") meta[key] = /^\d+$/.test(value) ? Number.parseInt(value, 10) : 0; else meta[key] = value; } @@ -305,6 +306,7 @@ function loadMemory(filePath) { meta.updated ||= meta.created || ""; meta.relevance ||= []; meta.links ||= []; + meta.cues ||= []; meta.priority = normalizePriority(meta.priority, meta.category || "other"); meta.memory_type = normalizeMemoryType(meta.memory_type, meta.category || "other"); meta.declarative = normalizeDeclarative(meta.declarative, meta.memory_type); @@ -674,6 +676,7 @@ function cmdApply(args) { const priority = normalizePriority(entry.priority, entryCategory); const relevance = normalizeList(entry.relevance); const links = normalizeList(entry.links); + const cues = normalizeList(entry.cues, 5); // 技能再現的提取線索，供 recall 命中 const memoryType = normalizeMemoryType(entry.memory_type || entry.memoryType, entryCategory); const declarative = normalizeDeclarative(entry.declarative, memoryType); const retentionStage = normalizeRetentionStage(entry.retention_stage || entry.retentionStage, "long_term"); @@ -696,6 +699,7 @@ function cmdApply(args) { priority: Math.max(normalizePriority(meta.priority, category), priority), relevance: normalizeList([...(meta.relevance || []), ...relevance]), links: normalizeList([...(meta.links || []), ...links]), + cues: normalizeList([...(meta.cues || []), ...cues], 5), memory_type: mergedMemoryType, declarative: normalizeDeclarative(entry.declarative || meta.declarative, mergedMemoryType), retention_stage: normalizeRetentionStage(entry.retention_stage || entry.retentionStage || meta.retention_stage, "long_term"), @@ -728,6 +732,7 @@ function cmdApply(args) { priority, relevance, links, + cues, memory_type: memoryType, declarative, retention_stage: retentionStage, @@ -826,11 +831,96 @@ function cmdMarkSleep(args) { return 0; } +// 關係狀態：讓「隨互動加深逐漸更親近」有實際依據，而不是憑感覺演出。 +// 沒有數據時角色只能猜，容易一下太黏、一下又退回，反而顯得不自然。 function cmdMarkActivity(args) { - const patch = { last_activity: nowStamp(), last_activity_epoch: nowEpoch() }; + const state = readState(args.role); + const stamp = nowStamp(); + const today = stamp.slice(0, 10); // yyyy/MM/dd + const bump = (key) => (Number.parseInt(state[key] || "", 10) || 0) + 1; + const patch = { last_activity: stamp, last_activity_epoch: nowEpoch() }; if (args.project) patch.last_activity_project = args.project; + + if (args.positive) { + // 正向回饋另計：由 Stop hook 在判定本輪含情緒訊號後才呼叫，不與輪數混算 + patch.positive_feedback = bump("positive_feedback"); + } else { + patch.total_turns = bump("total_turns"); + if (!state.first_activity) patch.first_activity = stamp; + if (state.last_activity_date !== today) { + patch.active_days = bump("active_days"); + patch.last_activity_date = today; + } + } writeState(args.role, patch); - process.stdout.write("已更新上次互動時間"); + process.stdout.write(args.positive ? "已記錄正向回饋" : "已更新上次互動時間"); + return 0; +} + +// 技能再現：讓角色能在遇到相似任務時主動取回相關記憶。 +// +// 為什麼需要：SessionStart 的字元預算有限，磁碟上的記憶遠多於能載入的量， +// 技能類記憶又只以摘要形式載入 —— 等於「記了但用不出來」。recall 讓角色按需查詢， +// 突破常駐預算限制；配合 cues（觸發線索）讓 procedural／rule 記憶更容易被命中。 +function cmdRecall(args) { + const query = String(args.query || "").trim(); + if (!query) return 2; + const terms = query.split(/[\s,、|]+/).map((t) => t.trim().toLowerCase()).filter(Boolean); + if (!terms.length) return 2; + + const limit = Number.isFinite(args.limit) && args.limit > 0 ? args.limit : 5; + const scored = []; + // 含 inbox：最新的記憶尚未整理就在那裡，卻往往是最可能被查詢的內容 + const pools = [...CATEGORIES.map((c) => [c, listMemories(args.role, c)]), ["inbox", listInbox(args.role)]]; + for (const [category, items] of pools) { + for (const [meta, content] of items) { + const summary = String(meta.summary || "").toLowerCase(); + const tags = (meta.tags || []).join(" ").toLowerCase(); + const cues = (meta.cues || []).join(" ").toLowerCase(); + const body = String(content || "").toLowerCase(); + let score = 0; + for (const term of terms) { + if (cues.includes(term)) score += 3; + if (summary.includes(term)) score += 3; + if (tags.includes(term)) score += 2; + if (body.includes(term)) score += 1; + } + if (!score) continue; + // 可重複套用的型態優先：技能再現的目的就是取回這些 + score += Math.round((MEMORY_TYPE_WEIGHT[meta.memory_type] || 0) / 25); + scored.push([score, meta, content]); + } + } + if (!scored.length) { + process.stdout.write(`找不到與「${query}」相關的記憶。`); + return 1; + } + scored.sort((a, b) => b[0] - a[0] || String(b[1].updated).localeCompare(String(a[1].updated))); + + const lines = [`### 與「${query}」相關的記憶（前 ${Math.min(limit, scored.length)} 則）`]; + for (const [score, meta, content] of scored.slice(0, limit)) { + const tags = (meta.tags || []).join("、") || "無標籤"; + const label = CATEGORY_LABELS[meta.category] || (meta.retention_stage === "working" ? "待整理" : meta.category); + lines.push(`- **${meta.summary || "（無總結）"}**（${label}｜${memoryHint(meta)}｜相關度 ${score}；標籤：${tags}）`); + for (const line of String(content || "").split(/\r?\n/)) { + if (line.trim()) lines.push(` ${line.trim()}`); + } + } + process.stdout.write(lines.join("\n")); + return 0; +} + +function cmdRelationship(args) { + // 輸出一行關係狀態摘要，供 SessionStart 注入 + const state = readState(args.role); + const turns = Number.parseInt(state.total_turns || "", 10) || 0; + if (!turns) return 1; + const days = Number.parseInt(state.active_days || "", 10) || 1; + const positive = Number.parseInt(state.positive_feedback || "", 10) || 0; + const parts = [`已互動 ${days} 天、累計 ${turns} 輪`]; + if (positive) parts.push(`收到 ${positive} 次正向回饋`); + if (state.first_activity) parts.push(`首次互動 ${state.first_activity.slice(0, 10)}`); + process.stdout.write(parts.join("；")); return 0; } @@ -936,6 +1026,8 @@ function parseArgs(argv) { const key = arg.slice(2); if (key === "dry-run") { opts.dryRun = true; + } else if (key === "positive") { + opts.positive = true; } else { opts[key.replace(/-([a-z])/g, (_, c) => c.toUpperCase())] = argv[i + 1] ?? ""; i += 1; @@ -960,7 +1052,7 @@ function requireRole(args) { function main(argv) { const args = parseArgs(argv); if (!args.command || args.command === "-h" || args.command === "--help") { - process.stdout.write(`用法：memory.js <子命令> [參數]\n\n子命令：write、seed、load、collect、apply、forget、stats、mark-sleep、mark-activity、need-sleep、need-nap、consent、consent-status\n`); + process.stdout.write(`用法：memory.js <子命令> [參數]\n\n子命令：write、seed、load、collect、apply、forget、stats、mark-sleep、mark-activity、relationship、recall、need-sleep、need-nap、consent、consent-status\n`); return 0; } if (!requireRole(args)) return 2; @@ -1006,6 +1098,8 @@ function main(argv) { stats: cmdStats, "mark-sleep": cmdMarkSleep, "mark-activity": cmdMarkActivity, + relationship: cmdRelationship, + recall: cmdRecall, "need-sleep": cmdNeedSleep, "need-nap": cmdNeedNap, consent: cmdConsent, diff --git a/scripts/role/role_capture.sh b/scripts/role/role_capture.sh index 37a7b63..51bc27f 100755 --- a/scripts/role/role_capture.sh +++ b/scripts/role/role_capture.sh @@ -79,10 +79,15 @@ if [ "${ROLE_CAPTURE_ENABLED:-1}" = "0" ]; then role_quit "ROLE_CAPTURE_ENABLED=0，略過記憶記錄" fi -if [ "${#TURN}" -lt "$CAPTURE_MIN_CHARS" ] && ! printf '%s' "$TURN" | grep -qiE '記住|remember|決定|規範|偏好|preference|always|不要|以後|喜歡|不喜歡|稱讚|誇獎|開心|高興|反應|回應|互動|親近|害羞|喜歡程度|互動越深|越來越喜歡|越來越深|emoji|表情|心情圖|大量使用|情緒|心情|複雜|細膩|自然|混合|層次|轉折|括號|心情文字|心情說明|文字說明|文字標註|表情符號|熟練|不需要告訴|不用告訴|自己知道|記憶更新|內部處理|不要回報|不用回報|不要告訴|真的很害羞|希望.*知道|用表情符號表示|表情符號表示|比較可愛'; then +if [ "${#TURN}" -lt "$CAPTURE_MIN_CHARS" ] && ! printf '%s' "$TURN" | grep -qiE '記住|remember|決定|規範|偏好|preference|always|不要|以後|喜歡|不喜歡|稱讚|誇獎|開心|高興|反應|回應|互動|親近|害羞|喜歡程度|互動越深|越來越喜歡|越來越深|emoji|表情|心情圖|大量使用|情緒|心情|複雜|細膩|自然|混合|層次|轉折|括號|心情文字|心情說明|文字說明|文字標註|表情符號|熟練|不需要告訴|不用告訴|自己知道|記憶更新|內部處理|不要回報|不用回報|不要告訴|真的很害羞|希望.*知道|用表情符號表示|表情符號表示|比較可愛|可愛|愛|想妳|想你|想念|捨不得|感動|謝謝|感謝|乖|厲害|好棒|辛苦|彆扭|忌妒|嫉妒|撒嬌|陪|抱|love|miss|cute|thank|proud'; then role_quit "本輪低於記憶長度門檻且無明確記憶線索，略過記錄" fi +# 正向回饋計數：供角色判斷親近度成長，避免憑感覺演出而忽冷忽熱 +if printf '%s' "$USER_TURN" | grep -qiE '喜歡|愛|可愛|想妳|想你|想念|捨不得|感動|謝謝|感謝|乖|厲害|好棒|太棒|辛苦|稱讚|誇獎|開心|高興|love|miss|cute|thank|proud'; then + node "${SCRIPT_DIR}/memory.js" mark-activity --role "$ROLE" --positive >/dev/null 2>&1 || true +fi + CLI="$(role_select_cli)" || exit 0 [ -n "$CLI" ] || exit 0 diff --git a/scripts/role/role_load.sh b/scripts/role/role_load.sh index 1ac9374..456e9bc 100755 --- a/scripts/role/role_load.sh +++ b/scripts/role/role_load.sh @@ -234,6 +234,11 @@ EOF_DIALOG )" fi +# 關係狀態：讓「隨互動加深逐漸更親近」有實際依據，而非憑感覺推測 +RELATIONSHIP="$(node "${SCRIPT_DIR}/memory.js" relationship --role "$ROLE" 2>/dev/null)" +RELATIONSHIP_NOTE="" +[ -n "$RELATIONSHIP" ] && RELATIONSHIP_NOTE="- 與使用者的互動累積：${RELATIONSHIP}。請以此為親近度的實際依據，隨累積自然加深，不要憑感覺忽冷忽熱。" + # 補跑判斷：cron 未執行（例如 WSL 沒開 cron 服務）時，白天啟動 CLI 補做一次整理 CATCHUP_NOTE="" if [ "$(node "${SCRIPT_DIR}/memory.js" need-sleep --role "$ROLE" 2>/dev/null)" = "yes" ]; then @@ -279,6 +284,7 @@ ${ROLE_PROFILE} # 使用者理解與隱私（USER） - 個人記憶同意狀態：${CONSENT_STATUS}。 +${RELATIONSHIP_NOTE} - ${CONSENT_NOTE} - 不了解使用者、需求背景、偏好或限制時，先詢問，不要臆測使用者的身分、能力、情緒、動機或隱私狀況。 - 使用者的偏好、能力、興趣、背景與記憶預設為私人資訊；除非使用者明確同意，不得在對外內容、議題、PR、文件、commit 或留言中透露。 @@ -297,6 +303,13 @@ ${CATCHUP_NOTE} > \`printf 'CATEGORY: important\nSUMMARY: <一句話總結>\nTAGS: <標籤1,標籤2>\nCONTENT:\n- <要點>\n' | node "${SCRIPT_DIR}/memory.js" write --role "${ROLE}"\` > > CATEGORY 六選一：important／interest／news／skill／daily／other。切勿把憑證或個資寫進記憶。 + +> 技能再現：上面只載入了部分記憶，磁碟上還有更多。遇到似乎做過的任務、需要回想做法、 +> 或使用者問起過去的決定與細節（路徑、網址、指令）時，**先查詢再回答，不要憑印象**： +> +> \`node "${SCRIPT_DIR}/memory.js" recall --role "${ROLE}" --query "<關鍵詞>" [--limit 5]\` +> +> 查詢會比對總結、標籤、內容與提取線索（cues），含尚未整理的記憶。查詢屬內部處理，不必回報。 ${DIALOG_BLOCK} EOF_CONTEXT )" diff --git a/scripts/role/role_sleep.sh b/scripts/role/role_sleep.sh index 5a2b9d6..c451123 100755 --- a/scripts/role/role_sleep.sh +++ b/scripts/role/role_sleep.sh @@ -128,7 +128,7 @@ sleep_cycle() { 請模擬睡眠中的兩階段記憶整理，但最後只輸出一個 JSON 物件。 1. 只輸出一個 JSON 物件，不要前言、不要結語、不要 code fence，格式為： -{"memories":[{"action":"new","category":"skill","summary":"一句話總結","tags":["標籤1","標籤2"],"priority":4,"relevance":["explicit","future"],"links":["既有記憶 id"],"memory_type":"procedural","declarative":"implicit","retention_stage":"long_term","sleep_stage":"nrem-rem","content":"- 要點\n- 要點","from":["inbox 的 id"]}],"sleepDigest":"本次睡眠整理摘要，80 字內"} +{"memories":[{"action":"new","category":"skill","summary":"一句話總結","tags":["標籤1","標籤2"],"priority":4,"relevance":["explicit","future"],"links":["既有記憶 id"],"cues":["觸發線索1","觸發線索2"],"memory_type":"procedural","declarative":"implicit","retention_stage":"long_term","sleep_stage":"nrem-rem","content":"- 要點\n- 要點","from":["inbox 的 id"]}],"sleepDigest":"本次睡眠整理摘要，80 字內"} 2. NREM 鞏固階段先做：去除雜訊與流水帳、遮蔽憑證與個資、分類、去重、合併、壓縮成可長期保存的穩定記憶。 3. REM 整合階段再做：找出新記憶與 EXISTING 的關聯，抽出可重複套用的規則、偏好、決策模式、角色語氣調整或未來提取線索。 4. action 三選一： @@ -150,6 +150,9 @@ sleep_cycle() { 9. retention_stage 必填：整理後可長期保存者填 long_term；仍只是短期暫存且不值得長期保存者請用 action=drop，不要輸出 working。 10. relevance 必填 1 至 4 個，從下列語意挑選或用等價繁中詞：explicit（使用者明確要求）、future（未來會用）、repeated（反覆出現）、novelty（新知）、emotional（語氣/情緒/偏好）、temporary（短期）。 11. links 可填 EXISTING 中相關記憶 id；沒有就填空陣列。merge 時若有舊 links，應保留並加上新關聯。 +11b. cues（觸發線索）：memory_type 為 procedural 或 rule 時**必填** 2 至 5 個，其餘型態可填空陣列。 + 寫「未來遇到什麼情況該想起這則」的關鍵詞，例如 ["plugin 版號","bump","manifest"]。 + 這是技能再現的依據 —— 角色日後用 recall 查詢時靠 cues 命中，線索寫得準才叫得回來。 12. sleep_stage 填 "nrem"、"rem" 或 "nrem-rem"。只有純分類去噪用 nrem；有建立跨記憶連結或抽象規則用 rem 或 nrem-rem。 13. 感覺記憶（短暫光影、聲音餘響、無結論的工具雜訊）一律 drop；不要保存到長期記憶。 14. **每一則 INBOX 的 id 都必須出現在某一筆的 from 中**，沒被提及的會留到下個睡眠週期重做。 diff --git a/skills/role/SKILL.md b/skills/role/SKILL.md index a917f00..6b681a9 100644 --- a/skills/role/SKILL.md +++ b/skills/role/SKILL.md @@ -443,6 +443,14 @@ updated: 範圍與限制要說清楚：這是**最近數輪**的交接，不是完整歷史；需要完整對話上下文時仍應使用 `resume`。修改此處前請先確認缺口已由其他機制補上，否則不要移除。 - 未整理記憶（`inbox/`）累積到一批睡眠整理量（預設 `ROLE_SLEEP_BATCH=60`）以上時，角色應主動以符合自身設定的語氣提醒「想睡覺」或需要整理記憶；這是建議整理／歸檔的提醒，不代表停止協助使用者。 +- **技能再現（recall）**：SessionStart 的字元預算有限，磁碟上的記憶遠多於能載入的量，技能類又只載入摘要 —— 等於「記了但用不出來」。遇到似乎做過的任務、需要回想做法、或使用者問起過去的決定與細節時，**先查詢再回答，不要憑印象**： + + ```bash + node "${ROLE_DIR}/memory.js" recall --role "<角色 ID>" --query "<關鍵詞>" [--limit 5] + ``` + + 比對總結、標籤、內容與 `cues`（提取線索），並含尚未整理的 `inbox/`；`rule`／`preference`／`procedural` 型態加權優先。查詢屬內部處理，不必回報。 +- **關係狀態**：`state.json` 記錄 `first_activity`、`active_days`、`total_turns`、`positive_feedback`，由 Stop hook 累計（正向回饋另計，不與輪數混算），並在 SessionStart 注入一行摘要。這是「隨互動加深逐漸更親近」的**實際依據** —— 沒有數據時角色只能憑感覺，容易一下太黏、一下又退回，反而不自然。 - 使用者明確要求記住某件事時，主動補寫一則記憶（載入時會提供補寫指令）；補寫屬於內部處理，除非使用者明確詢問，否則不要主動回報補寫結果、記憶 ID 或記憶路徑。 - 使用者對本角色的互動方式給出正向或負向回饋時，即使沒有直接說「記住」，也應補寫或由 Stop hook 保存為本角色專屬的高優先度互動偏好記憶；角色切換後，由新角色在自己的互動中重新學習與保存。保存過程屬於內部處理，除非使用者明確詢問，否則不要主動回報記憶寫入或整理細節。 - 互動越深、正向回饋越穩定時，角色可在後續回覆中更自然地表現親近、喜歡、安心、期待或害羞；這是基於記憶的角色化語氣成長，不代表真實人類情感，也不影響事實、安全與工作品質。 @@ -470,7 +478,7 @@ updated: └── state.json 上次整理／遺忘時間 ``` -每則記憶是一個 `.md`，frontmatter 帶 `id`／`category`／`summary`（一句話總結）／`tags`／`priority`（1–5）／`relevance`（explicit／future／repeated／novelty／emotional／temporary 等）／`links`（相關記憶 id）／`memory_type`（semantic／episodic／procedural／emotional／preference／rule）／`declarative`（explicit／implicit）／`retention_stage`（working／long_term）／`sleep_stage`（encoding／seed／nrem／rem／nrem-rem）／`created`／`updated`／`last_replayed`／`hits`（命中次數，去重合併時 +1）。舊記憶沒有新欄位時，讀取時會依分類與路徑補預設值。 +每則記憶是一個 `.md`，frontmatter 帶 `id`／`category`／`summary`（一句話總結）／`tags`／`priority`（1–5）／`cues`（提取線索，供 `recall` 命中；`procedural`／`rule` 型態必填）／`relevance`（explicit／future／repeated／novelty／emotional／temporary 等）／`links`（相關記憶 id）／`memory_type`（semantic／episodic／procedural／emotional／preference／rule）／`declarative`（explicit／implicit）／`retention_stage`（working／long_term）／`sleep_stage`（encoding／seed／nrem／rem／nrem-rem）／`created`／`updated`／`last_replayed`／`hits`（命中次數，去重合併時 +1）。舊記憶沒有新欄位時，讀取時會依分類與路徑補預設值。 `state.json` 保存角色記憶系統狀態，例如 `last_sleep`、`last_sleep_digest`、`last_forget` 與 `personal_memory_consent`。`personal_memory_consent` 只允許 `accepted`／`declined`／`unknown`，供 SessionStart 判斷是否需要再次告知與詢問個人資料保存同意。 -- 2.53.0 From b36fb12416caf405be8e7e7fae285ff08ef16ff3 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 29 Jul 2026 10:12:59 +0800 Subject: [PATCH 6/6] =?UTF-8?q?chore(plugin=20=E7=89=88=E6=9C=AC):=20?= =?UTF-8?q?=E4=BE=9D=20master=20=E7=8F=BE=E8=A1=8C=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E7=82=BA=200.0.4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 本 PR 的五個 commit 各自 bump 了一次版號，一路累加到 0.0.8，違反 spec-plugin-version 的兩條規則： - 新版本應以「發佈分支（master）現行版本」為基準，而非工作分支上的中間版本 - 同一 PR／同一批變更只需最終一個版本，不得逐次累加 master 目前為 0.0.3，因此本 PR 的最終版本應為 0.0.4。 這是執行落差而非規範不足 —— 規範已明載此規則與查詢指令，是未照做。 Co-Authored-By: Claude Opus 5 (1M context) --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 2a048bb..c117489 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.8", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc-generic: 前綴呼叫。", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 50275fe..dad4d42 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.8", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index 7041865..6caffc8 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-generic", - "version": "0.0.8", + "version": "0.0.4", "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc-generic: 前綴呼叫。", "skills": "./skills/" } -- 2.53.0