docs(agent): 渐进式读取规则与 SKILL 同步

Co-authored-by: Cursor <cursoragent@cursor.com>

.cursor/skills/inbox-directive/SKILL.md

@@ -7,12 +7,15 @@ description: Use when 指令、按此修改 SSOT、直接落地、处理 inbox
 
 **直接修改 SSOT**（更新/新建 bible 与 beat），然后归档。通用约束见 **AGENTS.md**。
 
+读 kb 时遵循 **AGENTS.md** 之「渐进式读取」（第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需）；新建/更新 Bible 时 frontmatter 须含 `summary`。
+
 ## A. 处理 Inbox 文件（指令路径）
 
 ### 阶段一（只读，不修改任何文件）
 
-1. 识别实体（角色、设定、节拍），对每个判断操作（更新/新建/废弃）。
+1. **按渐进式读取**：第 1 层确定涉及实体，第 2 层理解实体，需改 SSOT 时再第 3 层。
-2. 输出分析报告，**等人确认**。报告须含：
+2. 识别实体（角色、设定、节拍），对每个判断操作（更新/新建/废弃）。
+3. 输出分析报告，**等人确认**。报告须含：
    - **涉及实体**：角色 / 设定 / Beat 列表
    - **建议操作表**：| 实体 | 类型 | 操作 | 具体内容 | 是否有冲突 |
    - **待人确认项**（冲突裁决、新建是否符合预期等）
@@ -37,7 +40,7 @@ description: Use when 指令、按此修改 SSOT、直接落地、处理 inbox
 ## B. 采纳提案（如「采纳 P-001」）
 
 1. **重读**：读该提案全文。
-2. **重验**：扫描相关 Bible/Beat，看与现有一致性、是否有新冲突。
+2. **重验**：按渐进式读取（AGENTS.md）先第 1 层判定相关文件，再第 2/3 层精读提案 `targets` 所列及相关 Bible/Beat，看与现有一致性、是否有新冲突。
 3. **报告**：若影响分析过时则说明当前影响；否则简要确认。
 4. **执行**：用户确认后，合并入 SSOT、更新 changelog；提案移入 `proposals/archive/`（项目根），`status: accepted`。
 

.cursor/skills/inbox-discussion/SKILL.md

@@ -5,4 +5,6 @@ description: Use when 讨论、头脑风暴、信息收集、探索想法、还
 
 # 讨论
 
-用户选择**讨论**或未明确指令/提案时：只做信息收集与对话，不修改 `kb/`，不创建提案、不写 SSOT。需要落地时再请用户标明「提案」或「指令」，再走 **inbox-proposal** 或 **inbox-directive**。
+在 `kb/` 查询信息时：只做信息收集与对话，不修改 `kb/`，不创建提案、不写 SSOT。需要落地时再请用户标明「提案」或「指令」，再走 **inbox-proposal** 或 **inbox-directive**。
+
+读 kb 时遵循 **AGENTS.md** 之「渐进式读取」（第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需）。

.cursor/skills/inbox-proposal/SKILL.md

@@ -7,6 +7,10 @@ description: Use when 提案、想法进提案库、inbox 标为提案、仅写
 
 **不修改 SSOT**。将内容写入项目根 `proposals/`，填写 `targets` 指向涉及的 Bible/Beat；对应页面底部由 Dataview 展示「关联提案」。
 
+读 kb 时遵循 **AGENTS.md** 之「渐进式读取」（第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需）；写「初始影响分析」时通常第 2 层即可。
+
+## 步骤
+
 1. **创建提案文件**：从 `template/tpl-proposal.md` 复制到 `proposals/P-{序号}_{简短标题}.md`（项目根），序号取未占用最小三位数。
 2. **frontmatter**：`targets`（wikilink 数组，如 `[[kb/bible/角色/佩佩]]`、`[[kb/beats/佩佩-维修1]]`）、`summary`（与核心创意一致的一句话）。
 3. **正文**：核心创意、详细内容、**初始影响分析**（基于当前 kb，列出可能受影响的 Beat/Bible 与冲突点）、讨论记录可留空。

AGENTS.md

@@ -16,6 +16,17 @@
 6. **模板为聚合服务，结构随信息而定**：模板用于更好地聚合与检索；具体条目可根据实际聚合到的信息，选择适合的小节与呈现方式（例如无冲突则冲突表可留空，回忆角色可弱化机制、强化弧线/意象），不必机械填满模板每一项。
 7. **不物理删除**：AI 没有删除文件的权限。若 Inbox 或人类要求「删掉设定/角色/节拍 X」，一律按**废弃**处理：将对应条目的 `status` 改为 `archived` 或 `deprecated`；具体流程见 `inbox-directive` SKILL 的「废弃处理」；**绝不物理删除**文件。
 8. **自然语言介绍与 SSOT 同步**：每当 SSOT（权威设定详情）发生重大变更（如核心矛盾、身份、生死状态变化）时，必须检查并重写该条目的「自然语言介绍」部分，避免介绍老化。
+9. **渐进式读取**：读 kb 时按下方「渐进式读取」三层递进；Bible 新建/更新时 frontmatter 须含 `summary`。
+
+### 渐进式读取（三层）
+
+读 kb 时按层递进，不全量读全文。适用范围：`kb/bible/角色/`、`kb/bible/设定/`、`kb/beats/`。
+
+| 层 | 内容 | 用途 |
+|----|------|------|
+| **第 1 层（YAML）** | 只读各文件 frontmatter（约前 15 行）。用 `id`、`summary`、`characters`、`terms`、`related_characters`、`related_worldbuilding` | 判断与当前任务相关的文件 |
+| **第 2 层（自然语言介绍）** | 对判定为相关的文件，只读到「自然语言介绍」结束（不读权威设定详情、冲突、changelog） | 快速理解实体；多数讨论/提案到此即可 |
+| **第 3 层（全文）** | 读该文件全文（含 SSOT、冲突、changelog） | 需要精确设定、修改 SSOT、或查冲突/变更记录时 |
 
 ## 目录结构