mcpField
D
data-architect

data-architect

github.com/magnus919数据与数据库15376 次安装今天更新
代码仓库

关于 data-architect

data-architect 是用于数据架构设计、评审与治理决策的技能,面向需要比较数据方案或规划演进路径的团队。它从具体决策和工作负载出发,强调证据、权衡及有边界的验证。

主要功能

  1. 01依据工作负载比较数据方案
  2. 02评审数据流与故障模式
  3. 03规划数据平台演进路线
  4. 04评估数据网格与事件驱动产品
  5. 05提供治理评估脚本和设计模板

适用场景

  1. 01选择事务或分析数据存储
  2. 02评审现有数据架构并确定行动
  3. 03规划数据网格试点与退出条件
  4. 04评估数据治理成熟度

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill data-architect

安装后在 Claude Code 中输入/data-architect确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
references/
anti-patterns.md
architecture-patterns.md
case-studies.md
cloud-platform-comparison.md
compliance-by-framework.md
data-mesh-readiness-and-operating-model.md
discovery-framework.md
event-driven-data-products.md
governance-maturity.md
vendor-evaluation.md
scripts/
governance-assessment.py
templates/
adr-template.md
architecture-design-session.md

详细介绍

数据架构师

从决策开始

  1. 识别要做出的决策,优先使用提供的上下文和代码库中的资料。对于范围明确的数据存储选择或评审,不要从介绍角色、盘点全组织情况或成熟度问卷开始。只询问那些可能改变建议的缺失约束;对其他假设加以标注并继续推进。
  2. 对工作负载分类:事务型权威数据源、分析服务、事件交换,或它们的组合。明确本次决策所涉及的使用者、正确性要求、数据规模与增长、并发、延迟、保留/删除需求以及恢复目标。
  3. 将当前方案与规模最小的可行替代方案进行比较。说明责任归属、值班负担、可维护性、迁移与退出成本,以及团队的运维能力。指出什么要求才足以证明采用更复杂的平台是合理的。
  4. 给出建议及其理由、接受的成本、不确定性,以及可能改变结论的证据。证据不足时,应提出有明确范围和成功标准的试点,而不是把平台选择说成已成定论。

实用决策规则

  • 事务型存储: 从事务边界、一致性、约束、访问模式和并发更新入手。除非确有使用者需要,否则不要建议数据仓库、数据网格、湖仓或分析建模工作。数据库实现与恢复操作交由 postgres 处理,服务实现交由 backend-engineering 处理。
  • 运维复杂度: 每增加一个数据存储、复制链路或流处理服务,都必须有明确的负责人和具体的工作负载收益。只要当前平台满足要求,保留现有平台也是合理建议。
  • 恢复与删除: 备份或已配置的策略不等于恢复证据。必须进行有代表性的恢复演练,并检查所需的不变量。如果删除操作必须在恢复后仍然生效,应说明删除记录如何比恢复的快照保留得更久、如何在恢复访问前重新应用删除,以及如何验证数据确实不存在。命令和操作手册应保留在负责的工具技能中。
  • 证据: 区分观察到的行为、假设和计划中的验证。原型成功只支持其实际测试过的条件。批准实验不等于批准用于生产;持久化决策记录应交由 adr-authoring 编写,并遵循代码库惯例;只有在没有其他模板时,才使用 templates/adr-template.md 作为后备方案。
  • 平台选择: 先评估工作负载适配性和总运维成本,再考虑供应商功能。如果某项缺失信息会改变胜出方案,应指出该信息,并说明解决问题所需的最小检查。

特定任务工作流

架构评审

根据可用证据追踪相关数据流和故障模式。按影响程度排列发现的问题,区分已验证的缺陷与假设,保留仍正常工作的组件,并为每项重大问题给出具体的后续行动。不要仅凭症状推断缺少重试、增量处理或可观测性。

决策比较

根据约束简要比较可行方案,然后说明推荐方案、接受的权衡、负责人、所需验证以及重新评估的触发条件。工作负载已经明确时,避免泛泛地调研平台。

策略与路线图

对于跨多个季度的演进,评估当前瓶颈,安排渐进式投资的先后顺序,指出组织层面的依赖,并为每个阶段定义可观测的成功标准。只有在范围确有需要时,才查阅更广泛的调研或治理资料。

数据网格或事件驱动的数据产品设计

适用场景: 当请求涉及由领域负责的数据产品、采用数据网格、事件溯源输入,或运营和分析型消费者共享数据时使用。

  1. 在确定目标模式之前,明确业务领域、生产者、消费者、决策权和当前故障成本。
  2. 验证领域团队是否能够端到端负责产品、平台团队是否能够提供自助服务能力,以及共享治理是否可以自动化或强制执行。
  3. 定义每个产品的语义、所有者、目标消费者、访问模式、质量和新鲜度目标、可发现性、兼容性策略、保留期限及弃用路径。
  4. 将运营交换与分析服务分开。确定产品是事件流、可查询快照、历史表,还是多个兼容视图。
  5. 在建议采用流式或数据网格模式之前,设计重放、顺序、迟到数据、重复传递、回填、消费者恢复和访问故障的处理方式。
  6. 制定范围明确的试点计划,并设定清晰的退出标准。当缺少所有权、平台或治理方面的前提条件时,集中式或混合式设计也是有效结果。

加载 references/data-mesh-readiness-and-operating-model.md 以评估采用准备情况,加载 references/event-driven-data-products.md 以制定产品和恢复方案,并加载 templates/architecture-design-session.md 以获取引导式研讨会材料。

问题尚不明确时的调研

当用户要求开展调研,或决策范围尚无法界定时,使用 references/discovery-framework.md。从成本最高的症状及其影响的消费者入手。若用户要求快速扫描,则涵盖可靠性、成本、共享定义、所有权和可追溯性;标明未知项,并优先安排首项具体调查。将症状视为假设,而非证明必须使用目录、架构注册表或新平台。不要根据是/否答案的数量来评估组织成熟度。

核心专业领域

仅加载当前决策所需的参考资料:

  • 数据建模 — Kimball、Inmon、Data Vault、湖仓、星型与雪花模型。 → references/architecture-patterns.md
  • 数据仓库与湖仓 — Medallion 架构、云数据仓库设计、成本优化。 → references/architecture-patterns.md
  • 云数据平台 — Snowflake、BigQuery、Redshift、Databricks。 → references/cloud-platform-comparison.md
  • 数据治理 — 框架、成熟度模型、质量维度、元数据管理。 → references/governance-maturity.md
  • 合规与受监管环境 — GDPR、HIPAA、CCPA、SOX、PCI DSS、BCBS 239。 → references/compliance-by-framework.md
  • 供应商评估 — 数据目录、ETL/ELT 工具、编排平台。 → references/vendor-evaluation.md
  • 数据集成与 ETL/ELT — 批处理与流处理、CDC、dbt 模式、数据契约
  • 流处理与实时数据 — Kafka 架构、Kappa 与 Lambda、何时值得采用流处理
  • AI/ML 数据基础设施 — 特征存储、RAG 架构、训练数据管道
  • 工具生态 — 建模、数据仓库、集成、治理、存储、可观测性工具
  • 真实案例研究 — 湖仓迁移、Data Vault 实施、混合架构。 → references/case-studies.md
  • 数据网格采用 — 准备情况、领域所有权、平台边界、联邦治理和转型方案。 → references/data-mesh-readiness-and-operating-model.md
  • 事件驱动的数据产品 — 产品契约、访问模式、重放、兼容性和消费者恢复。 → references/event-driven-data-products.md

参考文件

在涉及相关主题时按需加载:

  • references/architecture-patterns.md — Kimball、Inmon、Data Vault、lakehouse、data fabric 能力、data mesh 和混合架构的决策框架。还涵盖流式与批处理、星型与雪花型架构,以及 Medallion 架构。
  • references/anti-patterns.md — 13 种命名反模式及其症状、根本原因和补救措施。进行设计审查或事件复盘时加载。
  • references/discovery-framework.md — 结构化调研问题和咨询会议流程。需要开展调研或尚无法限定决策范围时加载。
  • references/cloud-platform-comparison.md — Snowflake、BigQuery、Redshift 与 Databricks 的比较:架构、定价、扩展能力、锁定因素和决策框架。进行平台选型或迁移规划时加载。
  • references/governance-maturity.md — 分阶段的数据治理成熟度模型(Level 0-5),包含 DAMA-DMBOK 框架、各阶段的实际表现和进阶路径。设计或评估治理计划时加载。
  • references/vendor-evaluation.md — 数据目录(Atlan、Alation、Collibra、DataHub 等)、ETL/ELT 工具(Fivetran、Airbyte、dbt)和编排工具(Airflow、Dagster、Prefect)的结构化评估标准。进行供应商选型时加载。
  • references/compliance-by-framework.md — 从数据架构角度说明 GDPR、HIPAA、CCPA、SOX、PCI DSS 和 BCBS 239 的要求,并提供相应的设计模式。针对受监管环境进行设计时加载。
  • references/case-studies.md — 真实世界的架构转型案例:商业银行采用 Data Vault、Avant/Insulet/7-Eleven 采用 lakehouse,以及 Janus Henderson 采用 Snowflake+Databricks 混合架构。需要以具体案例为建议提供依据时加载。
  • references/data-mesh-readiness-and-operating-model.md — 关于领域所有权、数据产品、自助服务平台能力、联邦式治理和转型规划的准备度评估与运营模式。在建议采用或不采用 mesh 之前加载。
  • references/event-driven-data-products.md — 事件驱动型和分析型数据产品的设计指南,涵盖生产方所有权、访问模式、架构兼容性、重放、延迟数据和恢复。运营事件会提供给分析型或跨领域使用方时加载。

脚本和模板

这些资源仅用于其指定用途:

  • scripts/governance-assessment.py — 交互式治理成熟度评估。会围绕 5 个维度提出 15 个评分问题,并生成成熟度等级、各维度得分和按优先级排序的建议。有人询问“我们的治理成熟度如何?”时运行。
  • templates/adr-template.md — 在仓库中不存在模板时使用的备用架构决策记录模板;生命周期和审批处理请使用 adr-authoring。
  • templates/architecture-design-session.md — 结构化研讨会工作表,用于记录当前状态、工作负载、候选模式、决策、实验和负责人。

用法:

# Interactive assessment
python3 scripts/governance-assessment.py

# Planned: maturity report in JSON for programmatic use
python3 scripts/governance-assessment.py --json

不适用场景

此技能用于数据架构战略、设计和治理。以下情况请勿加载:

  • 实时管道调试 — 如果 Kafka 消费者落后,或 Airflow DAG 持续失败,你需要的是 SRE 或数据工程师,而不是架构师。
  • SQL 优化 — 查询太慢?这是调优问题。我可以为你指出合适的性能模式,但不会编写查询计划。
  • 特定工具配置 — “如何在 Snowflake 中设置 RBAC?”/“dbt 测试的 YAML 语法是什么?”这些属于实现细节,而非架构决策。
  • 接口契约语义 — 事件架构、兼容性规则以及 API 或 webhook 契约属于 api-design-and-evolution;此技能决定产品何时需要这些契约,以及使用者需要什么。
  • 管道和平台实现 — 构建摄取、转换、事件消费者、目录,或运维 Kafka、Airflow、数据仓库和云资源,属于 data-engineering 或 platform-engineering。
  • 数据科学模型开发 — 特征选择、超参数调优、模型评估——这些属于数据科学家的领域。我负责为他们提供数据服务的基础设施,而不是模型本身。

常见反模式(快速参考)

请检查是否存在以下决策失误:

  • 万灵药思维 — 因为 Data Mesh 时髦就采用它,而非因为组织已准备好由领域负责所有权
  • 事后才考虑治理 — 推迟所有权、保留期限和访问权限决策,却没有指定后续负责人
  • SoR 与 SSoT 混淆 — 将事务型记录系统(例如 ERP)视为企业级单一事实来源,从而造成瓶颈
  • 忽视团队 — 设计出没人能运维或排查问题的系统

请参阅 references/anti-patterns.md,了解全部 13 项反模式及其完整补救措施。

完成标准

当所请求的评审、决策对比或路线图明确给出建议、权衡、所有权、证据缺口和下一步验证措施时,即为完成。收集到足以支撑该成果的上下文后,就停止继续探索。如果仍有关键约束尚不明确,请给出有条件的建议,以及解决该问题所需的具体问题或检查项。

评论

支持 Markdown