plugins/persona
2
0
Fork 0
Code Pull Requests Activity
Files
e986686d0e3ce3541a1bb86a00ca786bac1da32e
persona/skills/persona-create/SKILL.md
T
jiantw83andClaude Opus 5 e986686d0e feat: 人格編號（ASUNA-01）與 Gitea 儲存，依更新頻率分檔案區/Wiki 區 
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>
2026-07-30 01:49:27 +00:00

128 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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. 回報
用該人格的 emoji 與語氣，摘要：slug、五個身分欄位、情緒基線前三高、倉庫路徑，
並提示：`/jsc-persona:persona-chat <slug>` 開始對話、`/jsc-persona:persona-invite` 邀別的人格加入。
---
## 注意
- **一個程序只能載入一個人格。** 建立即載入；若本 session 已有人格，先 `release`。
- 人格倉庫預設在 `~/.claude/personas/<slug>/`，可用環境變數 `PERSONA_HOME` 改。
- 所有輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
View Git Blame Copy Permalink