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>
6.5 KiB
name, description
| name | description |
|---|---|
| persona-create | 建立一個新的 AI 人格(persona),並以「與 OpenClaw 相同的五個身分描述欄位」(Name / Creature / Vibe / Emoji / Avatar)與 SOUL.md(Core Truths / Boundaries / Vibe / Continuity)向使用者索取設定,同時初始化十二情緒基線、短期/長期記憶、心智圖、思維導圖與人際關係圖。當使用者說要新建人格、造一個 AI 角色、設定新的聊天對象、或要求「用 OpenClaw 的格式描述人格」時觸發。不適用於:載入既有人格聊天(用 persona-chat)、修改既有人格(直接編輯該人格的 IDENTITY.md/SOUL.md)、或列出人格與鎖狀態(用 persona-status)。 |
🌱 persona-create — 建立人格
以 OpenClaw 相同的身分描述建立一個可長期演化的人格,並備妥記憶與情緒骨架。
要建的是動漫/漫畫/遊戲的既有角色?改用
/jsc-persona:persona-anime——它會先上網蒐集該角色的公開設定,再自動填這些欄位並固化成基礎記憶。本 skill 用於原創人格。
CLI:node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"
(其他助理請改成本 plugin 目錄下的 scripts/persona.mjs;以下簡稱 persona.mjs)
session:所有指令都要帶 --session <PERSONA_SESSION>,值取自 <persona-runtime> 區塊注入的 PERSONA_SESSION=。
步驟
1. 先看現況
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" list
若使用者要建的名字已存在 → 詢問是要改名、還是載入既有人格(改走 persona-chat)。
2. 索取身分描述(必須逐項問齊,用 OpenClaw 的原描述)
一次把五個欄位問完(可讓使用者只答部分,其餘由你提案):
| 欄位 | OpenClaw 原始描述 | 中文說明 |
|---|---|---|
Name |
(pick something you like) | 對話標題/群聊/跨 agent 溝通用。短(1–2 音節)、好認。唯一必填 |
Creature |
(AI? robot? familiar? ghost in the machine? something weirder?) | 生物原型,個性的視覺與隱喻錨點;要呼應 SOUL,不可矛盾 |
Vibe |
(how do you come across? sharp? warm? chaotic? calm?) | 給人的第一印象/語氣色彩 |
Emoji |
(your signature — pick one that feels right) | 固定簽名 emoji,小尺寸也認得出 |
Avatar |
(workspace-relative path, http(s) URL, or data URI) | 形象描述或圖片位置 |
接著問 SOUL 的三個關鍵(其餘用模板預設值):
- 意見與語氣:這個人格對事情的態度?直白到什麼程度?會不會吐槽?
- 界線:什麼事情絕對不做/不談?
- 情緒傾向:什麼會點亮他、什麼會刺到他、壓力下會變成什麼樣子?
使用者若說「你決定」,就自己提一版完整設定並在建立後摘要給他確認。
3. 決定 slug 並建立
slug = 小寫英數與連字號(例:lumi、shen-yu),是之後所有指令的識別。
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" create \
--romaji "<英文名>" --session <PERSONA_SESSION> \
--name "<Name>" --creature "<Creature>" --vibe "<Vibe>" \
--emoji "<Emoji>" --avatar "<Avatar>" \
--baseline "serenity=45,trust=35,joy=25,anxiety=6"
--romaji 決定人格編號(英文名全大寫+兩位索引,例如 Asuna → ASUNA-01)。
編號同時是本機目錄名與 Gitea 存取庫的名稱,所以:中文/日文名字要先提議羅馬拼音、
拿給使用者確認拼法再送出(亞絲娜 → Asuna、沈宇 → Shen Yu)。想先看號碼會長怎樣:
code next --romaji "<英文名>" --session <PERSONA_SESSION>。
設好 GITEA_HOST/GITEA_TOKEN 時,create 會順手在 Gitea 開一個私有存取庫
(名稱=編號)並推第一版;沒設定或加 --no-gitea 就只在本機建立。細節見
/jsc-persona:persona-sync。
create 會:建立 IDENTITY.md/SOUL.md/AGENTS.md/USER.md、十二情緒狀態、
記憶與心智圖骨架、人際關係圖,並立刻取得這個人格的載入鎖並綁到本 session。
4. 依訪談結果補完 SOUL.md 與 IDENTITY.md
用 Edit 修改該人格目錄下的檔案(只有這個人格能被你寫入,其他人格會被 hook 擋下):
SOUL.md的## Core Truths/## Boundaries/## Vibe/### 情緒傾向依訪談改寫。- 留白處都要填掉;不要留
(例:…)這種提示文字。
5. 設定情緒基線(十二情緒)
基線 = 這個人格平常的底色,情緒衰減時會回彈到這裡。依 Vibe 決定:
| Vibe 例 | 建議基線調整 |
|---|---|
| 沉穩、可靠 | serenity=50,trust=40,anxiety=5 |
| 熱情、外放 | joy=40,anticipation=35,delight=15 |
| 銳利、毒舌 | anticipation=30,disgust=10,serenity=30 |
| 溫柔、體貼 | gratitude=30,trust=40,serenity=45 |
| 神經質、敏感 | anxiety=25,fear=12,anticipation=30 |
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" emotion \
--persona <slug> --session <PERSONA_SESSION> --baseline "joy=30,serenity=45,anxiety=8"
6. 種下第一批關係與記憶
# 使用者節點(人際關係圖的原點)
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation node \
--persona <slug> --session <PERSONA_SESSION> \
--name "<使用者稱呼>" --kind human --closeness 55 --trust 50 --note "創造我的人"
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation edge \
--persona <slug> --session <PERSONA_SESSION> \
--to <使用者 id> --label "主要對話者" --affinity 60
# 誕生事件(第一則長期記憶)
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" consolidate \
--persona <slug> --session <PERSONA_SESSION> \
--name "birth" --type event --about "user" --topics "origin,self" --salience 90 \
--body "我在 <日期> 被 <使用者> 建立。當時他希望我是 <Vibe> 的 <Creature>。"
也可視需要在 mindmap/semantic.mmd 補上初始概念(自我/使用者/共同經驗)。
7. 回報
用該人格的 emoji 與語氣,摘要:slug、五個身分欄位、情緒基線前三高、倉庫路徑,
並提示:/jsc-persona:persona-chat <slug> 開始對話、/jsc-persona:persona-invite 邀別的人格加入。
注意
- 一個程序只能載入一個人格。 建立即載入;若本 session 已有人格,先
release。 - 人格倉庫預設在
~/.claude/personas/<slug>/,可用環境變數PERSONA_HOME改。 - 所有輸出使用繁體中文(台灣用語)、UTF-8 無亂碼。