规范页面维护协作规则
一、新增规范条目编写模板
规则 1
每条规范必须包含完整结构
新增规范条目时,必须包含以下六个必备部分:
| 部分 | 说明 | 必填 |
|---|---|---|
| 目的 | 为什么需要这条规范,解决什么问题 | 必填 |
| 适用范围 | 谁/哪些内容受此规范约束 | 必填 |
| 约束细则 | 具体条款,逐条列出必须遵守的规则 | 必填 |
| 违规后果 | 违反后的处理方式和严重程度 | 必填 |
| 示例 | 正面和反面案例各至少一个 | 必填 |
| 关联条例 | 引用的其他规范条目编号 | 必填 |
模板示例:
### 规则 N:规则标题 **目的**:确保……避免…… **适用范围**:所有AI辅助生成的章节内容 **约束细则**: 1. 必须…… 2. 禁止…… 3. 应当…… **违规后果**:轻度违规,退回修改(参见 violation-spec §轻度) **示例**: - 正确做法:…… - 错误做法:…… **关联条例**:ai-output-spec §1, version-number-spec §3
二、规范修改审核流程
规则 2
修改后必须执行的同步操作
新增或修改规范条例后,必须依次完成以下操作:
- 更新全站引用链接:搜索全站所有引用该条例的页面,逐一检查并更新链接
- 检查锚点有效性:确认所有指向该条例的锚点跳转正常,无404或错位
- 更新 standards.html 日志:在修订变更Tab中记录本次修改详情
- 通知相关人员:通过协作渠道通知所有受影响的协作成员
以上四项操作全部完成后,修改方可视为生效。遗漏任一步骤视为中度违规。
修改审核清单示例:
修改内容:char-creation-spec §3 新增"角色语言风格"子条目 影响页面:ai-output-spec(引用§3)、publish-check-spec(引用§3) 操作步骤: ☑ 更新 ai-output-spec.html 中的链接文本 ☑ 更新 publish-check-spec.html 中的校验描述 ☑ 测试所有锚点跳转正常 ☑ 更新 standards.html 修订日志 ☑ 通知协作成员(张三、李四)
三、条例锚点命名标准
规则 3
锚点ID强制使用英文小写+连字符
为确保跨页面跳转稳定可靠,所有条例锚点ID必须严格遵守以下命名规则:
- 只允许使用英文小写字母、数字和连字符(
-) - 禁止使用中文字符作为锚点ID
- 禁止使用空格(用连字符替代)
- 禁止使用特殊符号(如
#、@、_、.) - 锚点ID应能反映条目内容的语义,便于理解
正确示例:
id="ai-prompt-layer-structure"✓id="char-voice-style-rules"✓id="version-change-log-fields"✓
id="AI提示词结构"✗ 含中文id="ai prompt layer"✗ 含空格id="ai_prompt_layer"✗ 含下划线id="AI.Prompt.Layer"✗ 含大写字母和特殊符号