cosmos-dbt-core – dbt 项目编排与转换 Skill

Skill 详细介绍

astronomer/agents#cosmos-dbt-core 是 Astronomer 官方 agents 仓库中提供的一个 Skill，名称可以识别为 cosmos-dbt-core。它围绕 cosmos-dbt-core 这个能力包展开，核心目标是把 dbt Core 项目的相关操作交给 AI Agent 来辅助完成。

它是什么：

• 一个面向 dbt Core 工作流的 Agent Skill。
• 用于帮助 AI Agent 理解、创建、维护和排查 dbt 项目。
• 通常与 Astronomer 的 Cosmos 生态有关，Cosmos 是把 dbt 项目运行在 Airflow 上的开源方案。

它不是什么：

• 它不是 dbt 本身，也不是 Airflow 本身。
• 它不是一个可以脱离 AI Agent 独立运行的软件。
• 它不会自动帮你部署生产级数据平台，更多是辅助开发、生成、检查和排错。

主要解决的问题：

• 让 Agent 更懂 dbt Core 项目结构、模型、配置和运行方式。
• 减少在 dbt 与 Airflow / Cosmos 集成时反复查文档、写样板代码的成本。
• 帮助用户把 dbt 相关任务用自然语言交代给 Agent 处理。

安装后 Agent 增加的能力，通常体现在：

• 识别 dbt 项目结构，例如 models、macros、profiles、dbt_project.yml。
• 协助编写或修改 dbt 模型和配置。
• 协助理解 Cosmos 如何把 dbt 任务映射到 Airflow DAG。
• 协助排查 dbt 运行、依赖和调度相关问题。

适合的用户：

• 使用 dbt Core 做数据转换的数据工程师、分析工程师。
• 正在把 dbt 与 Airflow 结合、使用 Cosmos 的团队。
• 希望让 AI Agent 参与数据管道开发与维护的人。

不适合的需求：

• 只想用 dbt Cloud 的托管功能，不一定需要这个 Skill。
• 完全不使用 Airflow 或 Cosmos、也不需要 dbt 项目辅助的纯 BI 场景。
• 期望 Skill 直接承担生产调度和安全审计职责的场景。

本质上，它更接近一个面向 dbt Core 与 Cosmos 工作流的技能包和提示词 / 指令集，而不是一个独立产品。它调用的是 dbt、Airflow、Cosmos 这些外部工具的能力，Skill 本身提供的是让 Agent 更规范地处理这些任务的指导与结构。

Skill 安全评估

总体判断：来自 Astronomer 官方 agents 仓库，来源可信度相对较高，但 dbt 相关任务通常涉及数据库凭证、数据仓库访问和代码执行，使用时应按“数据处理类 Skill”对待，而不是当作纯文本助手。

需要关注的点：

• 来源可信度：Skill 标识为 astronomer/agents#cosmos-dbt-core，属于 Astronomer 组织下的仓库，建议以该官方仓库当前内容为准。
• Shell 与命令执行：dbt 相关操作往往需要运行 dbt 命令，Agent 若被授予自动执行 Shell 的权限，会直接影响本地或连接的数据库环境。可以让 Agent 只生成命令，由人工手动执行。
• 文件读写：Skill 可能会读取和修改 dbt 项目中的模型、配置、宏文件。建议在版本控制下使用，改动可回滚。
• 数据库与数据仓库凭证：dbt 通常需要连接数据仓库，涉及 profiles.yml、环境变量或密钥管理。不要把生产库的高权限凭证交给 Agent 随意使用。
• 网络访问：安装依赖、拉取包或访问数据仓库时可能需要网络。
• 供应链风险：涉及 dbt 包、Python 依赖时，注意来源和版本。
• Prompt Injection：如果 Skill 处理的是外部输入内容，仍需警惕间接提示注入。

降低风险的做法：

• 在开发环境或测试分支先试，不要直接在生产数据仓库上操作。
• 限制 Agent 的 Shell 自动执行权限，关键命令人工确认。
• 使用最小权限的数据库账号。
• 把 dbt 项目纳入 Git 管理，便于审查和回滚。
• 敏感凭证通过环境变量或密钥管理工具提供，不写入明文文件。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Astronomer 的 agents 仓库，官方主要面向支持 Skills 机制的 AI Agent。Claude Code 这类支持 Skill 加载能力的客户端可以优先考虑。Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 Agent 官方没有提供完整兼容列表，但从 Agent Skill 的工作方式看，只要对应 Agent 支持加载 Skill 或自定义指令，通常可以尝试使用；不同 Agent 的加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 等支持 Skills 的 Agent 优先，其他兼容 Agent 可尝试 |
| dbt Core | 处理 dbt 项目的实际任务时需要 |
| Airflow / Cosmos | 涉及 Cosmos 集成任务时需要 |
| Git | 建议使用，便于版本管理 |
| 网络 | 拉取依赖或访问数据仓库时可能需要 |

官方没有明确给出 Node.js、Python 的强制版本要求，具体以当前官方说明和你的 dbt / Airflow 环境为准。

三、权限

• 文件读取：必需，用于读取 dbt 项目。
• 文件写入：根据任务可选，用于修改模型和配置。
• Shell：可选，用于运行 dbt 命令，建议人工确认。
• 网络：按需，用于依赖和数据仓库访问。

四、账号 / API Key

Skill 本身通常不需要单独申请账号或 API Key。但实际执行 dbt 任务时，你的 dbt 环境可能需要数据仓库凭证，Airflow / Cosmos 环境可能需要相应配置。这些凭证属于你使用的外部服务，不属于 Skill 本身的强制要求。

最小使用条件

• 一个支持 Skills 的 AI Agent。
• 可访问的 dbt Core 项目。
• 必要时可用的数据仓库连接配置。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。如果你不确定自己的 Agent 如何安装，可以直接询问当前 AI Agent：

如何安装 astronomer/agents#cosmos-dbt-core？

如何在 Claude Code 中安装 astronomer/agents#cosmos-dbt-core？

如何在 Cursor 中安装 astronomer/agents#cosmos-dbt-core？

让当前 Agent 根据它自己的 Skill 加载和管理机制来指导安装。如果该 Skill 有特殊官方安装条件，以官方仓库当前说明为准。

二、安装后如何使用

安装后，当你的任务涉及 dbt Core 项目、dbt 模型、Cosmos 或 dbt 与 Airflow 的结合时，可以明确让 Agent 使用这个 Skill。用自然语言描述目标即可，不需要记命令。

示例：

使用 cosmos-dbt-core，帮我检查这个 dbt 项目的结构是否规范。

使用 cosmos-dbt-core，帮我把这个 dbt 项目配置成在 Airflow 上通过 Cosmos 运行。

使用 cosmos-dbt-core，帮我排查这个 dbt 模型运行失败的原因。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。可以使用对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill，也可以直接询问当前 Agent：

如何卸载 astronomer/agents#cosmos-dbt-core？

如果没有统一卸载命令，让 Agent 指示你删除对应 Skill 文件或目录通常更稳妥。具体以你所用 Agent 的当前版本为准。

常见问题

1. 这个 Skill 需要 dbt Cloud 吗？

不需要。它名称中就是 dbt-core，面向 dbt Core 工作流以及 Cosmos 集成。dbt Cloud 是另一套托管方案，与本 Skill 的定位不同。

2. 必须使用 Airflow 吗？

不一定。如果你的任务只是纯 dbt Core 项目的编写和排查，可以不涉及 Airflow。涉及 Cosmos 相关能力时，才会与 Airflow 关联。

3. 安装后 Agent 没识别到这个 Skill 怎么办？

先确认安装是否成功、安装位置是否是该 Agent 读取 Skill 的目录，再检查 Agent 版本是否支持 Skills。可以直接问当前 Agent：“为什么没有识别到 astronomer/agents#cosmos-dbt-core？”

4. 可以同时装到多个 Agent 里吗？

通常可以，不同 Agent 的 Skill 目录相互独立。是否支持取决于各 Agent 的加载机制，安装时分别按其方式操作即可。

5. Skill 更新后需要重新安装吗？

如果是从远程仓库加载，更新方式取决于你的 Agent 是否支持自动同步。若你把 Skill 文件复制到了本地目录，则需要重新拉取或覆盖。具体以官方仓库和你的 Agent 说明为准。

6. 中国大陆使用有网络要求吗？

安装和更新时可能需要访问 GitHub 等海外资源。实际执行 dbt 任务时，网络要求主要来自你的数据仓库和依赖源，与 Skill 本身无关。

7. 它会自动修改我的 dbt 项目吗？

取决于你是否授予了文件写入和 Shell 执行权限。如果不希望自动改动，可以关闭自动执行，让 Agent 只给出建议和代码，由你手动应用。建议在 Git 版本控制下使用。