| name | canon-ingest |
| description | 整理原作资料、角色设定、时间线和跨作兼容规则,建立 canon contract。 |
canon-ingest
作用
将原作资料、用户整理、设定摘录和已知 AU 约束,整理为 canon-contract 与项目级规则文件。对于 crossover,额外建立规则接触面与冲突矩阵。
何时使用
- 项目初始化后,准备正式规划剧情前
- 引入新作品 / 新角色 / 新力量体系时
- 发现大纲或正文开始出现设定漂移时
预期输入
- 用户提供的原作摘要、人物卡、时间线笔记
- 已有
story-bible/* 文件
- 任何 crossover 说明或 AU 偏离说明
- 必要时用户明确授权的外部资料整理
预期输出
- 更新后的
story-bible/canon-contract.md
story-bible/power-system-rules.md
story-bible/character-bible.md 中的角色基础约束
- 时间线锚点和 open questions
执行流程
- 先读取现有
canon-contract、power-system-rules、divergence-log,确定哪些事实已存在,避免重复与冲突。
- 把所有输入事实按
hard / soft / inferred / unverified / divergence 分层记录。
- 若存在 crossover,生成冲突列表:力量来源、术语映射、可感知性、代价、上限、世界边界、信息差。
- 把时间线关键节点写入
Timeline Anchors,并标记哪些锚点来自原作、哪些来自 AU 调整。
- 对尚无法确定的部分写入
Open Questions,不要强行补全。
- 若发现重大设定冲突,直接在结果中标红并建议
human_checkpoint。
硬规则
- 不能把 fanon 或个人印象伪装成 hard canon。
- 不能因写作方便而省略代价、边界或例外。
- Crossover 不能只写“兼容”,必须写兼容机制。
- 任何偏离原作基石的改动都要写入
divergence-log。
人类检查点
若核心原作事实存在争议、AU 改动将改变作品根基、或 crossover 无法在规则上自洽,应强烈建议人工确认。
恢复与续跑
写入时优先增量更新,不重排全部文档。完成后同步 compact/accepted_truths.md 的规则摘要,并把未决项写入 story-bible/canon-contract.md。
返回格式
返回:1) 已确认的 canon 层级;2) 高风险冲突;3) 待用户补充的 open questions;4) 建议下一步。
关键文件
- story-bible/canon-contract.md
- story-bible/power-system-rules.md
- story-bible/character-bible.md
- story-bible/divergence-log.md
- compact/accepted_truths.md
最小示例
- 把 Fate 圣杯战争机制和穿越者外挂代价写清
- 为月姬 × Guilty Gear 定义世界边界和术语映射