【免费下载链接】dbt-agent-skillsA curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.项目地址https://gitcode.com/gh_mirrors/db/dbt-agent-skills点击查看免费下载正在把 dbt 项目从 dbt Core 迁移到 dbt v2却被一屏幕的错误代码卡住dbt-agent-skills 是一套精选的 dbt Agent Skills 合集其中的migrating-dbt-core-to-v2技能能配合官方dbt-autofix工具先自动修复废弃语法再把剩余错误分诊成 4 个类别帮你一眼看清哪些错误自己能修、哪些在等 v2 引擎更新。为什么迁移 dbt v2 会让人慌静态分析更严格以前能跑通的模型现在会报列名大小写不符、标识符无法解析Config API 变更config.require()不再能取到meta下的自定义键匹配更严格source 名称、包版本、YAML 格式v2 都要求精确匹配部分错误根本改不了有些错误源于 v2 引擎本身的能力缺口怎么改代码都修不好最难的是第四点——官方技能明确定义了迁移的成功标准做出进展、并清楚知道什么在阻塞你而不是一遍就做到 100%。dbt-agent-skills 是什么dbt-agent-skills 是一个 Agent Skills 开源仓库。Skill 本质是指令 脚本 参考资料的文件夹安装后 AI Agent 会在你用自然语言描述需求时自动加载对应技能无需记忆任何命令。仓库包含 3 个可独立安装的包包名子目录用途dbt_agent_skillsskills/dbt/日常开发建模、测试、语义层、dbt Meshdbt_migration_skillsskills/dbt-migration/一次性迁移与升级技能本文主角dbt_extras_skillsskills/dbt-extras/Mermaid DAG 图等扩展能力核心迁移技能源码在 SKILL.md。三步装好迁移技能方式一Claude Code 插件/plugin marketplace add dbt-labs/dbt-agent-skills /plugin install dbt-migrationdbt-agent-marketplace方式二Vercel Skills CLI兼容 Cursor、Cline、Copilot 等 30 AI 客户端npx skills add dbt-labs/dbt-agent-skills/skills/dbt-migration方式三作为 dbt 依赖安装把dbt_migration_skills包子目录skills/dbt-migration加入项目的packages.yml并在dbt_project.yml的flags中设置ai_provider如ai_provider: claude然后运行dbt deps即可。完整配置见 README.md。 迁移技能通常只需安装一次——迁移完成后无需再日常加载。三步分诊流程该技能是一套严格顺序执行的流程而不是泛泛的建议Step 0用 dbt debug 体检环境先运行dbt debug验证凭据与连接。如果连接失败那是环境问题而非迁移问题——先修它能避免后面大量无效排查。Step 1先跑 dbt-autofix必选dbt-autofix 是 dbt Labs 官方的一键修复工具批量处理常见废弃模式uvx --from githttps://github.com/dbt-labs/dbt-autofix.git dbt-autofix deprecations跑完一定要复查改动查看git diff确认它改了哪些文件、哪些 config 键被移到了meta:、哪些包版本被升级——个别迁移错误恰恰是 autofix 引入的。另外dbt1065包版本兼容性警告可以安全忽略autofix 已经处理过包升级。Step 2给剩余错误分类autofix 完成后Agent 才会把剩余错误分类并输出汇总报告此时才允许开始手动修复。复现命令默认是dbt compile技能会自动追加--static-analysis strict——非严格模式下静态分析问题只是警告项目可能显示0 错误而严格模式会暴露真实的列存在问题。四类错误分诊框架 这是技能的核心。各类别的完整定义与修复流程见 classification-categories.md全部错误码目录见 error-patterns-reference.md。类别含义典型场景处理方式A 可自动修复修复确定、无风险config 引号嵌套dbt1000、analyses/静态分析报错确认后自动应用B 引导修复方案明确但会改变项目行为dbt1501Config API、dbt1060自定义键、dbt1013YAML 语法先展示 diff批准后再改C 需要你拍板存在多个正确方案硬编码全限定表名导致权限错误、analyses/查询失败给出选项由你决定D 被阻塞需 v2 引擎更新项目内修不了MiniJinja 过滤器差异、引擎崩溃panic!、not yet implemented标记阻塞、查官方 issue决定绕行还是等待模式匹配按优先级进行静态分析错误错误码 1000→ 已知用户可修复模式 → v2 引擎缺口Agent 会自动搜索官方 issue而不是让你自己去查→ 未知模式。实战最常见的 dbt1501 错误最典型的迁移错误是 Config API 变更——config.require()在 v2 中只认内置配置键meta下的自定义键要换用新 API-- Beforedbt1501 {% set owner config.require(meta).owner %} -- After {% set owner config.meta_require(owner) %}Agent 会把它归为B 类展示精确的 diff等你批准后才动手绝不静默改代码。仓库评测场景 evals/scenarios/ 中还有两类真实案例值得了解大小写敏感dbt0227严格模式下保留字必须加引号而加引号后大小写就敏感了。正确姿势是先查真实数仓的INFORMATION_SCHEMA.COLUMNS确认列的实际存储大小写再在引用侧修正引号写法被阻塞的错误D 类例如 Jinjatruncate()过滤器因 MiniJinja 签名差异而失败。技能要求 Agent 自己去搜索官方 issue告诉你它是否被跟踪、有无绕行方案、以及绕行方案的风险迁移最佳实践清单 ✅别只用dbt parse验证每次修复后必须重跑复现命令如dbt compile --static-analysis strict级联错误是正常的修掉一个错误常会暴露下一个边报边分类即可不验证就不压制给生产模型加static_analysis: off前必须先查真实数仓确认否则会把编译期错误变成静默的生产故障阻塞要透明D 类问题明确标注并说明原因不藏不淡化成功 进展很多错误确实要等 v2 引擎修复一轮做不到 100% 是预期内的仓库还内置了 A/B 评测工具skill-eval可用真实迁移场景如 v2-migration-triage-basic验证技能的分诊行为是否稳定。相关资料技能主文档SKILL.md分类定义与修复流程classification-categories.md完整错误模式目录error-patterns-reference.md参考资料索引references/README.md分类修复评测示例v2-triage-cat-b-dict-meta-get仓库说明与安装指南README.md赞分享【免费下载链接】dbt-agent-skillsA curated collection of Agent Skills for working with dbt, to help AI agents understand and execute dbt workflows more effectively.项目地址https://gitcode.com/gh_mirrors/db/dbt-agent-skills点击查看免费下载相关推荐断网了也要翻译一条命令装好的 Argos Translate 离线翻译完整指南断网了也要翻译一条命令装好的 Argos Translate 离线翻译完整指南 出差高铁上、海外拉练、给内部资料做脱敏处理——场景很常见手边有份外语文档网人工智能NLP本地部署generative-ai-for-beginners 第 18 课自学指南LLM 微调Fine-Tuning核心资源全解析与 Foundry 实战路线generative ai for beginners 第 18 课自学指南LLM 微调Fine Tuning核心资源全解析与 Foundry 实战路线SenseNova-Skills 信息图布局详解swiss-grid 瑞士网格布局的设计原则与应用实践SenseNova Skills 信息图布局详解swiss grid 瑞士网格布局的设计原则与应用实践 swiss grid 是 SenseNova Skil上一篇coreboot 架构文档详解RISC-V 的 M/S 模式启动协议与 x86 PAE、x86_64 长模式支持下一篇syzkaller 依赖的 varnamelen:一个把变量名长度应匹配使用范围固化为静态检查的 Go Analyzer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考