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 (16)
用于审查已发布技能的安全与质量问题,检查来自skills.sh及第三方扫描器的审计结果,并提供修复建议。
检查技能安全或质量漏洞
审查审计结果
修复发现的问题
npx skills add dbt-labs/dbt-agent-skills --skill auditing-skills -g -y
根据 dbt 模型血缘生成 Mermaid 流程图,支持通过 MCP 工具、manifest.json 或代码解析获取数据并可视化依赖关系。
需要可视化 dbt 模型血缘关系
查看数据表之间的依赖结构
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 项目从一个数据平台迁移到另一个平台,利用 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中实践测试驱动开发
验证SQL转换逻辑或修复Bug
npx skills add dbt-labs/dbt-agent-skills --skill adding-dbt-unit-test -g -y
通过dbt语义层或SQL查询数据仓库,回答业务指标、KPI等自然语言问题。优先使用语义层工具,备选修改SQL或探索模型。不用于开发测试或构建模型。
询问业务指标如销售额
查询用户活跃度数据
获取按区域分组的收入统计
npx skills add dbt-labs/dbt-agent-skills --skill answering-natural-language-questions-with-dbt -g -y
指导创建和修改 dbt 语义层组件,包括语义模型、指标和维度。根据 dbt 版本自动路由至最新或遗留规范,提供 YAML 配置及验证指南。
创建 dbt 语义模型
定义业务指标
配置度量与维度
迁移 dbt 语义层规范
npx skills add dbt-labs/dbt-agent-skills --skill building-dbt-semantic-layer -g -y
指导配置 dbt MCP Server,支持本地或远程模式,适配 Claude Desktop、Cursor 等 AI 客户端。协助完成认证设置、连接验证及工具启用,解决开发或元数据消费场景下的集成问题。
需要配置 dbt MCP 服务器以连接 AI 工具
排查 dbt MCP 连接或认证故障
决定使用本地还是远程 dbt MCP 模式
npx skills add dbt-labs/dbt-agent-skills --skill configuring-dbt-mcp-server -g -y
提供获取和搜索dbt官方文档的方法,支持通过添加.md后缀直接访问LLM友好的Markdown页面,或通过索引和脚本进行全文检索。
查询dbt Cloud或Core相关功能文档
检索dbt Semantic Layer使用说明
查找特定dbt命令或配置信息
npx skills add dbt-labs/dbt-agent-skills --skill fetching-dbt-docs -g -y
审计 dbt 项目文档覆盖率,按文件夹为缺失的模型和列生成符合项目风格的 YAML 描述草稿。用于补全文档、保持 Schema 与 SQL 同步,所有变更需人工审核。
审计 dbt 文档覆盖率
补全缺失的模型或列描述
保持 Schema YAML 与模型 SQL 同步
npx skills add dbt-labs/dbt-agent-skills --skill maintaining-dbt-documentation -g -y
提供dbt CLI命令格式化与执行指导,涵盖Core、Fusion及Cloud CLI的选择,推荐build模式及精确选择器,确保数据质量与高效执行。
用户需要运行dbt模型或测试
不确定使用哪个dbt可执行文件
需要构建或编译dbt项目
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 转换、创建测试及验证结果。指导 DRY 原则、DAG 结构规范,并指引处理破坏性变更时调用版本控制子技能。
构建新的 dbt 模型或测试
修改现有模型逻辑或配置
重构 dbt 项目结构
调试 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 与 state:modified
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-state -g -y
用于将 dbt-core v1 项目(1.3-1.7)迁移至最新版本(如 1.12)。根据数据驱动的问题集,自动处理破坏性变更、行为标志配置及自动化修复,确保平滑升级。
用户请求升级或更新 dbt 项目版本
需要将项目从旧版 dbt-core 迁移到最新版
npx skills add dbt-labs/dbt-agent-skills --skill upgrading-dbt-core -g -y
评估 dbt Mesh 中模型变更的破坏性影响,处理跨项目引用、版本控制、依赖解析及多项目协作,确保下游数据安全。
修改可能影响下游消费者的模型结构
进行 dbt 模型版本控制或弃用设置
配置跨项目依赖和引用
拆分单体 dbt 项目为 Mesh 架构
npx skills add dbt-labs/dbt-agent-skills --skill working-with-dbt-mesh -g -y


