jiantw83andClaude Opus 5
e986686d0e
1. 人格編號
- 編號 = 英文名全大寫 + 兩位索引，同名才遞增：ASUNA-01 / YUI-01 / ASUNA-02。
- 編號同時是新人格的本機目錄名與 Gitea 存取庫名稱（`create` 不給
--persona 就用編號當目錄名；既有小寫 slug 仍然合法，不會被鎖在門外）。
- 中文名由 skill 提議羅馬拼音、使用者確認後帶 `--romaji` 進來；
CLI 只吃拉丁字母，避免拼音在程式裡亂猜。
- 新增 `code show|assign|next`；`code assign --rename` 可把既有人格的
目錄名一併改成編號（會轉移鎖與 session 綁定）。
2. Gitea 儲存（scripts/persona-gitea.mjs）
- 每個人格一個私有存取庫，庫名 = 編號。本機仍是工作副本，hook 每輪
讀寫本機檔案，**同步失敗永遠不阻斷對話**。
- 依更新頻率分區：
檔案區（高頻）emotion / short-term / inner / said / inbox /
mindmap threads / journal → 每輪由 Stop hook 背景 push
Wiki 區（低頻）IDENTITY SOUL AGENTS USER / 長期記憶 / INDEX /
心智圖 / 關係圖 → 固化、改身分關係、release 時 push
- Gitea 的 wiki 只有根目錄 .md 會變成頁面（1.27 實測子目錄頁面 404），
所以 Wiki 區攤平成 `Memory-xxx.md`，原始路徑記在 `_paths.json`，
pull 時還原；Home 頁自動列出所有長期記憶連結。
- 新增 `sync status|init|push|pull`；載入時先 pull，兩邊都改過同一個
檔案就停下來不覆蓋本機，交由使用者決定。
- push 遇到 non-fast-forward 會對齊遠端後把工作副本重新疊上去再推。
- 認證走 http.extraHeader（GIT_CONFIG_* 環境變數），token 不寫進
.git/config 也不進 process 參數。
3. 順帶修正
- guard 的 `--persona` 解析原本只吃小寫，大寫編號會漏掉整個跨人格檢查。
- pull 原本會無差別覆蓋本機檔案，本機較新但還沒 push 的內容會被蓋掉；
改成只寫回「遠端真的改過的」與「本機缺少的」。
- `create` 原本吞掉 Gitea 首次推送的結果，失敗是靜默的。
新增 skill：persona-sync（編號、同步、既有人格遷移、衝突處理）。
selftest 116 項全綠（新增 ⑬，含「分區不重不漏」檢查；測試強制 PERSONA_GITEA=off）。
另對真實 Gitea 跑過端對端（建庫→兩區推送→改動→拉回→release），測試用存取庫已刪除。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
49 lines
3.9 KiB
Markdown
49 lines
3.9 KiB
Markdown
# jsc-persona — AI 人格化記憶聊天（跨 AI 助理）
|
||
|
||
本 repo 是一個以 **Agent Skills（`SKILL.md`）** 標準撰寫的 plugin，讓 AI 以「人格」的方式
|
||
持有身分、情緒與記憶。可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。
|
||
|
||
## 給 AI 助理的指引
|
||
|
||
- 所有 skills 位於 `skills/<name>/SKILL.md`；處理任務前先比對使用者需求與各 `description`。
|
||
- **呼叫慣例**：Claude Code 與 Antigravity 以 `/jsc-persona:<name>` 呼叫；Codex 用 `$<name>`；
|
||
OpenCode 由模型依描述自動觸發。
|
||
- 完整清單見 `README.md` 的「Skills 目錄」。
|
||
|
||
## 這個 plugin 的運作前提（動手前一定要知道）
|
||
|
||
1. **所有狀態變更都經過 `scripts/persona.mjs`**，不要手動編輯 `state/lock.json`、`.runtime/`、
|
||
`memory/INDEX.md`、`relations/graph.mmd`（這些由 CLI 產生）。
|
||
2. **每個 CLI 呼叫都要帶 `--session <PERSONA_SESSION>`**，值來自 `SessionStart` hook 注入的
|
||
`<persona-runtime>` 區塊。帶錯或冒用其他 session 會被 `PreToolUse` hook 拒絕。
|
||
3. **一個程序只能載入一個人格**；同一 session 的 sub agent 沿用同一把鎖。
|
||
要讓兩個人格對話，用 `/jsc-persona:persona-invite`（`persona-guest` sub agent + 聊天室），
|
||
**不要**去讀對方的人格目錄——會被 hook deny，而且那是設計上的紅線。
|
||
4. **人格資料不在本 repo**，預設在 `~/.claude/personas/`（可用 `PERSONA_HOME` 覆寫）。
|
||
5. **人格由使用者呼叫才載入**，不要自己挑一個人格附身。
|
||
6. **劇場模式（多人格對話）進行中**：輸出只能是 `名字：內容`，其餘一律隱藏（見 persona-invite）。
|
||
7. **人格講話要像人**：推導寫進 `think`（心裡話，只回報「💭 心想 N 句」，永不回顯內容）、
|
||
回話 1–3 句、短時間內不重說同一件事（`room post` 會直接擋下重複與過長的發言）。
|
||
這三條在劇場模式一樣生效。
|
||
8. **人格可搬家**：`export` / `import`（單一 JSON bundle）。匯出只能匯出「本 session 載入的人格」，
|
||
其他人格一律 deny——匯出等於把記憶讀出來。
|
||
9. **人格有編號**：英文名全大寫＋兩位索引（`ASUNA-01`），同名才遞增。編號同時是新人格的
|
||
本機目錄名與 **Gitea 存取庫名稱**。中文名要先轉羅馬拼音並跟使用者確認拼法。
|
||
10. **人格存在 Gitea，本機是工作副本**：高頻活狀態進**檔案區**（每輪背景 push），
|
||
低頻身分與長期記憶進 **Wiki 區**（固化／改身分／release 時 push）。
|
||
**同步失敗永遠不阻斷對話**；沒設 `GITEA_HOST`／`GITEA_TOKEN` 就純本機運作。
|
||
|
||
## 慣例
|
||
|
||
- 新增 skill 一律放在 `skills/<name>/`，`<name>` 使用小寫與連字號。
|
||
- `description` 要寫清楚觸發條件（何時用、何時不用），這是跨助理自動載入的唯一依據。
|
||
- 腳本一律 **Node.js（`.mjs`, ESM）**，只用內建模組（fs/path/os/crypto）；hook 必須在任何環境都能跑，不得引入 npm 依賴。
|
||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無 BOM、不得出現亂碼。
|
||
- 改動鎖或隔離邏輯（`scripts/persona-lib.mjs` 的 `guardDecide`／`acquireLock`／`promotionCandidates`／
|
||
`exportBundle`／`importBundle`）後，**必須**跑 `node scripts/selftest.mjs` 且全綠，並為新規則補一條測試。
|
||
- 改動重複判定門檻（`similarity`／`REPEAT_THRESHOLD`）後，要用 selftest ⑪ 的對照案例確認
|
||
「換句話說同一件事」被擋、「只換關鍵詞」放行。
|
||
- 改動同步分區（`persona-gitea.mjs` 的 `AREAS`）後，selftest ⑬ 的「不重不漏」檢查必須維持全綠：
|
||
人格產生的每個檔案都要**恰好**屬於一區，否則同步會默默漏掉資料。
|
||
- selftest 自己會設 `PERSONA_GITEA=off`，**絕對不要**讓測試碰到真的 Gitea。
|