---
title: 冲突裁决与决策记录（只追加，不改历史条目）
source_status: 汇编自 knowledge/governance/conflicts-and-open-questions.json 与 docs/sql-agent-design.md 决策记录
---

# 冲突裁决与决策记录

本文件只追加。新增决策写在对应表格末尾并带日期；已确认的历史条目不得回改或删除，
后续如果推翻旧决策，新增一条记录说明"取代了哪条"，而不是编辑旧条目。

## 已裁决冲突

| 主题 | 数仓开发规范说法 | 分析师/Agent 规则 | 裁决 |
|---|---|---|---|
| ADS 前缀 | `ads_ds_`、`ads_bi_`、`ads_iBigdata_` | `ads_analyze_` + `ds`/`bi`/`ibigdata` | 本 Agent 场景用分析师规则 |
| MID 前缀 | `mid_` | `mid_analyze_` | 本 Agent 场景用分析师规则 |
| 计数后缀语义 | `times`=非去重，`cnt`=去重 | `cnt`=非去重，`num`=去重 | 分析师产出统一用分析师标准 |
| 分区谓词范围 | 文档字面写"禁止全表扫描" | 用户确认：只有分区表需要分区谓词，非分区表允许全表扫描 | 用用户确认规则 |

## 已确认问题（带日期）

| 日期 | 主题 | 结论 |
|---|---|---|
| 2026-07-21 | 生产 SQL 自动执行 | 第一阶段不自动执行，由用户在 WeData 人工运行 |
| 2026-07-21 | 元数据采集范围 | 按需逐表查询，不做全量 DDL 采集 |
| 2026-07-21 | 数据库范围 | 只用 `wanshifu_dw`，排除 `wanshifu_enterprise` |
| 2026-07-21 | ODS 新旧套选择 | 新旧套同时存在时优先 `_v` |
| 2026-07-22 | 周表 `stat_date` 语义 | 不设默认值；生成部署脚本前必须询问用户是周起始/周结束/其他业务日期 |
| 2026-07-22 | MID 依赖 | MID 不能依赖另一个 MID |
| 2026-07-22 | 业务时间分区缺少范围 | 必须询问用户，不自动查近三年 |
| 2026-07-24 | 元数据访问权限 | 改用受限专用密钥，正式环境只开放所需只读元数据接口；提示词/Skill 层禁止规则不作为权限边界 |
| 2026-07-24 | 表字段就绪校验范围 | 必须同时检查普通字段和 `PARTITIONED BY` 分区字段，禁止把已存在的分区字段误报为待接入 |
| 2026-07-27 | 中文 SQL 常量编码故障 | 两次真实查询证明 JDBC/Kyuubi 链路可能使中文常量失真；诊断和降级规则见 [sql-rules.md](sql-rules.md) |

## 待确认问题

- 分区语义证据优先级的建议顺序（`verified_table_level_knowledge` > `verified_job_code` > DDL 分区定义和注释 > 表名推断 > 询问用户）尚待正式确认。
- 是否每个物理临时表在成功和重跑两种场景下都必须执行 DROP 清理，尚待确认。
- 公司 Agent 平台的 Skill/Tool/状态存储协议尚未定稿。
- SQL 开发规范的正式内容（除已提炼部分外）尚未完整获取。
- 指标口径来源和版本管理方式尚未定稿。
- 多轮会话状态保存周期尚未定稿。
- 未来 WeData 只读执行器的权限、审批和资源限制尚未定稿。

## 原始规范文档指针（未内嵌全文）

| 文档 | 版本 | 生效日期 | 角色 |
|---|---|---|---|
| 数据分析师_商业分析师数仓开发规范.md | 2.0.0 | 2026-06-02 | 分析师主规范 |
| 万师傅数仓开发规范.md | 1.5.0 | 2026-06-01 | 数仓设计学习参考 |
| 万师傅数仓现状_订单数据架构.md | — | — | 订单域参考 |

## 相关

- 规则本体见 [warehouse.md](warehouse.md)、[sql-rules.md](sql-rules.md)、[business.md](business.md)。