/data-architecture

name: data-architecture
description: 数据架构专家 Owner — 当任务涉及数据模型、Schema、迁移、索引、查询、生命周期、数据质量、派生指标、分析消费者、跨环境数据或持久化状态时使用；要求把数据结构、演进和消费链设计清楚。

Data Architecture Skill

定位

本 Skill 负责数据架构 Owner 视角。它关注数据如何建模、迁移、查询、维护质量、被谁消费，以及生命周期如何闭环。

触发条件

| 场景 | 是否触发 | |------|:--------:| | 数据模型、Schema、migration、索引、查询、缓存、持久化状态、派生指标 | 必须 | | 涉及跨环境数据补齐、导入导出、数据质量、保留策略或分析消费者 | 必须 | | 修改 Profile、台账、报告字段或运行态状态结构 | 必须 | | 纯静态文案或无状态计算 | N/A + skipReason |

核心门禁

| Gate | 要求 | 证据 | |------|------|------| | `DataArchitectureGate` | 数据模型、迁移、索引、生命周期、质量和消费者必须成矩阵 | dataModel、schemaMigration | | `DataModelBoundaryGate` | 业务实体、关系、字段、约束和稳定键必须明确 | dataModel | | `MigrationSafetyGate` | 迁移、回滚、dry-run、重复/缺失处理必须可验证 | schemaMigration | | `QueryIndexGate` | 查询路径、索引、分页和性能边界必须说明 | queryIndexPlan | | `DataQualityLifecycleGate` | 数据质量、保留、清理、派生消费者必须明确 | dataQuality、lifecycleRetention |

执行步骤

1. 建立数据模型和消费者清单。 2. 确定稳定业务键、唯一性、关系、生命周期和保留策略。 3. 设计迁移路线、dry-run、回滚和缺失/重复清单。 4. 评估查询、索引、分页、缓存和性能。 5. 绑定数据质量、派生指标、分析消费者和验证证据。

输出字段

## DataArchitectureGate

| 字段 | 内容 |
|------|------|
| dataModel | 实体、关系、字段、约束、稳定键 |
| schemaMigration | 迁移、dry-run、回滚、缺失/重复处理 |
| queryIndexPlan | 查询路径、索引、分页、性能边界 |
| lifecycleRetention | 生命周期、保留、清理、归档 |
| dataQuality | 完整性、一致性、重复、异常数据策略 |
| analyticsConsumer | 派生指标、报表、日志、消费者影响 |
| evidenceMatrix | 判断 -> schema / migration / query / tests / samples / docs |

反模式

| 反模式 | 修正 | |--------|------| | 直接使用源环境 `_id` 写目标环境 | 用稳定业务键或显式映射清单 | | 只改字段不评估消费者 | 列 analyticsConsumer 和 derived consumer | | 无 dry-run 的数据迁移 | 补范围、预览、缺失/重复、回滚 | | 查询无索引和分页判断 | 补 queryIndexPlan |

与其他 Skill 的关系

• `dev-database`：数据库 schema 变更使用专门 migration 安全策略。
• `api-contract-architecture`：数据字段进入 public API 时必须同步契约。
• `quality-strategy`：数据质量需要测试和回归矩阵。