cross-glossary

name: cross-glossary description: > 术语 / 字段词典技能 — 为一个项目/模块建立统一语言（Ubiquitous Language）中央词典： 字段中文名↔英文名↔类型单一映射、枚举/状态码统一取值、领域码/模块码/系统简码全局登记。 作为 spec / 数据库 / 接口字段对齐的中央锚点，把字段对不齐从「评审时发现」提前到「设计时杜绝」。 USE FOR: 建立/维护术语字段词典；登记新字段的标准中英文名与类型；统一枚举状态码取值； 登记领域码/模块码/系统简码；校验 spec/DB/接口字段是否都在词典中（词典外字段告警）。 DO NOT USE FOR: 生成 spec/DB/接口本身（用对应 create skill）； 集成评分评审（用 cross/design-review/SKILL.md）。 tools: - create_file - read_file - replace_string_in_file

术语 / 字段词典规范（wl-skills-design）

本 Skill 产出字段对齐的中央锚点：一份覆盖全链路的统一词典。 spec / DB / 接口生成时先查词典取标准名；评审时各产物与词典比对（而非两两互比）。

⚠️ 首先必读：词典的定位

词典是锚点，不是又一份要对齐的文档。原则：

• 文档有、词典无 → 优先补词典（说明是新概念），不要删文档字段
• 文档与词典冲突 → 以词典为准，强制修正文档
• 新增字段 → 先查词典；词典无则先登记词典再在文档里用

第一步（必须）：加载规范

.github/standards/08-glossary.md

唯一权威来源，包含：四类词条（业务术语/字段/枚举/编码注册）、字段词条 9 列标准格式、枚举与编码注册规则、与 spec/DB/接口的联动（G1~G5）、对既有校验的锚点化增强、验证清单（18 项）、闭环修复协议。不读规范，不执行任何生成操作。

第二步：识别任务类型，加载对应 Sub-Skill

第三步（可选）：参考模板

空白模板 vs 真实样例：templates/glossary.md 是空白起点； examples/01-glossary.md 是真实样例（质量标杆）——订单+计划域的完整词典， 四类词条齐全、含联动矩阵，生成结果须对照样例自检且不低于它。

⚠️ 闭环工作流（必须遵循）

[阶段1] 生成（四类词条：业务术语 → 字段 → 枚举 → 编码注册）
      ↓
[阶段2] 验证（执行 18 项检查清单）
      ↓ 有失败项？
[阶段3] 修复（按 08-glossary.md §九 修复优先级）
      ↓
[阶段4] 复验（全部 18 项通过）→ ✅ DONE

执行规则

跨文档一致性检查（GL-X 组）

按 08-glossary.md §八 构建集合并比对：

SET_GLO_FLD_EN = { 词典字段英文名 }
SET_GLO_FLD_CN = { 词典字段中文名 }
SET_DB_FLD_EN  = { DB 数据字典字段英文名 }
SET_IF_FLD_EN  = { 接口报文字段英文名 }
SET_SPEC_FLD_CN= { spec IPO 需持久化字段中文名 }

X01：SET_DB_FLD_EN  ⊆ SET_GLO_FLD_EN
X02：SET_IF_FLD_EN  ⊆ SET_GLO_FLD_EN
X03：SET_SPEC_FLD_CN ⊆ SET_GLO_FLD_CN

验证报告格式（每次验证后必须输出）

术语字段词典验证报告 — [项目/分册名]
字段词条数：N | 枚举组数：M | 编码数：K
总项数：18 | 通过：N | 失败：M | 暂挂：K
失败项：
  [B01] 英文名 orderNo 同时映射「订单号」与「工单号」（一名多义）
  [X01] DB 字段 packWt 不在词典中（词典外字段）
状态：❌ 需修复后继续

操作入口（完整闭环）

产出位置

docs/glossary/
└── GLOSSARY_{项目}.md

输出后必答

• 使用 Skill：cross-glossary
• 参考规范：standards/08-glossary.md
• 字段词条数 / 枚举组数 / 编码数
• 词典外字段告警（如有）
• 词典路径