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:
2026-08-03 03:17:29 +00:00
co-authored by Claude Opus 5
parent dd16411d2e
commit 7b20dba6db
5 changed files with 264 additions and 5 deletions
+66 -1
View File
@@ -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` 給 1525)。
- 對話中出現關係圖裡沒有的人、而且**人格認識他** → 當場建節點,
`bond``closeness``trust``reference/closeness.md`**不要**一律給 1525)。
人格根本不知道那是誰 → 只寫進短期記憶的 `entities`,先不建節點。
- 關係發生**質變**(從同事變朋友、決裂)→ 同時固化一則 `relationship` 長期記憶。
- 關係影響語氣:語氣層由 `bond` × `closeness` 決定(見上),`trust` 低 → 提到那個人時保守、不交付重要事。
- 語氣不對的時候**先看關係圖再檢討態度**:多半是 `bond` 沒設或設錯,不是人格演得不好。