Agent Skills
› dbt-labs/dbt-agent-skills
dbt-labs/dbt-agent-skills
GitHub用于审查和修复已发布技能的安全与质量问题，包括检查skills.sh审计结果及针对凭证泄露、供应链风险等问题的修复指南。
Install All Skills
npx skills add dbt-labs/dbt-agent-skills --all -g -y
Skills in Collection (19)
用于审查和修复已发布技能的安全与质量问题，包括检查skills.sh审计结果及针对凭证泄露、供应链风险等问题的修复指南。
检查技能安全或质量审计结果
修复第三方扫描器发现的漏洞
npx skills add dbt-labs/dbt-agent-skills --skill auditing-skills -g -y
根据 dbt 模型血缘关系生成 Mermaid 流程图，支持通过 MCP 工具、manifest.json 或直接代码解析获取依赖数据，并以 Markdown 格式输出可视化图表。
需要可视化 dbt 模型血缘和依赖关系
请求生成 dbt DAG 的 Mermaid 图表
npx skills add dbt-labs/dbt-agent-skills --skill creating-mermaid-dbt-dag -g -y
协助用户排查 dbt-core 迁移至 Fusion 时的错误，通过运行 autofix 并对剩余问题进行分类（自动修复、需引导、需输入或阻塞），明确哪些可自修、哪些依赖平台更新。
用户遇到 dbt-core 迁移到 Fusion 的错误
需要区分可手动修复与需平台更新的迁移问题
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-fusion -g -y
协助用户诊断 dbt-core v2 迁移错误，通过运行 autofix 并分类剩余问题，区分可自动修复、需引导、需输入或阻塞项。
dbt v2 迁移报错排查
需要自动化修复迁移兼容性问题
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-core-to-v2 -g -y
指导将dbt项目从一种数据平台迁移到另一种（如Snowflake至Databricks）。利用dbt Fusion实时编译识别SQL方言差异并修复，结合单元测试确保编译和数据正确性，直至目标平台零错误运行。
需要将dbt项目迁移到不同数据仓库
处理跨平台SQL方言兼容性问题
npx skills add dbt-labs/dbt-agent-skills --skill migrating-dbt-project-across-platforms -g -y
用于为 dbt 模型创建单元测试 YAML，通过模拟上游输入和验证输出来确保 SQL 转换逻辑的正确性，防止回归并支持 TDD。
为 dbt 模型添加单元测试
在 dbt 中进行测试驱动开发 (TDD)
验证复杂 SQL 逻辑或修复 bug
npx skills add dbt-labs/dbt-agent-skills --skill adding-dbt-unit-test -g -y
基于 dbt 语义层或 SQL 回答业务数据问题，如指标、KPI 分析。优先使用语义层工具，备选方案包括修改编译 SQL、模型发现及清单分析，旨在高效获取数据洞察而非开发测试。
用户询问销售总额、活跃客户数等业务指标
需要查询 KPI 或进行数据分析
npx skills add dbt-labs/dbt-agent-skills --skill answering-natural-language-questions-with-dbt -g -y
指导创建和修改 dbt 语义层组件（如语义模型、指标、维度等），根据 dbt 版本自动选择最新或遗留 YAML 规范，并提供配置验证与迁移建议。
创建或修改 dbt 语义模型
定义业务指标或维度
配置 MetricFlow
npx skills add dbt-labs/dbt-agent-skills --skill building-dbt-semantic-layer -g -y
指导用户配置 dbt MCP Server，生成 JSON 配置并解决认证与连通性问题。支持本地或远程服务器模式，适配 Claude Desktop、Cursor 等 AI 客户端，用于连接 dbt CLI 及平台 API。
配置 dbt MCP Server
设置 AI 工具与 dbt 的连接
解决 dbt MCP 认证问题
npx skills add dbt-labs/dbt-agent-skills --skill configuring-dbt-mcp-server -g -y
用于检索和搜索 dbt 文档的 Skill，支持通过 LLM 友好的 Markdown URL 获取单页或全文内容，并提供索引搜索及关键词过滤功能，帮助回答关于 dbt Cloud、Core 及语义层的问题。
查询 dbt 官方文档页面
搜索 dbt 功能特性
解答 dbt Cloud/Core/Semantic Layer 相关问题
npx skills add dbt-labs/dbt-agent-skills --skill fetching-dbt-docs -g -y
审计 dbt 项目文档覆盖率，按文件夹为序，基于项目现有风格自动起草缺失的模型和列描述。支持回补旧文档或同步新增/变更模型，确保 YAML 与 SQL 一致，仅生成草稿供人工审核，不自动提交。
审计 dbt 文档覆盖率
回补缺失的 YAML 描述
保持 schema YAML 与模型 SQL 同步
npx skills add dbt-labs/dbt-agent-skills --skill maintaining-dbt-documentation -g -y
用于查询 dbt v2 项目元数据，如模型、测试、依赖关系及运行结果。通过 SQL 视图高效回答项目结构问题，替代手动解析 YAML 或 manifest.json，支持本地 DuckDB 快速查询。
查询 dbt 项目中的模型、来源或测试定义
分析模型间的依赖关系和血缘
检查未测试或未文档化的元素
获取上次运行的耗时或状态信息
使用 dbt show 或 info_schema 函数
npx skills add dbt-labs/dbt-agent-skills --skill querying-the-dbt-information-schema -g -y
提供 dbt CLI 命令格式化与执行指导，涵盖 Core、Fusion 及 Cloud 工具选择。强调使用 build 替代 run、指定 selector 及 quiet 模式，确保数据管道运行安全高效。
需要运行或构建 dbt 模型时
不确定使用哪个 dbt 可执行文件时
需要格式化 dbt CLI 参数时
npx skills add dbt-labs/dbt-agent-skills --skill running-dbt-commands -g -y
用于诊断 dbt Cloud/平台作业失败的根本原因，通过分析运行日志、查询 Admin API、审查 Git 历史及调查数据问题。适用于错误信息不明确或间歇性故障场景，旨在定位基础设施、代码或数据层面的缺陷。
dbt Cloud 作业失败需要排查根本原因
出现难以复现的间歇性作业故障
错误信息模糊无法直接定位问题
npx skills add dbt-labs/dbt-agent-skills --skill troubleshooting-dbt-job-errors -g -y
用于执行数据工程任务，包括构建和修改 dbt 模型、编写 SQL 转换逻辑、创建数据测试及验证结果。适用于探索数据源、调试编译错误、评估变更影响及重构项目结构等场景。
构建或修改 dbt 模型
编写 SQL 数据转换逻辑
调试 dbt 编译或解析错误
为数据模型添加测试
探索不熟悉的数据源
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering -g -y
介绍 dbt State 服务器端复用机制，区分其与 state:modified 的差异，涵盖跳过、克隆、构建逻辑及配置调试场景。
启用或配置 dbt State
优化 dbt State 性能
调试 dbt State 问题
混淆 dbt State 与 state:modified
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-state -g -y
自动将 dbt-core v1 项目升级至 1.12，处理版本间的破坏性变更及行为标志配置。
升级 dbt 项目
迁移 dbt 版本
更新 dbt-core
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt-core -g -y
将 dbt v1 项目从旧版本（1.3-1.7）迁移至 1.12。依据数据驱动的变更包，按自动化类型处理破坏性更改或配置行为标志，确保兼容性与功能保留。
升级 dbt 项目版本
迁移 dbt 到最新版本
解决 dbt 版本不兼容问题
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt -g -y
用于处理 dbt Mesh 项目中跨项目引用、模型版本控制、破坏性变更评估及多项目依赖管理。涵盖 dependencies.yml 配置、歧义消除和单体拆分，确保数据链路稳定性。
修改可能影响下游消费者的 dbt 模型结构
配置跨项目依赖或解决模型名称歧义
实施模型版本控制或迁移策略
npx skills add dbt-labs/dbt-agent-skills --skill working-with-dbt-mesh -g -y
