2.1 KiB
2.1 KiB
仓库协作规范
事实源顺序
发生冲突时按以下顺序处理,并在 Story Bible 记录决定:
story-bible.md的已定决策与决策日志;- 对应角色卡、世界设定、故事大纲;
- 小说正文中已发布的事实;
- 动画改编与视觉圣经;
- 分镜、提示词及生产素材。
下游可以为媒介效果改编表达,但不能静默推翻上游因果和人物动机。
分支与提交
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。
- 动画资产可追溯到集、场、镜和资产版本。