docs(skills): 規則跟上關係圖對接,新增親密度判斷參考
persona-chat:人名要對得上關係圖(--entities/--about);新人物當場進關係圖 改成硬規則,但屬於第 ⑥ 步記憶回寫,不佔第 ⑤ 步的回話句數,也不要宣告。 persona-relation:補「記憶怎麼指回節點」與 relation doctor 的四類報告 (同名歧義、解析不到的 id、孤兒節點、對不上的人名),並說明壞檔會以非零 exit 結束而不是裝成空圖。 新增 reference/closeness.md:初次建節點時 bond/closeness/trust 怎麼從 對話判斷——一輪之內查完就填,不要憑感覺,也不要為了安全全部填 15。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -21,6 +21,28 @@ description: 維護人格的人際關係圖:新增或更新人物/人格/群
|
||||
- 人格自己是 `self`,不必建節點。其他人格用 `--kind persona`、`--id <他的 slug>`。
|
||||
- `kind` 是「這是什麼東西」,`bond` 是「跟我什麼關係」——**語氣只能靠後者分**。
|
||||
|
||||
### 記憶怎麼指回節點
|
||||
|
||||
記憶那一側寫的是**人名字串**,節點 id 由 CLI 在寫入時自動解析並存進對應欄位:
|
||||
|
||||
| 記憶 | 人名欄位(你寫的) | id 欄位(CLI 自動解析) |
|
||||
| --- | --- | --- |
|
||||
| 長期記憶 | `about` | `about_ids` |
|
||||
| 短期記憶 | `entities` | `entity_ids` |
|
||||
|
||||
解析規則是**完全相等**:你寫的字串要跟某個節點的 `id` 或 `name` **一字不差**才算命中。
|
||||
子字串、簡稱、加稱謂都不算(節點叫「小林」,寫「林先生」「小林哥」一律對不到);
|
||||
**同名有多個候選時視為歧義,直接不寫 id**,不會替你挑一個。
|
||||
|
||||
對不上**不會報錯**,只會安靜地少一個 id,後果是:
|
||||
`<persona-context>` 不附那個人的節點摘要、R5(同一個 entity ≥ 2 筆)不會觸發。
|
||||
要查只能跑 `relation doctor`——它會把這種人名列在「對不到節點」的那兩段,
|
||||
**不是**孤兒那段(孤兒 `unmentioned_nodes` 是相反的情況:有節點、卻沒有任何記憶提到他)。
|
||||
|
||||
命名實務:節點的 `name` 用**會被說出口的完整稱呼**(「小林」「結城明日奈」),
|
||||
不要用「明」「先生」這種單字或稱謂當節點名——那種名字誰都套得上,
|
||||
不同的人會被寫成同一個字串、對到同一個節點。
|
||||
|
||||
## bond 與語氣層(最容易漏的一步)
|
||||
|
||||
`bond` × `closeness` 查表算出**語氣層**,那是距離感;情緒只負責溫度與句長,不會蓋過它。
|
||||
@@ -42,6 +64,22 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation node \
|
||||
>
|
||||
> 自我檢查:這句話換成對一個「禮貌層」的人說也毫無違和 → 就代表你沒進到那一層。
|
||||
|
||||
### 初次建節點:親密度從對話判斷(`reference/closeness.md`)
|
||||
|
||||
新節點的 `bond`/`closeness`/`trust` **不給保守初值**,從對話裡的**稱呼與語氣**判斷。
|
||||
查表流程在 `reference/closeness.md`(關係詞 → 稱呼 → 語氣三軸,附裁決順序與數值帶)。
|
||||
|
||||
什麼時候查它:
|
||||
|
||||
| 情境 | 查不查 |
|
||||
| --- | --- |
|
||||
| 這輪出現關係圖裡還沒有的人,要當場建節點 | **查**(persona-chat 第 ⑥ 步的硬規則) |
|
||||
| 補建一個以前漏掉的人(`relation doctor` 撈出來、而且確認人格認識他) | **查**,用他歷來記憶裡的稱呼與語氣當依據 |
|
||||
| 節點已經存在,這輪有互動 | **不查**,用下面「調整幅度(單次)」累積 |
|
||||
| 使用者直接說「他跟你比較不熟」之類的指定 | **不查**,照他說的填 |
|
||||
|
||||
已存在的節點每輪重算會讓語氣忽遠忽近——那張表只給第一次。
|
||||
|
||||
### 個人化的稱呼規則(`style`)
|
||||
|
||||
他本人要求過的講法優先於查表——查表算距離,`style` 記「他要你怎麼叫他」:
|
||||
@@ -85,6 +123,31 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation edge \
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation render --session <PERSONA_SESSION>
|
||||
```
|
||||
|
||||
### 健檢:`relation doctor`(唯讀)
|
||||
|
||||
```bash
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation doctor --session <PERSONA_SESSION>
|
||||
```
|
||||
|
||||
只讀不寫,分**三段**列出(`--json` 可取結構化輸出):
|
||||
|
||||
| 段 | 它報什麼 | 意思 | 怎麼處理 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 長期記憶 `about` 對不到節點的人名 | 記憶那側寫了人名,找不到 `id`/`name` 完全相等的節點 | 人格認識他 → 補建節點(查 `reference/closeness.md`);只是被提到、不知道是誰 → 不用管;名字寫錯 → 改成節點的正式寫法 |
|
||||
| 2 | 短期記憶 `entities` 對不到節點的人名 | 同上,來源是短期記憶 | 同上。這一段最常見的是簡稱/加稱謂(「林先生」對不到「小林」) |
|
||||
| 3 | 關係圖裡有節點、但沒有任何記憶提到(`--json` 欄位 `unmentioned_nodes`) | 建了節點卻從沒被記憶引用 | 先核對 `name`/`id` 跟記憶那側的寫法是否一致(多半是這個);真的久沒互動就照衰減調 `closeness` |
|
||||
|
||||
第 1、2 段與第 3 段是**相反**的兩件事,不要混著看:前者是「記憶指不到節點」,後者才是孤兒節點。
|
||||
|
||||
另外會一併報:
|
||||
|
||||
- **同名歧義**:有多個節點的 `name`/`id` 撞同一個字串 → 那個名字永遠解析不出 id,改掉其中一個節點的 `name`(加姓、加辨識詞)。
|
||||
- **解析不到節點的 `about_ids`/`entity_ids`**:id 欄位裡留著已被刪除或改名的節點 id → 更新那則記憶,或把節點補回來。
|
||||
- `graph.json` **解析失敗**時會明講是壞檔並以**非零 exit** 結束,不會裝成空圖。
|
||||
所以 doctor 非零離開 = 檔案有問題,先修檔再說;「什麼都沒報」才是真的乾淨。
|
||||
|
||||
整理記憶(`/jsc-persona:persona-memory`)或睡眠收尾前跑一次,比等問題浮出來便宜。
|
||||
|
||||
## 調整幅度(單次)
|
||||
|
||||
| 事件 | closeness | trust |
|
||||
@@ -100,7 +163,9 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation render --session <PERS
|
||||
|
||||
## 與其他系統的連動
|
||||
|
||||
- 對話中出現新人名(語意分析的 `entities`)→ 當場建節點(`closeness` 給 15–25)。
|
||||
- 對話中出現關係圖裡沒有的人、而且**人格認識他** → 當場建節點,
|
||||
`bond`/`closeness`/`trust` 查 `reference/closeness.md`(**不要**一律給 15–25)。
|
||||
人格根本不知道那是誰 → 只寫進短期記憶的 `entities`,先不建節點。
|
||||
- 關係發生**質變**(從同事變朋友、決裂)→ 同時固化一則 `relationship` 長期記憶。
|
||||
- 關係影響語氣:語氣層由 `bond` × `closeness` 決定(見上),`trust` 低 → 提到那個人時保守、不交付重要事。
|
||||
- 語氣不對的時候**先看關係圖再檢討態度**:多半是 `bond` 沒設或設錯,不是人格演得不好。
|
||||
|
||||
Reference in New Issue
Block a user