M03 STD-Z 冲突裁决自动化规范

文件编号：MASTER-RULE-ANNEX-Z-001
版本：V1.0.0 ｜ 发布日期：2026-08-29 ｜ 状态：附属工具文档（STD-Z-002 扩展模式，不改母规则正文）
上位基准：《MASTER RULE · 技术标准成文规范》V1.0.1（STD-Z 组 7 条款）
裁决器：~/.workbuddy/_tools/conflict_arbiter.py
冲突记录：~/.workbuddy/_tools/conflicts/conflict_log.jsonl（追加式，可回滚）

1 目的与范围

将自检清单中标注 [MANUAL] 的 STD-Z 冲突裁决流程（Z1/Z2/Z3）自动化，消除「新规则与母规则是否冲突」对人工语义判断的依赖，使裁决结果可追踪、可回滚。

适用对象：拟新增/修订的技术标准、规范、范式、SOP 类文档中的规则条款（编号 R、STD-、或自定编号）。

2 裁决触发条件

3 冲突判定规则（四类）

3.1 结构冲突（C1）

定义：新规则 R 与母规则条款 S 存在「覆盖 / 替代 / 以本条为准」表述，且未走 STD-Z-004 升版流程。

判定式：R.text ∈ /覆盖|替代|以本条为准|推翻/ 且 ∄ 升版记录 → 冲突

3.2 语义冲突（C2）

定义：R 与 S 管辖同一成文对象（命名/章节/模态词/引用/附录/排版）但要求相反。

判定式：R.topic == S.topic 且 R.polarity ≠ S.polarity → 冲突

（polarity：必须/禁止 为强极性，应/宜/可 为弱极性；强 vs 弱、正 vs 反 均视为极性不同）

3.3 阈值冲突（C3）

定义：R 的量化阈值放宽了 S 的既有阈值（STD-Z-002「阈值不得放宽」）。

判定式：R.threshold < S.threshold（同方向比较，如达成率）或 R.threshold > S.threshold（反向比较，如误差率） → 冲突

放宽识别表：

3.4 词法冲突（C4）

定义：R 使用母规则 STD-D-008 黑名单词（原则上/按惯例/视情况/适当/酌情/等等/若干）或表外模态词（务必/一定要/尽量/最好），且处于非引述语境。

判定式：R.text ∩ 黑名单 ≠ ∅ 且 ∄ 引述豁免标记（STD-D-011 60 字窗口） → 冲突

4 默认策略（歧义时退回）

5 冲突记录输出格式（JSONL，可回滚）

每条冲突/裁决记录为 JSON 单行，追加写入 conflict_log.jsonl：

{
  "seq": 1,
  "ts": "2026-08-29T04:15:00+08:00",
  "trigger": "T1",
  "rule": {"id": "R20", "text": "文件流转时限按惯例 3 天", "topic": "时限", "threshold": null},
  "clauses": [{"id": "STD-C-005", "text": "禁止出现「按惯例」等无锚点表述", "threshold": null}],
  "conflicts": [{"type": "C4", "detail": "命中黑名单词「按惯例」，无引述豁免标记"}],
  "verdict": "REJECT",
  "strategy": "STD-Z-001 母规则优先",
  "rollback": {"undo": "拒绝登记，R20 未入库", "redo": "删除登记即可回滚"},
  "reviewer": null
}

字段说明：

可回滚机制：
- 每条记录独立一行，删除对应 seq 行即撤销该裁决；
- REJECT 记录回滚 = 重新允许登记（redo 描述）；
- 文件为追加式（append-only），不覆盖历史；每季度归档轮转。

6 裁决器 CLI（conflict_arbiter.py）

python conflict_arbiter.py check --rule "R20: 文件流转时限按惯例 3 天" --topic 时限
# 输出：裁决结论 + 命中条款 + 默认策略 + JSONL 记录号

python conflict_arbiter.py check --rule-file rules.json     # 批量裁决
python conflict_arbiter.py log --tail 10                     # 查看最近记录
python conflict_arbiter.py log --seq 3 --rollback            # 回滚某条裁决

退出码：0 = PASS；1 = REJECT（存在冲突）；2 = NEED_REVIEW（无法判定）；3 = 参数错误。

7 验收标准

8 修订记录

9 标准评审机制

本文件为母规则附属工具文档，随母规则升版周期同步评审。评审周期 ≤ 12 个月，发起主体为全域文件治理工作组。评审要点：冲突判定规则是否覆盖新增冲突形态、JSONL 格式是否满足追踪需求、裁决器基准表（BASE_THRESHOLDS）是否与母规则阈值同步。

10 定稿校核结论

本文件为裁决自动化规范附属文档，技术内容已达定稿条件。发布前未闭环行政事项：审核与批准签字（见 §11 审批记录，待定）。裁决器 conflict_arbiter.py 已实现并通过七组自测（C1/C2/C3/C4 冲突命中、扩展放行、引述豁免、JSONL 落盘与回滚）。

11 审批记录