diff --git a/proposals/P-002_Beat可读叙事层与AI上下文约定.md b/proposals/P-002_Beat可读叙事层与AI上下文约定.md new file mode 100644 index 0000000..cd4938c --- /dev/null +++ b/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 层提案,不直接落地。