新增关于beat维护单一信源的提案

proposals/P-002_Beat可读叙事层与AI上下文约定.md

@@ -0,0 +1,64 @@
+---
+id: P-002_Beat可读叙事层与AI上下文约定
+type: proposal
+status: open
+author: ""
+created: "2026-02-25"
+targets: []             # meta 层提案，不针对具体 Bible/Beat；涉及 template/README、Beat 约定、AGENTS 读顺序
+summary: "当 fiction_source 指向 yarn 时，在 yarn 同目录维护「可读叙事摘要」供 AI 使用；约定 AI 读顺序为 Beat → 叙事摘要 → yarn 按需。"
+tags: [proposal, meta]
+---
+
+# 提案：Beat 可读叙事层与 AI 上下文约定
+
+> **层级**：meta（流程/模板/约定）。采纳后写入 template/README 或 AGENTS，不修改具体 Bible/Beat 内容。
+
+## 💡 核心创意
+
+当叙事 SSOT 已迁移到 yarn 时，yarn 是事实信源但不利于 AI 当「叙事上下文」读。增加一层**仅供可读的叙事摘要**，与 yarn 同目录维护；并约定「为 AI 提供最好上下文」的读顺序：Beat（元数据+骨架）→ 可读叙事摘要 → yarn 按需。
+
+## 📝 详细内容
+
+### 问题
+
+- 维护核心是为 AI 提供最好上下文。
+- 最准确的叙事在 yarn，但 yarn 难读（节点、命令、变量、line ID）。
+- Beat 骨架不足以支撑「这段具体在说什么、关键台词是什么」的细粒度参考。
+
+### 提议
+
+1. **可读叙事层**  
+   - 当 `fiction_source` 指向某 yarn 目录时，**允许**在该目录下维护一份 `叙事摘要.md`（或 `story-for-ai.md`）。  
+   - 内容：按 Stage/节点写「发生了什么、关键句、转折」，人话为主，少写命令与结构。  
+   - 与 yarn 一起维护（设计师改 yarn 时顺手更几句，或从 yarn 抽关键台词贴进去）。  
+   - 不当作 SSOT，仅作「给 AI 读的叙事」。
+
+2. **Beat 中的指向**  
+   - 在 Beat 的 Fiction 区信源说明中增加可选一句：*可读叙事见 `{yarn 路径}/叙事摘要.md`*。  
+   - 若存在该文件，AI 优先读 Beat → 再读该摘要；需要逐句/分支/命令时再读 yarn。
+
+3. **约定：AI 读顺序**  
+   - 写入 template/README 或 AGENTS（或两者）：  
+     1. 读 Beat（元数据 + 骨架 + fiction_source）；  
+     2. 若 fiction_source 指向 yarn 且存在「可读叙事」文件 → 读该文件；  
+     3. 仅当需要逐句、分支、命令时再读 yarn。
+
+4. **可选**  
+   - 日后若有需求，可做「从 yarn 生成叙事快照」的脚本，将可读版导出到 kb 或同目录。
+
+### 落地若采纳
+
+- template/README「Beat 叙事信源迁移」一节增加「可读叙事与 AI 上下文」小节。  
+- Beat 模板中信源说明折叠块增加可选「可读叙事路径」说明。  
+- 可选：在 yarn 目录提供 `叙事摘要.md` 的简易模板（如 Test_Huoshan）。
+
+## 🔍 初始影响分析 (Snapshot)
+
+- **template/README.md**：新增「可读叙事与 AI 上下文」约定。
+- **template/tpl-beat.md**（及 kb/template 同步）：Fiction 区信源说明可增加「可读叙事见 …」指引。
+- **AGENTS.md**（可选）：若希望 Agent 统一遵守读顺序，可在此写「读 Beat 时当 fiction_source 为 yarn 且存在可读叙事文件则优先读该文件」。
+- 无具体 Bible/Beat 内容变更；仅约定与模板文案。
+
+## 💬 讨论记录
+
+- 2026-02-25：用户希望将「yarn 难读、AI 需要可读上下文」的解决方案保留为 meta 层提案，不直接落地。