Files
persona/skills/persona-create/SKILL.md
T
jiantw83andClaude Opus 5 d067907225 feat: 建立人格並補齊資料後產生圖示(SVG + PNG,零外部依賴)
`icon generate|show`:由**編號、Name、Emoji** 雜湊出配色與圖案,產出
512×512 的幾何徽章 icon.svg + icon.png,設為 Gitea 存取庫頭像並同步到 Wiki 區。

圖案(SVG 與 PNG 共用同一組單位座標與同一份 5×7 點陣字,**輸出的是同一張圖**):
  * 雙色對角漸層底
  * 5×5 左右對稱點陣紋(identicon 式)
  * 中央兩個字母=編號前兩字(ASUNA-01 → AS),依背景亮度自動選黑/白

同一個人格永遠得到同一張圖(純函數,無隨機);ASUNA-01 與 ASUNA-02 明顯不同。

為什麼自己畫:這台機器(及多數伺服器)沒有 rsvg/inkscape/imagemagick,
沒有影像函式庫,也沒有 emoji 字型,而本專案禁止 npm 依賴。所以
scripts/persona-icon.mjs 自己柵格化(3× 超取樣 + 盒式縮減當反鋸齒),
再用內建 zlib 手工組出 IHDR/IDAT/IEND 與 CRC32。
emoji 無法柵格化,因此不作為圖形,但仍參與配色雜湊。

時機:**資料補齊之後才產生**——配色與字母綁在最終身分上,太早跑會對不上。
persona-create 第 7 步、persona-anime 第 8 步都補了這個步驟;改過身分用 --force 重畫。

selftest 128 項全綠(新增第 ⑭ 節:PNG chunk 合法性、決定性、不同人格不同圖、
圖示屬 Wiki 區、匯出用 base64 帶走二進位、guest 不得重畫)。

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

7.4 KiB
Raw Blame History

name, description
name description
persona-create 建立一個新的 AI 人格(persona),並以「與 OpenClaw 相同的五個身分描述欄位」(Name / Creature / Vibe / Emoji / Avatar)與 SOUL.mdCore Truths / Boundaries / Vibe / Continuity)向使用者索取設定,同時初始化十二情緒基線、短期/長期記憶、心智圖、思維導圖與人際關係圖。當使用者說要新建人格、造一個 AI 角色、設定新的聊天對象、或要求「用 OpenClaw 的格式描述人格」時觸發。不適用於:載入既有人格聊天(用 persona-chat)、修改既有人格(直接編輯該人格的 IDENTITY.md/SOUL.md)、或列出人格與鎖狀態(用 persona-status)。

🌱 persona-create — 建立人格

OpenClaw 相同的身分描述建立一個可長期演化的人格,並備妥記憶與情緒骨架。

要建的是動漫/漫畫/遊戲的既有角色?改用 /jsc-persona:persona-anime——它會先上網蒐集該角色的公開設定,再自動填這些欄位並固化成基礎記憶。本 skill 用於原創人格。

CLInode "${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 的三個關鍵(其餘用模板預設值):

  1. 意見與語氣:這個人格對事情的態度?直白到什麼程度?會不會吐槽?
  2. 界線:什麼事情絕對不做/不談?
  3. 情緒傾向:什麼會點亮他、什麼會刺到他、壓力下會變成什麼樣子?

使用者若說「你決定」,就自己提一版完整設定並在建立後摘要給他確認。

3. 決定 slug 並建立

slug = 小寫英數與連字號(例:lumishen-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 決定人格編號(英文名全大寫+兩位索引,例如 AsunaASUNA-01)。 編號同時是本機目錄名與 Gitea 存取庫的名稱,所以:中文/日文名字要先提議羅馬拼音、 拿給使用者確認拼法再送出(亞絲娜 → Asuna沈宇 → Shen Yu)。想先看號碼會長怎樣: code next --romaji "<英文名>" --session <PERSONA_SESSION>

設好 GITEA_HOSTGITEA_TOKEN 時,create 會順手在 Gitea 開一個私有存取庫 (名稱=編號)並推第一版;沒設定或加 --no-gitea 就只在本機建立。細節見 /jsc-persona:persona-sync

create 會:建立 IDENTITY.mdSOUL.mdAGENTS.mdUSER.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. 產生人格圖示(資料補齊之後才做)

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSONA_SESSION>

產出 icon.svgicon.png512×512),並自動設成 Gitea 存取庫的頭像、同步到 Wiki 區。

  • 一定要等身分補齊再跑:配色與字母是由編號、Name、Emoji 一起雜湊出來的, 資料還沒填完就產生,之後改名字圖就對不上了。
  • 同一個人格永遠得到同一張圖(純函數,不隨機)。
  • 之後改了 IDENTITY.md 想重畫 → icon generate --session <PERSONA_SESSION> --force
  • 圖是幾何徽章:雙色漸層 + 專屬點陣紋 + 編號前兩個字母(ASUNA-01AS)。 沒有把 emoji 畫進去是因為 PNG 需要字型柵格化,而本 plugin 不用任何外部依賴; emoji 仍然參與配色的雜湊。

8. 回報

用該人格的 emoji 與語氣,摘要:編號、五個身分欄位、情緒基線前三高、倉庫路徑與圖示, 並提示:/jsc-persona:persona-chat <slug> 開始對話、/jsc-persona:persona-invite 邀別的人格加入。


注意

  • 一個程序只能載入一個人格。 建立即載入;若本 session 已有人格,先 release
  • 人格倉庫預設在 ~/.claude/personas/<slug>/,可用環境變數 PERSONA_HOME 改。
  • 所有輸出使用繁體中文(台灣用語)、UTF-8 無亂碼。