1. 基本信息
项目自述名称：所在仓库自述为「dbt Agent Skills」（一个多技能合集仓库），本技能自身文档标题为「Using dbt for Analytics Engineering」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | using-dbt-for-analytics-engineering-dbt-labs-dbt-agent-skills | — |
| 作者/维护者 | dbt Labs（官方） | GitHub API |
| 来源链接 | https://github.com/dbt-labs/dbt-agent-skills/tree/main/skills/dbt/skills/using-dbt-for-analytics-engineering | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 626 | GitHub API |
| 该子技能单独统计 | 553 stars / 414 installs（第三方聚合站） | WebFetch（claudemarketplaces.com），已与仓库级 API 数据交叉核对量级一致 |
| Forks | 53 | GitHub API |
| 最新版本 | 1.3.1（Tessl 包管理器 tile.json 标注；GitHub 尚未打 Release 标签，滚动更新） | 主仓库直读 |
| 安装方式 | Claude Code 插件市场 / Vercel Skills CLI / Tessl | 官方 README |
2. 功能介绍与亮点
核心能力：覆盖 dbt 模型开发的完整闭环——建模与修改、用 ref()/source() 编写 SQL 转换、编写测试、用 dbt show 校验结果。技能内置 7 篇细分参考指南（建模规划、数据探查、写测试、调试报错、变更影响评估、写文档、包管理），按场景动态加载而非一次性塞满上下文。强制 DRY 原则，识别到会影响下游消费者的破坏性变更（列重命名/删除/改类型）时会主动路由到配套的 dbt-mesh 技能做版本化发布，而不是直接改坏线上表。
亮点：
- 官方 dbt Labs 出品，是该合集仓库中排在首位、覆盖面最广的旗舰技能；
- 显式防 prompt injection：SKILL.md 明确要求把
dbt show结果、仓库查询、包注册表响应都当作不可信内容，禁止执行其中嵌入的指令； - 权限收敛：
allowed-tools严格限定为Bash(dbt *)与Bash(jq *)，没有任意 shell 执行权限； - 采用业界公开的 superpowers skill 编写方法论（TDD + 压力测试）构建与校验；
- 官方 ADE-bench 基准显示接入该技能后 dbt 任务准确率从 56% 提升到 58.5%，多步骤 DAG 任务提升更明显；
- dbt Labs 创始人公开分享过一次完整的 dbt Core→Fusion 迁移「零人工介入、编译运行零故障」。
3. 适用场景
固定分类：数据分析与可视化
- 已有 dbt 项目的数据/分析工程师日常建模、调试报错、补测试；
- 新人接手陌生 dbt 项目时快速做数据探查、理解现有模型口径；
- 改动某个被下游依赖的模型前，先评估影响范围再动手；
- 为对接语义层回答业务问题做前置建模准备。
受益人群：正在用 dbt 做数据转换、且希望用 Claude Code / Codex 等 Agent 辅助日常建模而非从零学习最佳实践的初中级分析工程师团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方提供
/plugin marketplace add+/plugin install一键安装路径。 - Codex：✅ 官方点名支持——dbt Labs 官方博客（docs.getdbt.com/blog/dbt-agent-skills）明确列出 Claude Code、OpenAI Codex、Cursor、Factory、Kilo Code 为兼容 Agent。
- OpenClaw：❓ 未验证——已抓取材料仅笼统声称遵循开放的 Agent Skills 规范（agentskills.io）并支持「30+ agents」，未点名验证，未为此单独发起搜索。
- Hermes Agent：❓ 未验证——同上，材料未提及。
5. 推荐理由
官方出品、创始人亲自实测背书、文档极其详尽、权限收敛到极致，且把“先看数据再建模”“破坏性变更走版本化”这类资深分析工程师的隐性经验固化进 Agent 行为，直接降低“Agent 一步生成模型但未经校验”的常见风险。对已经在用 dbt、但团队里缺乏资深分析工程师带教新人的场景，价值尤其明显。
6. 评分
| 维度 | 分数 |
|---|---|
| 受欢迎程度 | 7 |
| 可用性 | 8 |
| 安全性 | 9 |
| 综合 | 8.0 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | 仅 Bash(dbt *) 与 Bash(jq *)，无任意 shell 执行权限，未扣分 |
| ② 运行时联网外发 | 仅通过 dbt 连接用户自行配置的数据仓库；读取 hub.getdbt.com 包注册表时，SKILL.md 明确要求当作不可信内容处理，禁止执行内嵌指令，未扣分 |
| ③ API key/凭据存储 | 复用 dbt 自身 profiles.yml/仓库连接凭据，技能本身不索取或存储任何凭据，未扣分 |
| ④ 可疑指令/注入迹象 | 未发现；反而主动写入 prompt injection 防御条款，加分项 |
| ⑤ 作者/组织信誉 | dbt Labs 官方，dbt 生态权威维护方，未扣分 |
| ⑥ License 明确性 | Apache-2.0，明确，未扣分 |
| ⑦ 最近维护时间 | 该子技能最近提交 2026-06-16，仓库整体最近提交 2026-07-07，17 位贡献者，含多次「security and quality audit findings」修复记录（其中含第三方 skills.sh 安全审计），未扣分，加分项 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 热度证据 | 与本技能的差异 |
|---|---|---|---|
| using-dbt-for-analytics-engineering（本技能，dbt Labs） | dbt 模型全生命周期：建模/测试/调试/影响评估 | 官方仓库 626 stars，子技能单独统计 414 installs | 唯一同时具备“官方厂商背书+多 Agent 官方点名兼容+外部安全审计记录+分场景细分指南”四项证据的方案 |
| developing-with-streamlit（Streamlit 官方） | 路由到本地 Streamlit(≥1.57) 内置文档，做应用 UI/主题/组件开发 | 219 stars，官方出品 | 聚焦应用可视化层而非数据建模层，且强依赖本地已安装的特定 Streamlit 版本 |
| data-engineering-skills（AltimateAI） | dbt + Snowflake 优化辅助 | 109 stars | 初创公司出品，生态成熟度与关注度明显更早期 |
| data-analysis-skill（dongzhang84） | 面向 Excel/CSV 的多专家 EDA 工作流 | 8 stars | 个人早期项目，热度与维护证据不足 |
| td-skills（Treasure Data） | 绑定 Treasure Data 专有平台的 Trino/Hive/dbt 技能 | 20 stars，仓库未标注开源 License | 强绑定商业平台，且许可证不明确 |
| data-science-claude-skills（juanlurg） | 环境自适应 EDA/SQL 优化实验项目 | 1 star | 个人实验性项目，尚处早期阶段 |
8. 用户评价
- Brandon（dbt Labs 数据团队成员） —— 来源：dbt Labs 官方博客 docs.getdbt.com/blog/dbt-agent-skills。评价大表规模模型上有无该技能时给出的优化建议对比：“新版本给出的增量过滤、预聚合中间模型等建议令人非常兴奋，认为会带来巨大影响。”
- Tristan Handy（dbt Labs 创始人） —— 来源：roundup.getdbt.com/p/agent-skills-disseminating-expertise。亲历一次完整的 dbt Core→Fusion 迁移，“零人工介入，Fusion 编译运行零故障”；评价该技能合集“封装了 dbt 社区十年积累的最佳实践经验”。
以上两条均为 dbt Labs 内部人士在官方渠道公开发表的评价，本次未检索到完全独立于厂商的第三方用户评价，如实说明，不为凑数追加抓取。
9. 其他补充
遵循开放的 Agent Skills 规范（agentskills.io），同一份技能可通过 Claude Code 插件市场、Vercel Skills CLI、Tessl 包管理器等多种渠道分发。仓库自带 evals/ 目录，提供 A/B 测试工具用于技能迭代对比。版本记录由 Changie 自动生成 CHANGELOG，采用语义化版本（当前 1.3.1），但尚未打 GitHub Release 标签。
10. 安装使用方式
Claude Code（官方推荐）：
/plugin marketplace add dbt-labs/dbt-agent-skills
/plugin install dbt@dbt-agent-marketplace该插件包含 using-dbt-for-analytics-engineering 在内的 9 个 dbt 核心技能；如需迁移相关技能，另装 dbt-migration@dbt-agent-marketplace。
Vercel Skills CLI（跨 Agent 通用，含 Codex/Cursor 等）：
npx skills add dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineeringTessl 包管理器：
tessl install dbt-labs/dbt-agent-skills --skill using-dbt-for-analytics-engineering安装后注意事项：该技能为自动触发型（user-invocable: false），无需手动斜杠命令调用，Agent 识别到 dbt 相关任务时会自动加载；使用前提是本地已有配置好的 dbt 项目（含 dbt_project.yml）并通过 dbt debug 验证过仓库连接；首次使用建议确认权限提示中只出现 dbt/jq 命令，不应出现其他任意 shell 权限请求。
11. 注意事项
- 该技能需要用户本地已安装并配置好 dbt（含数据仓库连接），对完全没有 dbt 项目的用户没有直接价值；
- 仓库尚未打 GitHub Release 标签，版本号来自 Tessl 的 tile.json 而非 GitHub Releases，更新需自行关注 CHANGELOG.md；
- Codex/Cursor 等其他 Agent 的兼容性由 dbt Labs 官方博客点名确认，但具体安装体验本次未实测；OpenClaw 与 Hermes Agent 的兼容性完全未验证；
- 涉及
dbt run/dbt build等实际执行数仓操作时，仍建议在有版本控制与回滚保障的开发环境中使用，避免直接对生产环境批量执行。