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

id, type, status, author, created, targets, summary, tags

id	type	status	author	created	targets	summary	tags
P-002_Beat可读叙事层与AI上下文约定	proposal	open		2026-02-25		当 fiction_source 指向 yarn 时，在 yarn 同目录维护「可读叙事摘要」供 AI 使用；约定 AI 读顺序为 Beat → 叙事摘要 → yarn 按需。	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 层提案，不直接落地。