| 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
| 任务 | Sub-Skill 路径 | 写入目标 |
|---|
| 建词典骨架（编码注册 + 业务术语） | sub/01-build-glossary.md | 词典「编码注册 / 业务术语」节 |
| 登记字段词条 + 枚举（核心） | sub/02-field-entry.md ⬅ 核心 | 词典「字段词条 / 枚举」节 |
| 校验三方 ⊆ 词典 + 出报告 | sub/03-glossary-review.md | 验证报告 + 联动矩阵 |
第三步（可选）：参考模板
| 模板 | 用途 |
|---|
templates/glossary.md | 词典四类词条骨架（直接套用） |
⚠️ 闭环工作流（必须遵循）
[阶段1] 生成（四类词条：业务术语 → 字段 → 枚举 → 编码注册）
↓
[阶段2] 验证（执行 18 项检查清单）
↓ 有失败项？
[阶段3] 修复（按 08-glossary.md §九 修复优先级）
↓
[阶段4] 复验（全部 18 项通过）→ ✅ DONE
执行规则
| 规则 | 说明 |
|---|
| 唯一性优先 | GL-B 一名多义 / 一义多名为最高优先级，先修 |
| 验证范围 | 执行 standards/08-glossary.md §七 全部 18 项（GL-A/B/C/X 组） |
| 锚点化校验 | GL-X 校验 DB/接口字段英文名 ⊆ 词典、spec 字段中文名 ⊆ 词典、枚举/编码 ⊆ 词典 |
| 文档外字段 | 发现「文档有、词典无」优先补词典，不删文档字段 |
| 暂挂项 | 缺调研无法定名写 【待定名：{候选}】，标「Pending」，不算失败 |
跨文档一致性检查（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 不在词典中（词典外字段）
状态：❌ 需修复后继续
操作入口（完整闭环）
| 任务 | 使用方式 |
|---|
| 初始化词典结构 | 在对话中说「初始化 {项目名} 术语字段词典」 |
| 生成 / 登记词条 | 使用 .github/prompts/create-glossary.prompt.md |
| 校验三方 ⊆ 词典 | 使用 .github/prompts/validate-glossary.prompt.md |
| 查阅完整规范 | 读取 .github/standards/08-glossary.md |
产出位置
docs/glossary/
└── GLOSSARY_{项目}.md
输出后必答
- 使用 Skill：cross-glossary
- 参考规范：standards/08-glossary.md
- 字段词条数 / 枚举组数 / 编码数
- 词典外字段告警（如有）
- 词典路径
