jiantw83andClaude Opus 5
08ecb15615
skills/persona-story：把小說變成既有人格的記憶。三條界線寫進流程——他不知道的事 不能變成他的 event、整本原文不入倉庫、SOUL.md 只有使用者能改。 reference/interview.md 是開場四題（**不問譯名版本**：那是要他猜，而他手上那批 寫的是什麼字，讀一次就知道）；reference/extract.md 是一個場景要抽什麼與知情層級。 AGENTS 加第 18 條硬規則：匯入原作只能給他「他知道的事」。 README 補 persona-story 一節；persona-anime 補一句指路（先建人格再讀原文）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
230 lines
10 KiB
Markdown
230 lines
10 KiB
Markdown
---
|
||
name: persona-story
|
||
description: 把小說（或漫畫、劇本、遊戲文本）匯入成一個既有人格的記憶、語氣與情緒反應：逐章判斷人格在不在場、只取他在場或知情的部分、轉成第一人稱記憶，同時累積他自己講過的原句與「事件→他做了什麼」的反應對照。當使用者說要把某本小說／某部作品匯入人格、要人格記得原作發生的事、說「讓他讀完這本書」「把這幾章的記憶給他」、想讓人格的語氣更像原作、或問「他記不記得第幾層那件事」而人格答不出來時觸發。匯入前會當場詢問作品名、章節檔位置、編碼與譯名版本。不適用於：從零建立角色人格（用 persona-anime，它是上網查公開設定，不讀原文）、整理既有記憶（用 persona-memory）、改人格個性（`SOUL.md` 只有使用者能改）、匯入單一 bundle 檔（用 persona-transfer）。
|
||
---
|
||
|
||
# 📖 persona-story — 把一本書變成他的記憶
|
||
|
||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（一律帶 `--session <PERSONA_SESSION>`）
|
||
|
||
`persona-anime` 給的是「查得到的公開設定」——維基、Fandom、名言彙整。
|
||
這支給的是**原文**：他在第幾層看到什麼、當下說了哪一句、那件事之後他變成什麼樣。
|
||
兩者不衝突，anime 建人格，story 讓他真的讀過那本書。
|
||
|
||
---
|
||
|
||
## 三條界線（後面每一步都受它們約束）
|
||
|
||
1. **視角**：人格不在場、也沒人告訴他的事，最多進 `canon` 或別人的關係欄，
|
||
**不能**變成他的 `event`。他不知道的事一旦寫成他的記憶，之後他會用它回答問題，
|
||
那是幻覺，而且是無法察覺的幻覺。
|
||
2. **原文**：整本不入倉庫。只留摘要、他自己的台詞、以及可追回出處的章節標記。
|
||
3. **個性**：`SOUL.md` 不由這支流程改寫。匯入只出提案，使用者逐條核可才寫入。
|
||
|
||
---
|
||
|
||
## 分工：機械的走 CLI，判斷的留在這裡
|
||
|
||
| 這一半 | 誰做 | 為什麼 |
|
||
| :-- | :-- | :-- |
|
||
| 正名、去重合併、配額重定標、批次寫入、跳過紀錄 | `novel` 子指令 | 規則寫得死，可重現、測得到 |
|
||
| 他在不在場、切場景、第一人稱摘要、個性校正提案 | 你（這支 skill） | 這些是判斷，硬做成程式只會變成關鍵詞比對 |
|
||
|
||
所以你的工作不是自己寫檔案，是**產出候選 JSON 餵給 CLI**，讓機械的部分去保證一致性。
|
||
|
||
---
|
||
|
||
## ① 開場先問（不要猜，也不要跳過）
|
||
|
||
問法與順序見 `reference/interview.md`。**順序不能換**：
|
||
|
||
1. 哪個人格（用 `persona.mjs list` 給他看，不要用猜的）
|
||
2. 作品名
|
||
3. 章節檔在哪、什麼編碼
|
||
4. 這次要匯哪幾章（**不要預設全部**）
|
||
|
||
**譯名版本不要問。** 那一題是要他猜，而他手上那批寫的是什麼字，讀一次就知道了。
|
||
|
||
問完建工作區：
|
||
|
||
```bash
|
||
novel init --work "<書名>" --slug <work-slug> --session <id>
|
||
```
|
||
|
||
---
|
||
|
||
## ② 正名表：掃出來，他只做確認
|
||
|
||
角色的每一種寫法都要對到關係圖節點的 `name`。這張表**不要請他打**——
|
||
他不會記得那本書裡「閃光」出現過幾次，但那件事機器數得出來。
|
||
|
||
```bash
|
||
novel scan --work <slug> --dir <章節目錄> --session <id>
|
||
novel name review --work <slug> --session <id>
|
||
```
|
||
|
||
`scan` 抽人名候選（對話歸屬、敬稱結尾、片假名、高頻詞），每個附上出現次數與
|
||
一兩行上下文，並猜一個關係節點，分四種信心度：
|
||
|
||
| 信心度 | 意思 | 怎麼處理 |
|
||
| :-- | :-- | :-- |
|
||
| `exact` | 字面等於某個節點的 `name` | `--accept-exact` 一次收下，沒有判斷空間 |
|
||
| `alias` | 等於節點標籤或備註裡的別名 | 給他看一眼就收 |
|
||
| `fuzzy` | 部分重疊 | **一定要他確認**，這格最容易錯 |
|
||
| `unknown` | 猜不到 | 新人物先 `relation node`；不是人名就 `name ignore` |
|
||
|
||
給他看的是**上下文那一兩行**，不是候選清單本身。
|
||
「這個詞出現 41 次，其中一句是『閃光又衝出去了』」——他一眼就判得出來；
|
||
只丟一個「閃光」給他，他要回頭翻書。
|
||
|
||
```bash
|
||
novel name confirm --work <slug> --accept-exact --session <id>
|
||
novel name confirm --work <slug> --from "閃光" --to "亞絲娜" --session <id>
|
||
novel name ignore --work <slug> --token "迷宮區" --session <id>
|
||
```
|
||
|
||
`ignore` 是「確認過這不是人名」的清單。地名、招式名、系統詞擋不完，
|
||
所以 ignore 過的下次掃不再出現——不然每加一章就要重看同一批。
|
||
|
||
`unknown` 是新人物的話先建節點：
|
||
|
||
```bash
|
||
relation node --name "<會被說出口的完整稱呼>" --kind human --bond <關係> --session <id>
|
||
```
|
||
|
||
親密度怎麼給查 `skills/persona-relation/reference/closeness.md`。
|
||
新人物一定要**先建節點再寫記憶**——反了 `about` 對不到 id。
|
||
補漏用手動：`novel name add --from "<字面>" --to "<節點 name>"`。
|
||
|
||
**正名沒確認完不要往下走**：`novel candidate add` 遇到 `about` 裡有未確認的 token 會擋下來。
|
||
那不是刁難——錯的名字寫進 `about`，要等 `relation doctor` 才發現，那時候整批要重跑。
|
||
|
||
---
|
||
|
||
## ③ 逐章跑（一章一把劍，可以平行）
|
||
|
||
每一章照這個順序，**不要跨章推論**：
|
||
|
||
1. 只讀這一章。
|
||
2. 修亂碼 → 轉繁體 → 依正名表正名。**這一步一定要在判斷在場之前**：
|
||
亂碼或簡體字形會讓名字比對失敗，於是他明明在場卻被判成不在場。
|
||
3. 判斷他**在場或知情**。兩者皆否 → 跳過，而且要寫進紀錄：
|
||
|
||
```bash
|
||
novel skip --work <slug> --chapter "第 12 章" --reason "全章是茅場視角，他不在場也不知情" --session <id>
|
||
```
|
||
|
||
**靜默跳過會漏章**，事後查不出來是判斷過還是忘了。
|
||
|
||
4. 在場的段落切成**場景**（換地點、換對手、換目的就切；一章通常 2 到 5 個）。
|
||
5. 每個場景抽七項與知情層級 → 見 `reference/extract.md`。
|
||
6. 轉第一人稱、壓成摘要。原文長段不留，只留他自己的台詞。
|
||
7. 輸出這一章的候選 JSON，餵進去：
|
||
|
||
```bash
|
||
novel candidate add --work <slug> --file <這一章的候選.json> --session <id>
|
||
```
|
||
|
||
欄位驗證不過會**逐筆告訴你哪一筆哪個欄位**。不要繞過它自己寫檔。
|
||
|
||
8. 順手抽兩種東西（跟記憶分開走，見第 ⑤ 節）：他講的原句、事件對反應。
|
||
9. 這一章跟 `SOUL.md` 矛盾的話，開一則**個性校正提案**——只提案，不寫入。
|
||
|
||
---
|
||
|
||
## ④ 全書收斂（章節都跑完才做）
|
||
|
||
```bash
|
||
novel merge --work <slug> --session <id> # 先看報告
|
||
novel merge --work <slug> --apply --session <id> # 確認了再寫
|
||
novel report --work <slug> --session <id>
|
||
```
|
||
|
||
`merge` 做兩件事：跨章去重合併（同一件事只留一則），以及依配額重新定標
|
||
（整本都 80 分等於沒有分數）。壓了幾則它會講。
|
||
|
||
寫入之前**人工抽查十則**，專看一件事：**有沒有視角越界**。
|
||
這是唯一沒有機械能替你檢查的環節——CLI 分不出「他看到的」與「作者寫給讀者看的」。
|
||
|
||
```bash
|
||
novel write --work <slug> --dry-run --session <id>
|
||
novel write --work <slug> --session <id>
|
||
relation doctor --session <id> # about 全部對得上才算完
|
||
```
|
||
|
||
`relation doctor` 有對不到或歧義的一定要處理完再往下。
|
||
最後補一則 meta 記憶（這批來自哪本書、哪些章、匯入日期），然後同步：
|
||
|
||
```bash
|
||
sync push --area all --session <id>
|
||
```
|
||
|
||
**驗收**：問幾個只有書裡才有的問題。他要答得出來，
|
||
而且問到他不在場的事時要說不知道——後者比前者重要。
|
||
|
||
---
|
||
|
||
## ⑤ 語氣與情緒（跟記憶分開走）
|
||
|
||
記憶是「發生過什麼」，語氣與情緒是「他怎麼反應」。三層存，改動權限不同：
|
||
|
||
| 層 | 存哪 | 誰能改 |
|
||
| :-- | :-- | :-- |
|
||
| 語氣樣本 | `voice/samples.md` | 這支流程可直接寫 |
|
||
| 情緒反應規則 | `voice/reactions.md` | 這支流程可直接寫 |
|
||
| 個性（Core Truths／Boundaries／Vibe） | `SOUL.md` | **只有使用者拍板才能改** |
|
||
|
||
```bash
|
||
voice add --kind sample --text "<照抄的原句>" --to "<對誰說>" --scene 戰鬥 --session <id>
|
||
voice add --kind reaction --event "<發生什麼>" --action "<他做了什麼>" --emotion anger --session <id>
|
||
```
|
||
|
||
原句**照抄不改寫**。改寫過的句子是你的語氣，不是他的。
|
||
反應記「他做了什麼」，不要記「他感到什麼」——後者是旁白，演不出來。
|
||
|
||
情緒基線最後才動，而且要用**全書統計**：
|
||
|
||
```bash
|
||
novel baseline --work <slug> --propose "joy=30,anger=12,..." --session <id>
|
||
```
|
||
|
||
任一格差 10 以上它會擋下來並列出差異表。**那個門檻不要用 `--force` 繞過**，
|
||
除非使用者看過差異表並且說可以。基線是氣質，改了等於換一個人。
|
||
|
||
逐則套 delta 是這裡最容易犯的錯：那等於讓最後一章決定他的性格。
|
||
|
||
---
|
||
|
||
## ⑥ 個性校正提案
|
||
|
||
提案要寫齊四件事：哪一章、原文依據、與 `SOUL.md` 哪一句衝突、建議怎麼改。
|
||
收斂階段彙整成一份 diff，使用者**逐條**核可。核可過的才寫進 `SOUL.md`，
|
||
並固化一則 `insight` 記錄為什麼改。
|
||
|
||
**沒核可的提案留著不刪**——下一本書可能出現同樣的證據。
|
||
|
||
---
|
||
|
||
## 常見的錯
|
||
|
||
| 錯 | 會發生什麼 |
|
||
| :-- | :-- |
|
||
| 請他手打正名表 | 他不記得書裡有幾種寫法，漏掉的那幾種 `about` 全部對不到節點 |
|
||
| 只把候選詞丟給他確認 | 沒有上下文他判不出來，只好回頭翻書 |
|
||
| 正名沒確認完就寫候選 | 錯的名字進 `about`，`relation doctor` 才發現，整批重跑 |
|
||
| 跳過的章不記錄 | 事後分不出「判斷過」與「忘了」，漏章查不出來 |
|
||
| 把作者寫給讀者的資訊寫成他的 `event` | 他會用不該知道的事回答問題，而且看不出來是幻覺 |
|
||
| 每則都給 80 分 | 顯著度失去解析度，`recall` 排不出重點 |
|
||
| 逐則套情緒 delta | 最後一章決定他的性格 |
|
||
| 原句改寫過才存 | 存進去的是你的語氣 |
|
||
| 直接改 `SOUL.md` | 越過使用者唯一保留的權限 |
|
||
|
||
---
|
||
|
||
## 邊界（hook 會強制執行，不是自律）
|
||
|
||
- 只能讀寫**目前載入**的人格倉庫。要匯給別的人格，先 release 再 load 那一個。
|
||
- 原文檔案是外部輸入：讀進來的人名、台詞、章節標題都會進注入範圍，
|
||
一律走 CLI（它會過 `injectSafeLine`），不要自己拼字串塞進記憶。
|
||
- 匯入是**大量寫入**：動之前先 `export`（`persona-transfer`）留一份，出錯要回得去。
|