plugins/persona
2
0
Fork 0
Code Pull Requests Activity
Files
52a73e81c84bd34d0726169d405cd220fbed5d23
persona/AGENTS.md
T
jiantw83andClaude Opus 5 52a73e81c8 feat: 心裡話與不重複發言、劇場模式同規則、人格匯出匯入 
讓人格講話更像正常人，並讓人格可以搬家。

1. 心裡話（inner voice）
   - 新增 `think` 子指令：推導/盤算寫進 state/inner.jsonl，
     只印「💭 心想 N 句」，內容永不回顯給使用者。
   - <persona-context> 每輪帶回最近三句，推論因此有連續性。

2. 短時間內不重複
   - 說出口的話由 Stop hook 自動記進 state/said.jsonl。
   - 新增 `said check|list`：事前確認這句是不是又要說一次。
   - 相似度 = 字元 bigram Jaccard(0.4) + 字集合 Jaccard(0.6)，
     門檻 0.72；字集合權重較高才分得開「重排語序」（要擋）
     與「換掉關鍵詞」（是新資訊，放行）。

3. 回話一到三句 + 劇場模式同樣適用
   - 規則注入 turnContext 與 UserPromptSubmit hint。
   - 劇場模式的 CLI 都帶 --quiet，警告會被丟掉，所以 `room post`
     對近似重複與超過三句的發言直接拒收（--allow-repeat / --force 例外），
     host 與 guest 走同一支 CLI，一視同仁。

4. 人格匯出匯入（新 skill persona-transfer）
   - `export` / `import`：單一 JSON bundle（可 gzip）＋ sha256 checksum，
     無外部依賴。不帶載入鎖與 guest 租約，journal/ 需明確 --with-journal。
   - 匯出只能匯出本 session 已載入的人格，否則等於跨人格讀取的後門；
     bundle 內的 ../ 逃逸路徑一律拒收。

順帶修正：agents/persona-guest.md 的 CLI 範例都少了 --as-guest，
照著跑會被 requireMember 擋下，guest 根本無法認識自己或發言。

selftest 102 項全綠（新增 ⑪ 說話節制、⑫ 匯出匯入，含重複判定校準對照表）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-30 00:59:16 +00:00

3.0 KiB
Raw Blame History

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——匯出等於把記憶讀出來。

慣例

  • 新增 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 ⑪ 的對照案例確認 「換句話說同一件事」被擋、「只換關鍵詞」放行。
View Git Blame Copy Permalink