Files
the-silent-gods-hearthfire/07_模板与规范/仓库协作规范.md
T

2.1 KiB

仓库协作规范

事实源顺序

发生冲突时按以下顺序处理,并在 Story Bible 记录决定:

  1. story-bible.md 的已定决策与决策日志;
  2. 对应角色卡、世界设定、故事大纲;
  3. 小说正文中已发布的事实;
  4. 动画改编与视觉圣经;
  5. 分镜、提示词及生产素材。

下游可以为媒介效果改编表达,但不能静默推翻上游因果和人物动机。

分支与提交

  • main:可继续创作和生产的稳定状态。
  • 分支:story/主题、character/角色、world/设定、anime/集或场次、asset/资产、fix/问题。
  • 提交:类型(范围): 摘要。
  • 常用类型:story、character、world、anime、asset、docs、fix、chore。
  • 一个提交只解决一个可说明的问题;不要把设定修改、批量资产和缓存混成一次提交。

文件命名

  • 文档目录允许中文,生产资产使用稳定的 ASCII ID。
  • 集/场/镜统一为 S01E01_SC12_SH001_v001;剧本文本场号 01-12 映射到 S01E01_SC12。
  • 角色:CHR-时代-角色-年龄或状态-版本-视图。
  • 场景沿用已建 ENV-S1-01 等登记ID,文件另加时间天气与版本;不再建立平行LOC编号。
  • 道具沿用已建 PROP-S1-01 等登记ID,文件另加状态与版本;不再建立平行PRP编号。
  • 状态后缀:WIP、REVIEW、APPROVED、LOCKED、ARCHIVED。

版本与归档

  • 小改动依赖 Git,不复制 最终版2_真的最终版。
  • 只有必须并行比较的重大稿次才在文件名中保留版本号。
  • 被替代但具有生产追溯价值的材料移入同阶段的 99_归档。
  • 正式发布使用语义化版本:v主版本.次版本.修订号。

提交前检查

  • Markdown 链接可用,文件编码为 UTF-8。
  • 没有 .env、密钥、缓存、代理和自动保存文件。
  • 当前远程未启用 Git LFS;提交前检查二进制体积,超大工程与中间素材放入外部存储并在仓库记录清单。
  • 新设定已同步到事实源,改动既定决策已写入 Story Bible。
  • 动画资产可追溯到集、场、镜和资产版本。