协作修改提交规范
一、统一提交模板
1.1 提交信息必填项
每次内容修改必须附带以下四项信息,缺一不可:
| 字段 | 说明 | 示例值 |
|---|---|---|
| 修改所属章节/设定ID | 标明修改涉及的章节编号或设定条目ID | ch42、set-luca-bg、set-mark-system |
| 修改类型 | 从以下五类中选择一个:AI重写 / 人设调整 / 设定修正 / 排版优化 / 剧情新增 | AI重写 |
| 修改理由 | 说明修改动机,关联具体规范条目或设定冲突描述 | 优化席琳对话节奏,原对话过于冗长 |
| 关联规范条目编号 | 引用本次修改所依据的规范条例编号 | ai-revision-spec §2 |
1.2 提交格式规范
所有提交信息统一使用以下格式,写入提交说明或变更日志:
标准格式:
[章节/设定ID][修改类型] 修改理由,关联 规范编号实际示例:
[ch42][AI重写] 优化席琳对话节奏,关联 ai-revision-spec §2 |
[set-mark-system][设定修正] 补充印记激活条件的温度限制,关联 writing-style-guide §3.1 |
[ch15][排版优化] 统一对话引号格式为中文全角,关联 upload-spec §4 |
[ch58][剧情新增] 新增卢卡与守卫对峙场景,关联 arc §2.3 |
[set-luca-bg][人设调整] 修正卢卡少年期时间线与卷二冲突,关联 version-control-spec §1 |
- 提交信息不得为空或仅写"更新""修改"等模糊描述。
- 多项修改合并提交时,每项修改单独列出,用分号
;分隔。
二、冲突处理条例
2.1 同时修改同一内容的处理流程
当两人同时修改同一章节或同一设定条目时,按以下流程处理:
比对提交时间戳
先到先得原则
先到先得原则
→
后提交者拉取最新版本
基于最新版本合并修改
基于最新版本合并修改
→
检查设定冲突
如有冲突,以设定负责人意见为准
如有冲突,以设定负责人意见为准
→
争议超24小时
由修订审核人仲裁裁决
由修订审核人仲裁裁决
- 时间戳先到先得:以系统记录的提交时间为准,先提交者的修改优先保留。
- 后提交者合并义务:后提交者必须基于先提交者的最新版本进行合并,不得覆盖先提交者的修改。
- 设定冲突裁决:若合并过程中发现设定冲突,以设定负责人的意见为最终裁决。
- 超时仲裁:双方争议超过 24 小时未解决时,自动升级至修订审核人仲裁,仲裁结果为最终决定。
2.2 冲突预防机制
- 章节锁定:开始编辑某章节时,在协作看板或群内声明「正在编辑 ch42」,其他人应避开该章节。
- 锁定有效期:单次锁定最长 48 小时,超时未提交则自动释放锁定。
- 设定库排他编辑:核心设定条目同一时间仅允许一人编辑,需先在协作群声明。
锁定声明格式:
🔒 [ch42] 张三 正在编辑,预计 2026-07-07 18:00 完成三、待办任务分配规范
3.1 任务分配四原则
规范补全、章节更新、设定完善等任务的分配遵循以下四项原则:
| 原则 | 具体要求 | 违规后果 |
|---|---|---|
| 认领制 | 公开待办列表于协作看板,成员主动认领任务,不强制分配。无人认领超过 72 小时的任务由设定负责人指派。 | 未被认领的任务不得自行消失,需持续追踪 |
| 截止日 | 每个任务必须有明确截止时间,写入任务描述。截止日由认领者与任务发起者协商确定。 | 无截止日的任务视为无效任务,不计入工作量 |
| 验收标准 | 完成标准必须在任务描述中列明,包括:格式要求、需通过的审核项、关联规范条目。 | 验收标准不明确的任务,执行者有权拒绝交付 |
| 逾期处理 | 逾期 48 小时的任务自动升级为「待审核」状态,由修订审核人介入评估是否需要重新分配或调整截止日。 | 连续逾期 2 次的成员,新任务认领需审核级成员担保 |
3.2 任务状态流转
待认领
(公开在看板)
(公开在看板)
→
进行中
(已认领,执行中)
(已认领,执行中)
→
待审核
(已提交,等待审核)
(已提交,等待审核)
→
已完成
(审核通过)
(审核通过)
状态回退路径:
- 「待审核」审核不通过 → 回退至「进行中」,附修订意见。
- 「进行中」逾期未完成 → 自动升级至「待审核」,由修订审核人介入。
- 任何任务可从「进行中」放弃 → 回退至「待认领」,需说明放弃原因。
四、注释沟通规范
4.1 页面内批注与留言格式
页面内批注和修订区留言统一使用以下格式,确保沟通高效可追溯:
| 格式 | 用途 | 示例 |
|---|---|---|
@人名 问题描述 | 定向通知特定成员,需包含具体问题描述 | @张三 ch42 第三段席琳的语气与前文不一致,请检查 |
[日期] 内容 | 时间戳留言,用于记录修改说明或非紧急反馈 | [2026-07-07] 已将对话引号统一为全角格式 |
4.2 沟通禁止事项
以下行为在协作沟通中严格禁止:
- 禁止无意义碎片化留言:如"看看这个""这里有问题""???"等不包含具体信息的留言。所有留言必须说明「什么问题」「在哪个位置」「建议如何处理」三要素中的至少两项。
- 禁止情绪化批注:对事不对人,批注中不得出现人身攻击或情绪宣泄。
- 禁止脱机沟通替代正式批注:私下讨论达成的修改共识,必须在页面内补录正式批注,确保可追溯。
❌ 错误示例:
✅ 正确示例:
这里不对✅ 正确示例:
@李四 ch42 第二段 席琳称呼卢卡为"哥哥",但 bible-characters 中设定两人无血缘关系,应改为直呼其名。关联 bible-characters §1.2