kb-management

知识库管理

知识库（kb/）是项目的持久记忆。每个 Agent 都会从中读取上下文。本技能介绍如何妥善维护知识库。

层级

正典：故事已确立的事实。章节一经发布或定稿，其中确立的事实便成为正典。与正典矛盾会破坏读者的信任。

维基：综合整理的参考页面，例如魔法系统的运作方式、角色关系、派系政治。这些文档会随着故事发展不断更新。

风格：根据文本样本整理的风格参考文件。写作者 Agent 和评论者 Agent 依赖这些文件保持风格一致。

词汇表：正典故事术语、别名和排除项。项目级术语存放在 kb/vocab.md；领域术语存放在其所属领域目录中，例如 kb/world/vocab.md。

问题：跨多个章节追踪的写作问题（反复出现的表达习惯、节奏模式、连续性错误）。请参阅故事记忆技能。

页面约定

每份文档只讲一个概念

每份文档只涵盖一个连贯主题：一个角色、一处地点或一个系统。如果一份文档涵盖两个无关主题，就将其拆分。如果两份文档从不同角度解释同一件事，就将其合并或相互引用。

文件名应体现其描述的内容（fire-magic.md、protagonist.md），而不是编写时间（session-3-notes.md）。

组织结构

kb/
  characters/
    <name>.md              # one file per character
  vocab.md                 # project-wide canonical terms
  world/
    vocab.md               # worldbuilding terms when needed
    <topic>.md             # locations, factions, systems
    <domain>/
      vocab.md             # subdomain terms when needed
      <topic>.md           # nest when a domain has many pages
  timeline/
    <arc-or-period>.md     # chronological entries
  canon/
    <chapter-or-arc>.md    # hard facts per chapter/arc
  styles/
    <style-name>.md        # voice reference files
  issues/
    <issue-name>.md        # tracked writing problems

项目的 AGENTS.md 可能会对此进行自定义。请先阅读。

链接

使用相对路径链接到相关页面。通过交叉引用而非重复内容来确保每个概念只有一个权威来源。例如，角色页面应链接到其住所对应的地点页面、其故事线对应的时间线条目等。

可读性

撰写能够独立阅读的页面：

• 内容完整：提供足够的上下文，让读者无需先阅读其他三份页面
• 便于浏览：使用标题、项目符号和表格。术语首次出现时加粗。
• 具体明确：提供具体引文、章节引用和场景出处
• 保持最新：当故事推翻或扩展现有内容时及时更新

词汇表页面

当术语对多个 Agent 都很重要时，请使用词汇表页面：魔法名称、派系标签、地名、头衔、关系标签、虚构词汇、反复出现的世界内短语，以及具有项目特定含义的类型术语。

每个词条应包含：

• 规范名称：Agent 应使用的形式
• 定义：用一至三句话说明；若可能产生歧义，还应说明该术语不代表什么
• 别名：作者、角色、草稿或旧版 kb 页面实际使用过的名称
• 来源：该用法确立或决定的出处

尽早解决冲突。如果两个术语似乎指向同一事物，请与作者确定规范形式，或在报告中标记，而不是默默地将两者都保留下来。

何时新建或更新

当一个概念已经明确到足以供其他 Agent 引用时，新建页面。仍处于故事规划阶段的内容不应创建页面。

当新章节确立了相关事实、作者做出的决定改变了相关内容，或页面已过时时，更新现有页面。

当页面超过约 200 行，或涵盖多个无关概念时，拆分页面。

知识库与工作区的内容划分

• 已定稿的知识 → kb/
• 草稿迭代、头脑风暴记录、评论报告 → work/
• 草稿完成后提炼出的事实 → kb/canon/ 或相关维基页面

使用 /story-memory 从已完成的章节中常规提取事实。直接编辑 kb，仅供作者或 muse 在交互过程中记录决定时使用。