dbt-labs/dbt-agent-skills

dbt‑Agent‑Skills – dbt 的 AI 驱动助手

它是什么 – 一个 Agent Skills 库，让大语言模型代理（Claude、Cursor、OpenAI、Gemini 等）自动执行与 dbt 相关的任务。每个技能都是一小包提示、脚本和元数据，当用户的自然语言请求与其用途匹配时，代理可以加载这些内容。

为什么重要 – dbt（数据构建工具）是团队构建、测试和记录分析管道的实际标准。通过将 dbt 操作暴露为 AI 代理技能，开发者可以要求 LLM “为我的模型添加单元测试” 或 “配置 dbt MCP 服务器”，代理将运行相应的 dbt 命令、生成 SQL 或编辑文件，而无需用户编写底层 CLI 语法。

主要组成部分

• 技能包 – dbt（日常分析工程）、dbt‑migration（一次性升级）和 dbt‑extras（例如 Mermaid DAG 图）。
• 安装 – 通过 Claude Code、Vercel Skills CLI、Tessl 或作为常规 dbt 包（dbt deps）安装。该仓库发布了三个独立的 dbt 包，可以添加到项目的 packages.yml 中。
• 支持的代理 – 任何实现 Agent Skills 规范 的 AI 产品，包括 Claude、Cursor、GitHub Copilot、Gemini、OpenAI 和 dbt Wizard CLI。
• 技能目录 – 示例包括：
  • using-dbt-for-analytics-engineering – 构建/修改模型、调试、探索数据源。
  • adding-dbt-unit-test – 生成 TDD 风格的测试。
  • building-dbt-semantic-layer – 创建 MetricFlow 指标/维度。
  • working-with-dbt-mesh – 管理契约、版本、跨项目引用。
  • troubleshooting-dbt-job-errors – 诊断平台故障。
  • 迁移技能，如 migrating-dbt-core-to-v2。

工作原理 – 技能 不是 手动斜杠命令。安装后，代理会监视用户的提示；当检测到匹配时，它会自动加载相关技能并执行定义的工作流（提示 → 脚本 → dbt CLI 调用 → 响应）。

入门 – 安装市场条目（/plugin marketplace add dbt-labs/dbt-agent-skills），然后安装所需的技能集（/plugin install dbt@dbt-agent-marketplace）。对于非 Claude 代理，使用 Vercel CLI（npx skills add …）或 Tessl（tessl install …）。安装后，在 dbt_project.yml 中设置 ai_provider，告诉 dbt 哪些代理应加载技能。

适用人群 – 已经使用 dbt 并希望通过与 LLM 对话而不是输入 CLI 命令来加速日常任务的数据分析师、分析工程师和平台工程师。

许可证与社区 – 根据仓库的 LICENSE 开源。欢迎通过拉取请求贡献；项目维护问题跟踪器、讨论论坛和用于 A/B 测试技能变体的评估框架。