---
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 层提案，不直接落地。
