// **数据库设计技能** — 按照团队标准生成数据库设计（ER 图 / DB 清单 / 数据字典 / DDL）。 USE FOR: 设计数据库表结构、ER 图、实体关系；从需求说明书（spec）的 IPO 表推导数据表； 编写数据字典（10 列标准表）；生成 DDL 建表脚本（含系统字段、索引、注释）； 设计变更履历表（_log/_resume）；审查已有数据库设计是否符合规范。 DO NOT USE FOR: 接口设计（用 api/restful/SKILL.md）；需求说明书（用 requirements/spec/SKILL.md）； 流程图（用 requirements/flowchart/SKILL.md）。
**术语 / 字段词典技能** — 为一个项目/模块建立统一语言（Ubiquitous Language）中央词典： 字段中文名↔英文名↔类型单一映射、枚举/状态码统一取值、领域码/模块码/系统简码全局登记。 作为 spec / 数据库 / 接口字段对齐的中央锚点，把字段对不齐从「评审时发现」提前到「设计时杜绝」。 USE FOR: 建立/维护术语字段词典；登记新字段的标准中英文名与类型；统一枚举状态码取值； 登记领域码/模块码/系统简码；校验 spec/DB/接口字段是否都在词典中（词典外字段告警）。 DO NOT USE FOR: 生成 spec/DB/接口本身（用对应 create skill）； 集成评分评审（用 cross/design-review/SKILL.md）。
**设计集成评审技能** — 把需求设计（spec）、数据库设计（DB）、接口设计（IF）三份产物聚合成一份 量化评审报告：综合评分（4 等级）、P0/P1/P2 分级问题清单、spec→接口→表 追溯矩阵、跨文档联动校验、修复任务。 USE FOR: 对一个模块/分册做整体设计评审；检查需求/数据库/接口三份文档是否一致闭环； 生成评审报告 / 评分报告 / 设计质量报告；复评（修复后再评分）。 DO NOT USE FOR: 只评单一文档（DB 用 data/database/sub/04；接口用 api/restful/sub/04）； 生成设计本身（用对应的 create skill）。
**需求设计说明书编写技能** — 按照团队标准生成系统需求设计说明书（单模块卷）。 USE FOR: 生成需求设计说明书全文或任意章节；编写系统目标/组织架构/总体设计； 编写子模块流程清单/流程说明/活动说明表；编写功能 IPO 表（处理逻辑）； 生成报表设计说明；补全已有说明书的缺失章节。 DO NOT USE FOR: 流程图绘制（用 requirements/flowchart/SKILL.md）； 数据库设计、接口设计、代码设计。
**接口设计技能** — 按照团队标准生成接口设计（系统集成报文 + HTTP/RESTful）。 USE FOR: 设计系统集成接口（触发条件五要素 + 主档/明细档报文 + JSON 示例）； 设计 HTTP/RESTful 接口（URL/Method/状态码/统一响应包装）；从需求说明书（spec）功能编码推导接口清单； 设计错误码、安全方案、幂等重试；审查已有接口设计是否符合规范。 DO NOT USE FOR: 数据库设计（用 data/database/SKILL.md）；需求说明书（用 requirements/spec/SKILL.md）； 流程图（用 requirements/flowchart/SKILL.md）。
**流程图绘制规范技能** — 在 draw.io 中按照团队标准绘制业务流程图。 USE FOR: 创建任何业务流程图、系统流程图、泳道图；生成符合团队视觉规范的 .drawio XML； 需要色标、节点结构、编码规范时。 DO NOT USE FOR: 非流程类的架构图、UML 类图等。
| name | data-database-design |
| description | **数据库设计技能** — 按照团队标准生成数据库设计（ER 图 / DB 清单 / 数据字典 / DDL）。 USE FOR: 设计数据库表结构、ER 图、实体关系；从需求说明书（spec）的 IPO 表推导数据表； 编写数据字典（10 列标准表）；生成 DDL 建表脚本（含系统字段、索引、注释）； 设计变更履历表（_log/_resume）；审查已有数据库设计是否符合规范。 DO NOT USE FOR: 接口设计（用 api/restful/SKILL.md）；需求说明书（用 requirements/spec/SKILL.md）； 流程图（用 requirements/flowchart/SKILL.md）。 |
| tools | ["create_file","read_file","replace_string_in_file"] |
在生成任何内容之前，必须先明确输出文件结构。
读取 .github/skills/data/database/templates/db-skeleton.md，该文件定义：
.github/standards/03-database.md
该文件是唯一权威来源，包含：命名约定、7 个强制系统字段、主键与索引、文档结构、数据字典 10 列格式、变更设计、与 spec 联动、验证清单（30 项）。不读规范，不执行任何生成操作。
| 任务 | Sub-Skill 路径 | 写入目标 |
|---|---|---|
| 从 spec 推导实体、画 ER 图 | sub/01-erd.md | 模块文件「(1) ER 图」节 |
| 设计表字段、注入系统字段、对齐 spec 字段 | sub/02-table-design.md ⬅ 核心 | 模块文件「(2) DB 清单 + (3) 数据字典」节 |
| 生成 DDL 建表脚本 | sub/03-ddl.md | 模块文件「(4) DDL」节 |
| 审查 + 自动修复 + 出报告 | sub/04-db-review.md | 验证报告 |
| 模板 | 用途 |
|---|---|
templates/db-skeleton.md | 分册文件结构 + 每模块 4 节骨架 |
templates/data-dictionary.md | 数据字典 10 列标准表（直接套用） |
templates/table-definition.md | 单表完整定义示例（含系统字段 + 索引清单） |
所有内容生成必须遵循「生成 → 验证 → 修复 → 复验」四阶段循环，不允许跳过验证直接交付。
[阶段1] 生成（按模块逐节：ER → DB清单 → 数据字典 → DDL）
↓
[阶段2] 验证（执行 30 项检查清单）
↓ 有失败项？
[阶段3] 修复（按 03-database.md §十 修复优先级）
↓
[阶段4] 复验（全部 30 项通过）→ ✅ DONE
| 规则 | 说明 |
|---|---|
| 逐模块验证 | 完成一个模块（4 节完整）后立即验证，不等全分册生成完再统一验证 |
| 验证范围 | 执行 standards/03-database.md §八 中全部 30 项（DB-A/B/C/D/X 组） |
| 修复优先级 | DB-X（与 spec 联动）→ DB-B（系统字段）→ DB-C（索引）→ DB-A（命名）→ DB-D（文档） |
| 系统字段强制 | 每张业务表必须注入 7 个系统字段（§二），缺一即失败 |
| 暂挂项 | 缺调研数据时写 【待补充：{描述}】，标注「Pending」，不算失败 |
完成每个模块后，按 03-database.md §九 构建集合并比对：
SET_SPEC_OUT = { spec IPO Output 涉及的持久化对象 }
SET_DB_TABLE = { 本分册业务表实体 }
SET_SPEC_FLD = { spec IPO 需持久化字段 }
SET_DB_FLD = { DB 数据字典所有字段 }
X01：SET_SPEC_OUT ⊆ SET_DB_TABLE
X02：SET_SPEC_FLD ⊆ SET_DB_FLD（按中文名匹配）
X05：联动矩阵行数 == |SET_SPEC_FLD|
数据库设计验证报告 — [模块名]
总项数：30 | 通过：N | 失败：M | 暂挂：K
失败项：
[B04] pmom_order_main 缺少 deletedFlag 字段
[X03] orderNo 中文名与 spec IPO 不一致
状态：❌ 需修复后继续
| 任务 | 使用方式 |
|---|---|
| 初始化分册结构 | 在对话中说「初始化 {模块名} 数据库设计结构」 |
| 生成并写入指定模块/表 | 使用 .github/prompts/create-db-design.prompt.md |
| 验证已有设计 | 使用 .github/prompts/validate-db-design.prompt.md |
| 查阅完整规范 | 读取 .github/standards/03-database.md |