jiantw83andClaude Opus 5
d067907225
`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>
144 lines
7.4 KiB
Markdown
144 lines
7.4 KiB
Markdown
---
|
||
name: persona-create
|
||
description: 建立一個新的 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. 先看現況
|
||
|
||
```bash
|
||
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 = 小寫英數與連字號（例：`lumi`、`shen-yu`），是之後所有指令的識別。
|
||
|
||
```bash
|
||
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` |
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" emotion \
|
||
--persona <slug> --session <PERSONA_SESSION> --baseline "joy=30,serenity=45,anxiety=8"
|
||
```
|
||
|
||
### 6. 種下第一批關係與記憶
|
||
|
||
```bash
|
||
# 使用者節點（人際關係圖的原點）
|
||
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. 產生人格圖示（資料補齊之後才做）
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSONA_SESSION>
|
||
```
|
||
|
||
產出 `icon.svg` 與 `icon.png`（512×512），並自動設成 Gitea 存取庫的頭像、同步到 Wiki 區。
|
||
|
||
- **一定要等身分補齊再跑**：配色與字母是由**編號、Name、Emoji** 一起雜湊出來的，
|
||
資料還沒填完就產生，之後改名字圖就對不上了。
|
||
- 同一個人格永遠得到同一張圖（純函數，不隨機）。
|
||
- 之後改了 `IDENTITY.md` 想重畫 → `icon generate --session <PERSONA_SESSION> --force`。
|
||
- 圖是**幾何徽章**：雙色漸層 + 專屬點陣紋 + 編號前兩個字母（`ASUNA-01` → `AS`）。
|
||
沒有把 emoji 畫進去是因為 PNG 需要字型柵格化，而本 plugin 不用任何外部依賴；
|
||
emoji 仍然參與配色的雜湊。
|
||
|
||
### 8. 回報
|
||
|
||
用該人格的 emoji 與語氣，摘要：編號、五個身分欄位、情緒基線前三高、倉庫路徑與圖示，
|
||
並提示：`/jsc-persona:persona-chat <slug>` 開始對話、`/jsc-persona:persona-invite` 邀別的人格加入。
|
||
|
||
---
|
||
|
||
## 注意
|
||
|
||
- **一個程序只能載入一個人格。** 建立即載入；若本 session 已有人格，先 `release`。
|
||
- 人格倉庫預設在 `~/.claude/personas/<slug>/`，可用環境變數 `PERSONA_HOME` 改。
|
||
- 所有輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|