From 07871682f7a871e0e9e486e1a8718d3790938287 Mon Sep 17 00:00:00 2001 From: bottlefish <781230111@qq.com> Date: Tue, 24 Feb 2026 16:18:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(agent):=20=E6=9B=B4=E6=96=B0=20AGENTS=20?= =?UTF-8?q?=E4=B8=8E=20inbox-process=20=E6=8A=80=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .cursor/skills/inbox-process/SKILL.md | 15 +++++++++++---- AGENTS.md | 26 ++++++++++++++++++++------ 2 files changed, 31 insertions(+), 10 deletions(-) diff --git a/.cursor/skills/inbox-process/SKILL.md b/.cursor/skills/inbox-process/SKILL.md index a970b75..9f801ea 100644 --- a/.cursor/skills/inbox-process/SKILL.md +++ b/.cursor/skills/inbox-process/SKILL.md @@ -80,9 +80,10 @@ description: Use when processing inbox files, archiving eureka notes, updating b **没有 beat → 新建** - 从 `template/tpl-beat.md` 复制到 `kb/beats/{id}.md` - 替换占位符，填写 frontmatter 中能确定的字段 -- Fiction 必须有至少一句话的草稿，不能只有 YAML -- 在 frontmatter 加 `created_by: ai`，`status` 设为 `draft` -- **新建后必须回到对应角色 bible 的叙事时间线加一行，状态标 `🚧 草稿`** +- **status**：若有具体 Fiction 草稿（至少一句话）→ `draft`；若仅因索引/叙事时间线需要而新建、尚无具体内容 → `backlog` +- Fiction：draft 时必须有至少一句话的草稿；backlog 时可为占位句（如「待写」），不能只有 YAML +- 在 frontmatter 加 `created_by: ai` +- **新建后必须回到对应 bible 的叙事时间线加一行**：draft 标 `🚧 草稿`，backlog 标 `🔹 无Beat` 或 `🚧 待写` ### 步骤 2：Beat → Bible 反向同步 @@ -96,10 +97,11 @@ description: Use when processing inbox files, archiving eureka notes, updating b 叙事时间线状态含义： - `✅` 已落地：bible 与 beat 双向一致 -- `🔹` 无Beat：bible 有、beat 未承载 +- `🔹` 无Beat：bible 有、beat 未承载或 beat 为 backlog - `🆕` 仅Beat：beat 有揭示、bible 未记录 - `⚠️` 有出入：双方内容/粒度不一致 - `🚧` 草稿：beat 为 draft 状态 +- `🚧` 待写：beat 为 backlog 状态（需存在但尚未落稿） ### 步骤 3：标记不确定处 @@ -163,6 +165,11 @@ git commit -m "inbox: 处理并归档 {文件名}，更新 {涉及实体}" --- +## 信息边界（Bible vs Beat） + +- **Beat**：游戏内事件信息（场景、发生什么、玩家经历、信息在哪里揭示）；叙事时间线由 beat 驱动，AI 同步，人不手动维护事件性内容。 +- **Bible**：事件之外的信息（角色是谁、设定规则、跨叙事静态事实）；不人工维护动态/事件性内容。索引或时间线遇到需新建 beat 时即建 beat，标 `backlog`。 + ## 约束（任何情况下均适用） - **不自行解决冲突**：记录两版 + 来源，等人裁决 diff --git a/AGENTS.md b/AGENTS.md index cc7be09..7d10964 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -59,6 +59,12 @@ Templater 语法对应：`<% await tp.system.prompt("提示", "默认值") %>` 修改 `template/` 下任意 tpl-*.md 后，需同步到 `kb/template/`，保证 Obsidian 内 Templater 使用最新版本。 +## Bible 可读性与结构（自然语言优先） + +- **开篇必读**：正文最前用「一句话」+「自然语言介绍」让人和 AI 快速抓意图；假设读者不知道该概念，用 2～5 段连贯文字说明「是什么、在剧情里起什么作用、和谁相关」，用 [[wikilink]] 关联角色与设定。 +- **详情可折叠**：权威设定（定义、流程、时间线、实体关系网）、待确认/冲突、变更日志/来源索引可放在 Obsidian 折叠块（`> [!abstract]- 标题` 等）中，需要时再展开；或保留在 YAML 中供机器用。 +- **模板**：新建/大改 bible 时以 `template/tpl-worldbuilding.md`、`template/tpl-character.md` 为参考；两者已同步到 `kb/template/` 供 Templater 使用。 + ## Bible 命名约定 - **条目与文件名均使用中文**：与条目标题/主名一致，如 `佩佩.md`、`火山.md`、`主脑.md`、`原型.md`；不含空格，多词可用短横线，如 `世界观-年表.md` @@ -80,12 +86,17 @@ Templater 语法对应：`<% await tp.system.prompt("提示", "默认值") %>` - **以内容为核心**：场景+事件（如 诊室门口-年审公布）、角色+情境（如 佩佩-维修1）、梦境（如 梦-海边） - 类型（beat_type）放 frontmatter，命名无需重复 -## 角色与设定关联：Wikilink + Backlink +## Bible 与 Beat 的信息边界 -- **不再维护**：beat 的 YAML 字段 `characters`、`terms`，以及 bible（角色/设定）的 `related_characters`、`related_worldbuilding`。这些字段不再作为权威来源，无需与正文双向同步。 -- **做法**：在正文中通过 **wikilink**（`[[角色名]]`、`[[设定名]]`）引用角色与设定；在 bible 或 base 中通过 **Obsidian 反向链接（backlink）** 查看「哪些笔记引用了本条目」。 -- **Beat**：可在正文中设「本片涉及」等小节，用 wikilink 列出本片涉及的角色与设定，便于 backlink 聚合。 -- **Bible**：在 SSOT、实体关系网等正文处用 wikilink 引用相关角色与设定即可，无需在 frontmatter 重复维护列表。 +- **Beat 维护**：游戏内的事件信息——在哪个场景发生了什么、玩家经历了什么、什么信息在哪里被揭示。 +- **Bible 维护**：事件之外的信息——角色是谁、设定规则、跨叙事的静态事实。 + +**推论**： + +- 叙事时间线留在 bible 作为聚合视图，但内容完全由 beats 驱动；AI 处理 beat 时自动同步，人不手动维护。 +- Bible 里不应出现人工维护的动态/事件性内容。 + +**索引与新建 Beat**：在来源索引或叙事时间线中遇到需要新建 beat 的情况时，创建新 beat 并设 `status: backlog`（待写稿）；若已有具体 Fiction 草稿则用 `draft`。 ## Bible 来源索引 @@ -106,10 +117,13 @@ Templater 语法对应：`<% await tp.system.prompt("提示", "默认值") %>` - 表格有行但 beat 不存在 → 保持 `🔹 无Beat` - beat 存在但表格无行 → 新增行，标 `🆕 仅Beat` - 双方都有但内容/粒度不一致 → 标 `⚠️ 有出入`，在冲突记录或待确认中说明差异 - - （角色/设定与 beat 的关联以正文 wikilink 为准，不维护 beat 的 characters/terms 或 bible 的 related_*） 2. **Beat → SSOT 反向补全**：检查每个 beat 的 YAML `reveals` 字段，若揭示了角色/设定的事实性信息但 bible SSOT 区未记录，标注待补并列入摘要 3. 校验角色状态在节拍间是否连续（弧线追踪） 4. 校验世界观设定在各 bible 间是否一致 5. 校验节拍叙事前置条件是否满足 6. 汇报所有 `[#TBD]`、`[#Retcon]`、`[#LogicHole]` 项 7. 检查揭示路径是否与实际节拍顺序一致 + +## Diff 影响检查 + +当被要求检查**当前修改（diff）**对 bible/beat 的影响时，按 **`.cursor/skills/diff-impact-check/SKILL.md`** 执行：获取指定文件或全量 `kb/bible`、`kb/beats` 的 diff，沿 wikilink 与 backlink 查关联内容，对比事实性表述（如 SSOT 与 beat Fiction/reveals），输出《Diff 影响报告》并标出潜在冲突（例如一处写「有人见过海」、bible 写「从来没人见过海」）。可指定检查某些文件的 diff，或检查所有 bible 与 beat 的未提交/已暂存变更。命令说明见 `.cursor/COMMAND-diff-impact-check.md`。