summary写作规范

AGENTS.md

@@ -28,6 +28,8 @@
 | **第 2 层（自然语言介绍）** | 对判定为相关的文件，只读到「自然语言介绍」结束（不读权威设定详情、冲突、changelog） | 快速理解实体；多数讨论/提案到此即可 |
 | **第 3 层（全文）** | 读该文件全文（含 SSOT、冲突、changelog） | 需要精确设定、修改 SSOT、或查冲突/变更记录时 |
 
+Bible/Beat 的 `summary` 须符合 **summary 写作规范**（模板：身份/定位 + 核心矛盾或功能 + 与主线钩子；≤60 字），详见 `template/README.md`，以便第一层过滤可靠。
+
 ## 目录结构
 
 | 路径 | 用途 |

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ## 2026-02-25
 
+- **summary 写作规范**：统一 Bible/Beat 的 frontmatter `summary` 写法——模板「[身份/定位]+[核心矛盾或功能]+[与主线的关键钩子]」、≤60 字；`template/README.md` 新增该节（类型侧重、正反例）；`AGENTS.md` 渐进式读取处引用；`tpl-character`/`tpl-worldbuilding`/`tpl-beat` 的 summary 注释同步
 - **Beat 叙事信源迁移**：Beat 的叙事 SSOT 随阶段迁移（short-fiction → flow → full-fiction → yarn）；模板 `tpl-beat.md` 增加 `fiction_source` 字段（`self` = 本文件 Fiction 区即 SSOT，外部路径 = 仅保留骨架摘要）；Fiction 区增加信源说明折叠块
 - **template/README.md**：新增「Beat 叙事信源迁移（fiction_source）」一节（四阶段表、规则、工程文档归属）；文末新增变更日志
 - **Beat 职责重定义**：Beat 做 yarn 做不到的事（设计意图、reveals、情绪、状态、变更日志）；信源在 yarn 时 Fiction 区只写骨架 + 指向；决策与讨论归档见 [[kb/decisions/2026-02-25-Beat职责重定义与叙事信源迁移]]

kb/template/tpl-beat.md

@@ -8,7 +8,7 @@ status: draft           # draft | backlog | review | locked  （backlog=需存
 dev_status: fiction     # fiction | playable | function | prototype | close
 fiction_source: self    # 叙事信源位置。self = 本文 Fiction 区即 SSOT；指向外部时填路径（如 Yarn 文件夹路径或 flow 文档链接）
 emotional_tone: ""      # 情绪基调，例："压抑/解脱" "荒诞/温暖"
-summary: ""             # 一句话概述
+summary: ""             # ≤60字；[谁/场景]+[核心矛盾或转折]+[对主线/角色影响]，见 template/README.md「summary 写作规范」
 player_feels: ""        # 本 Beat 情绪落点
 characters: []          # 出场角色，用内联数组与 kb/bible/角色 挂接（例：[路斯, 佩佩]，勿用多行列表，否则 Dataview 可能解析为链接导致角色页查不到）
 terms: []               # 涉及设定（与 kb/bible/设定 挂接）

template/README.md

@@ -31,6 +31,32 @@ Templater 语法对应：`<% await tp.system.prompt("提示", "默认值") %>`
 
 ---
 
+## summary 写作规范
+
+第一层渐进式读取依赖 frontmatter 的 `summary` 做相关性过滤，故需统一格式与字数，避免偏流程、偏流水账的描述。
+
+- **字数**：不超过 **60 字**（按字符计，含标点）。
+- **结构模板**：**\[身份/定位] + [核心矛盾或功能] + [与主线的关键钩子]**  
+  不必机械拆成三句，但需同时覆盖「是谁/是什么」「核心矛盾或功能」「和主线/关键剧情的关系」。
+- **避免**：只写「发生了 A → 然后 B → 然后 C」的流程梗概；应提炼**矛盾、功能、钩子**，方便第一层判断是否与当前任务相关。
+
+| 类型 | 侧重 |
+|------|------|
+| **角色** | 身份/气质 + 核心矛盾或欲望 + 与主线或关键角色的钩子 |
+| **设定** | 是什么/功能 + 在剧情中的关键作用或矛盾 + 与主线/核心事件的钩子 |
+| **节拍** | 谁/场景 + 核心矛盾或情绪转折 + 对主线或角色弧的关键影响（非流水步骤） |
+
+**示例（符合规范）**  
+- 角色·奇琳：*「用眼泪给客人调制美酒，眼泪从未为自己而流；东京打工妹气质、努力坚强，过度渴望他人爱与认可。」*（身份+矛盾+钩子，约 50 字）  
+- 设定·罐头：*「机体维持生存的综合凝胶，每日必需品；迷梦/特别罐头由记忆制造、激发原型人性，与销赛、戈塔什、暴动线核心相关。」*（功能+作用+主线钩子）
+
+**反例（偏流程，不宜作 summary）**  
+- 节拍：*「火山表达模块崩溃，堆积很多没说出口的话。效率审查司拦住导致紧张。帮助校准情绪处理器，让他自信起来。」* → 可改为强调矛盾与落点，例如：*「火山因审查司拦截积压未说之话、表达崩溃；维修中校准情绪处理器，落点振作与自信。」*（≤60 字，含谁、矛盾、对角色/主线的影响）
+
+新建或更新 Bible/Beat 时，summary 须满足上述规范；与正文「一句话」一致，但可更压缩以适配 60 字上限。
+
+---
+
 ## 新建文件流程
 
 - **人类**：命令面板 → `Templater: Create new note from template` → 选模板 → 保存到对应目录。
@@ -77,4 +103,5 @@ Beat 的叙事 SSOT 不是永远写在 Fiction 区——它随开发阶段迁移
 
 | 日期 | 变更内容 | 决策理由 / 来源 |
 |------|---------|-----------------|
+| 2026-02-25 | 新增「summary 写作规范」：模板「身份/定位+核心矛盾或功能+与主线钩子」、≤60 字、类型侧重与正反例 | 统一第一层渐进式读取的 summary 质量，避免偏流程描述；见项目 CHANGELOG |
 | 2026-02-25 | 新增「Beat 叙事信源迁移（fiction_source）」一节 | Beat 职责重定义：叙事 SSOT 随阶段迁移，详见 [[kb/decisions/2026-02-25-Beat职责重定义与叙事信源迁移]] |

template/tpl-beat.md

@@ -8,7 +8,7 @@ status: draft           # draft | backlog | review | locked  （backlog=需存
 dev_status: fiction     # fiction | playable | function | prototype | close
 fiction_source: self    # 叙事信源位置。self = 本文 Fiction 区即 SSOT；指向外部时填路径（如 Yarn 文件夹路径或 flow 文档链接）
 emotional_tone: ""      # 情绪基调，例："压抑/解脱" "荒诞/温暖"
-summary: ""             # 一句话概述
+summary: ""             # ≤60字；[谁/场景]+[核心矛盾或转折]+[对主线/角色影响]，见 template/README.md「summary 写作规范」
 player_feels: ""        # 本 Beat 情绪落点
 characters: []          # 出场角色，用内联数组与 kb/bible/角色 挂接（例：[路斯, 佩佩]，勿用多行列表，否则 Dataview 可能解析为链接导致角色页查不到）
 terms: []               # 涉及设定（与 kb/bible/设定 挂接）

template/tpl-character.md

@@ -1,7 +1,7 @@
 ---
 id: ""
 type: character
-summary: ""             # 一句话摘要，供 YAML 索引与渐进式读取；与正文「一句话」同步
+summary: ""             # ≤60字；[身份]+[核心矛盾]+[与主线钩子]，见 template/README.md「summary 写作规范」
 aliases: []             # 别名/代号，如 ["Kirin", "调酒妹", "奇琳"]
 status: active          # active | suspended | archived | ⚠️ Conflict | 🚧 WIP
 created: ""

template/tpl-worldbuilding.md

@@ -1,7 +1,7 @@
 ---
 id: ""
 type: worldbuilding
-summary: ""             # 一句话摘要，供 YAML 索引与渐进式读取；与正文「一句话」同步
+summary: ""             # ≤60字；[是什么/功能]+[剧情作用]+[与主线钩子]，见 template/README.md「summary 写作规范」
 category: ""            # 社会制度 | 技术 | 地理 | 历史事件 | 组织 | 物品
 aliases: []             # 别名，如 ["蜂群思维", "蜂群", "Hivemind"]
 status: active          # active | disputed | deprecated