blueprint – Agent 架构蓝图设计 Skill

blueprint 是用于把复杂任务或需求拆解成结构化步骤与执行方案的规划型 Skill，适合 AI Agent 在动手前梳理思路、明确流程并生成可落地的行动计划。

查看调研报告在来源平台打开

数据与分析数据处理 # Apache Airflow # Astronomer # DAG # 数据管道 # 数据编排

Skill 安装

多 Agent 安装

npx skills add https://github.com/astronomer/agents --skill blueprint

使用 npx skills 快速安装，支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

astronomer/agents#blueprint 是 Astronomer 官方 agents 仓库中提供的一个 Skill。按照该标识可以定位到：Astronomer 组织下的 agents 仓库，Skill 名称为 blueprint。

需要先说明一点：blueprint 这个名字本身不足以推断它的具体功能。叫 blueprint 的项目、插件、模板在开源生态里很多，但当前 Skill 的唯一身份是 astronomer/agents#blueprint，也就是 Astronomer 的 agents 仓库里的 blueprint，而不是其他同名项目、Fork、镜像或第三方再发布版本。

从可确认的仓库归属看，Astronomer 是 Apache Airflow 生态中知名度较高的公司，主要产品围绕数据编排、Airflow 托管服务 Astro 展开。因此这个 Skill 大概率与数据管道、Airflow DAG、数据编排相关的开发或规划工作有关，而不是通用写作、通用搜索、普通办公类 Skill。

关于它具体提供哪些能力，目前能公开确认的官方说明有限。按照 Skill 的常见形态，astronomer/agents#blueprint 更可能是一组面向数据工程 / Airflow 场景的指令、工作流或方法论，而不是一个独立运行的软件、CLI 工具或后台服务。它不会自己启动进程，不会单独访问网络，也不会脱离 Agent 独立工作；它需要被支持 Skill 机制的 AI Agent 加载后，在对话或任务中起作用。

它主要解决的问题可以概括为：让 AI Agent 在处理数据管道、Airflow 相关任务时，有一套更贴近 Astronomer 官方实践的工作方式，而不是每次从零开始描述需求。典型的预期用途可能包括：

协助规划或设计 Airflow DAG / 数据管道结构
协助梳理数据编排任务之间的依赖关系
协助把口头描述转化为可继续开发的方案草稿
在数据工程场景中提供更一致的操作思路

适合的用户：已经在使用 Airflow、Astronomer 或类似数据编排体系，希望让 AI Agent 在数据工程任务里表现更稳定的开发者、数据工程师、数据平台团队。

不适合的需求：如果你想找的是一个开箱即用的数据平台、调度器、可视化工具，或者与数据编排无关的通用写作 / 搜索 / 办公类 Skill，那么它并不对应这类需求。

与普通 Agent 自身能力的区别在于：Agent 本身已经能回答通用问题，而 astronomer/agents#blueprint 提供的是领域约束和结构化方式。它不会让 Agent 变“更聪明”，而是让 Agent 在特定数据工程任务里少走偏、少一些自由发挥。具体能力边界，以该 Skill 当前官方说明为准。

Skill 安全评估

总体判断：来源是 Astronomer 官方组织下的 agents 仓库，可信度相对较高；但该 Skill 的具体行为需要以它实际内容为准，不能因为仓库正规就默认“零风险”。

与这类 Skill 真正相关的安全点主要有：

来源可信度：astronomer/agents 属于 Astronomer 官方组织仓库，相比匿名个人仓库、镜像仓库，供应链风险更低。但仍应确认安装来源就是该官方仓库，而不是第三方复制版本。
提示词 / 指令注入：Skill 本质上是给 Agent 的指令集。如果 Skill 内容中包含引导 Agent 执行非预期操作的指令，可能影响 Agent 行为。建议在正式使用前浏览其实际内容，而不是直接无条件信任。
文件读写：数据工程场景下，Agent 可能在协助生成 DAG、配置文件时读写本地文件。是否允许自动写入，应由用户在 Agent 权限层面自行决定。
Shell 执行：如果 Agent 被授予 Shell 权限，Skill 涉及的安装、运行、测试命令可能被自动执行。建议需要执行命令时改为手动确认。
网络访问：是否联网取决于 Skill 内容与 Agent 配置，不是该 Skill 必然行为。
凭证：涉及 Airflow、Astronomer、云平台的任务，后续操作的项目可能需要 Token、API Key 或连接配置。是否使用、放在哪里，由用户自行决定，Skill 本身是否内置凭证需求应以官方说明为准。

降低风险的实操建议：

只从官方仓库安装，避免使用不明来源的同名 Skill。
安装前查看 Skill 文件内容，确认没有意外指令。
如果只需要 Skill 帮助生成方案或代码，可在 Agent 中关闭自动执行 Shell 的权限，由自己手动运行命令。
不要在对话中直接粘贴生产环境的密钥、连接串，改为使用环境变量或密钥管理工具。

不要把它理解为“绝对安全”或“已经全面安全审计”。目前没有公开信息支持这类绝对结论。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Astronomer 的 agents 仓库，官方主要面向支持 Skill 机制的 AI Agent。目前官方没有公布完整的第三方 Agent 兼容列表，因此可确认的“官方支持”范围有限。

就常见环境而言：与 Claude Code 这类支持 Skill / 自定义指令加载的 Agent 配合通常比较自然；在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 中，如果它们支持 Skills 或类似的自定义指令加载机制，一般也可以尝试使用。不同 Agent 对 Skill 的加载方式、目录约定和兼容程度不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

该 Skill 本身如果只是指令 / 工作流形态，通常不需要额外运行时。是否依赖 Node.js、Python、Git、Docker 等，取决于你后续让 Agent 执行的任务，以及官方对该 Skill 的具体要求。

项目	要求
Agent	支持 Skill / 自定义指令加载机制的 Agent
Node.js	官方未明确要求；按实际任务需要
Python	官方未明确要求；数据工程任务中可能用到
Git	官方未明确要求；按安装方式需要
网络	官方未明确要求；按安装和任务需要

官方没有明确版本要求时，不要自行猜测版本号，按你当前 Agent 与项目的实际环境为准。

三、权限

文件读取：视任务而定，通常可选
文件写入：视任务而定，通常可选
Shell：视任务而定，通常可选，建议谨慎开放
网络：视任务而定，通常可选
Docker：官方未明确要求
GitHub：官方未明确要求

四、账号 / API Key

Skill 本身是否需要账号、API Key、Token，目前官方资料未明确说明。

需要区分两种情况：Skill 自身可能不需要凭证；但你后续让 Agent 处理的 Airflow、Astronomer 或云平台项目，可能需要相应的连接配置和凭证。这些属于你项目侧的凭证需求，不是 Skill 的固有要求。

最小使用条件

一个支持 Skill 的 AI Agent
可以正常安装该 Skill
明确你想处理的数据工程 / Airflow 相关任务

Skill 安装、使用与卸载教程

一、安装

本页面已经提供该 Skill 的安装指令，直接复制并粘贴到对应 Agent 或终端执行即可，不需要在正文里再重复完整的克隆、复制、配置流程。

如果你不确定自己的 Agent 该如何安装，可以直接问当前 Agent：

如何安装 astronomer/agents#blueprint？

如何在 Claude Code 中安装 astronomer/agents#blueprint？

如何在 Cursor 中安装 astronomer/agents#blueprint？

让 Agent 根据自己的 Skill 加载 / 管理机制给出对应步骤，通常比套用其他 Agent 的命令更稳妥。

如果该 Skill 存在特殊官方要求，请以官方仓库当前说明为准。

二、安装后如何使用

安装完成后，通常不需要额外启动命令。在支持 Skill 的 Agent 中，当你提出与数据工程、Airflow、数据编排相关任务时，Agent 会按照该 Skill 提供的指令来组织回答或操作。

触发方式一般有两种：Agent 自动识别相关任务后应用，或者你在提示中显式点名使用该 Skill。后者更稳定。

适合交给它的任务类型：数据管道规划、Airflow DAG 思路梳理、任务依赖设计、数据编排方案的初稿。

使用示例：

使用 blueprint，帮我梳理这条数据管道从采集到入库的 DAG 结构。

使用 blueprint，帮我检查这个 Airflow 任务的依赖关系是否合理。

使用 blueprint，把这份数据处理需求整理成可以继续开发的任务拆解。

三、卸载

卸载方式取决于你使用的 Agent。不同 Agent 的 Skill 安装位置和管理机制不同，可能没有统一的卸载命令。

可以尝试的做法：

使用对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill
删除对应的 Skill 文件 / 目录
直接询问当前 Agent：“如何卸载 astronomer/agents#blueprint？”

如果无法确认官方卸载命令，不要套用其他 Skill 的命令，直接询问当前 Agent 通常更稳妥。

常见问题

1. 安装后 Agent 没识别这个 Skill，怎么办？

先确认安装位置是否符合当前 Agent 的 Skill 目录约定，再确认 Agent 是否开启了 Skill 加载能力。不同 Agent 对 Skill 的识别方式不同，直接问当前 Agent“为什么没有识别到 astronomer/agents#blueprint”通常能更快定位问题。

2. 可以同时装到 Claude Code 和 Cursor 吗？

可以分别在各 Agent 中安装。每个 Agent 的 Skill 管理是独立的，互不影响。具体安装路径和方式以各 Agent 当前版本为准。

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

取决于你的安装方式是固定版本还是跟随仓库更新。如果是直接引用仓库内容，可能需要更新本地副本；如果是通过 Agent 的 Skill 管理器安装，看它是否提供更新机制。

4. 这个 Skill 会修改我已有的项目代码吗？

Skill 本身是指令集，是否修改代码取决于 Agent 被授予的权限和你的指令。如果不希望自动改动，可以在 Agent 中关闭自动写入 / 自动执行权限，改为手动确认每一步。

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

安装过程需要访问 GitHub 等来源，网络是否顺畅取决于你的环境。实际使用阶段是否联网，取决于具体任务与 Agent 配置。

6. 它和普通 Agent 直接回答数据工程问题有什么区别？

区别在约束方式。普通 Agent 是自由发挥，这个 Skill 提供了更贴近 Astronomer 数据编排实践的结构。具体效果以你的实际任务和 Skill 当前内容为准。

7. 适合在生产环境直接使用吗？

建议把它的输出当作方案草稿或开发辅助，而不是直接上线的成品。生产环境的改动仍应由人工评审、测试后再执行。

Skill 更新日志

版本列表

astro-airflow-mcp-0.9.1 最新 2026-07-08

补丁版本：修复了在 FastMCP 3.4.3+ 下插件 `/mcp/v1/` 端点上的 `421 Misdirected Request` 问题，并将 `fastmcp` 固定在一个有界范围内。 ## 自 0.9.0 以来的修复内容 ### 修复来自 FastMCP 主机守卫的 `421 Misdirected Request`（#241） FastMCP 3.4.3 默认启用了 `HostOriginGuardMiddleware`：它只接受回环 `Host` 头（`127.0.0.1`/`localhost`/`::1`）以及 ASGI `scope["server"]` 主机，对其他任何内容返回 `421 Misdirected Request`。在插件模式下，MCP 应用嵌入在 Airflow webserver 中，并通过 Deployment 自身的主机名访问，因此在未固定版本、解析到 fastmcp 3.4.3 的安装中，对 `/mcp/v1/` 的每个请求都被以 421 拒绝。 - 插件现在保持守卫**启用**，但将 `allowed_hosts` 限定为 Deployment 的主机名，从 `AIRFLOW__WEBSERVER__BASE_URL` 环境变量读取（该变量在插件导入时存在，不同于 Airflow 的 `conf`）。DNS 重绑定保护保持开启，而不是被关闭。 - `ASTRO_MCP_ALLOWED_HOSTS`（逗号分隔）可为自定义域名覆盖允许列表；仅当无法推导出主机名时（非 Astro 嵌入），插件才回退到禁用守卫。 - 独立模式（`mcp.run`）不变——它保持 FastMCP 的默认回环保护，这正是本地绑定服务器所需的。 - 固定 `fastmcp>=3.4.3,<4`，使行为确定，不会在 FastMCP 下一次默认翻转时悄然改变。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.9.1' af ``` ## 升级说明如果你曾临时固定 `fastmcp<3.4.3` 作为变通方案，升级到 0.9.1 后可以去掉该固定。

astro-airflow-mcp-0.9.0 2026-06-30

次要版本：现在每个 MCP 工具都返回结构化的、可供 agent 操作的错误，并带有 MCP 安全注解，此外 `af runs list` 新增了结束日期过滤器。 ## 自 0.8.2 以来的新内容 ### 结构化工具错误 + MCP 安全注解（#221）工具此前将所有失败都折叠为裸的 `str(e)`——agent 无法区分错误的 `dag_id`（修正参数并重试）与 Airflow 不可达（停止并上报），因为两者都返回相同的不透明字符串。 - **错误即数据。** 现在每个工具都返回 `error`、`error_type`、`hint`、`retryable` 标志，以及回显的标识参数（例如 `dag_id`）。`retryable` 将调用方可修复的问题（错误参数、400/404/429）与硬性阻塞（认证、5xx、只读、不可达）区分开，因此 agent 知道修正后的重试是否有帮助。对 `ReadOnlyError`、`NotFoundError`、Astro 认证错误、`httpx` 状态码、超时和传输错误进行分类。 - **所有 34 个工具上的安全注解。** 27 个读取标记为只读 + 幂等；7 个写入带有准确的提示——`delete_dag_run` 破坏性 + 非幂等，`clear_*` 破坏性 + 幂等，`pause`/`unpause` 幂等，`trigger*` 非幂等。客户端可以在调用*之前*对写入进行门控，补充现有的 `AF_READ_ONLY` 守卫（后者仅在模型决定调用*之后*才拒绝）。默认谨慎：只有当工具明确选择加入时，才会被宣传为“安全”。 - **凭据卫生。** `normalize_airflow_url` 现在从 netloc 中剥离 `user:password@`（主机/端口/IPv6 原样保留），因此凭据不会泄漏到日志或错误消息中嵌入的 URL 里。向后兼容——`str(e)` 始终保留在 `error` 内，因此任何 grep 旧裸字符串响应的消费者仍可工作；新消费者可获得结构化字段。 ### `af runs list` 的 `--end-date-gte` / `--end-date-lte` 过滤器（#233）按运行*结束*时间过滤运行，与现有的 `--start-date-*` 过滤器对应——对于“过去 N 分钟内哪些运行完成了以及它们如何结束”的恢复扫描很有用。ISO 8601 时间戳；`--dag-id` 可选。关闭 #225。 ```bash # 在某个时间窗口内完成、并结合状态的运行 af runs list --end-date-gte 2026-06-10T15:00:00Z --state failed ``` ## 安装 ``` uvx --from 'astro-airflow-mcp==0.9.0' af ``` ## 升级说明可直接替换 0.8.2——仅新增，无破坏性变更。结构化错误负载是旧字符串的超集（`str(e)` 保留在 `error` 中），因此现有消费者不受影响；新消费者可以读取结构化字段。

astro-airflow-mcp-0.8.2 2026-05-08

补丁版本：修复当环境中设置了 `ASTRO_API_TOKEN` 时 `af instance discover` 静默报告“No instances discovered”的问题。 ## 自 0.8.1 以来的修复内容 - **解析 astro CLI 表格输出时跳过前导行**（#213）：当设置了 `ASTRO_API_TOKEN` 时，astro CLI 会在 stdout 前加上 `Using an Astro API Token`。af 表格解析器将该行当作表头行，把每个 `astro deployment list` 行折叠为名为 `using_an_astro_api_token` 的单列，并丢弃每个 deployment——discover 会静默返回零个实例。解析器现在从顶部逐行遍历，并选择第一个边界检测出 2+ 列的行作为真正的表头，因此 astro CLI 输出的任何单行前导都会被自动跳过。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.2' af ``` ## 升级说明可直接替换 0.8.1。无配置或 CLI 变更。任何在 shell 中设置了 `ASTRO_API_TOKEN` 时遇到 `No instances discovered` 的人现在都能正确看到 deployments。

astro-airflow-mcp-0.8.1 2026-05-05

补丁版本：修复针对 webserver URL 带有 `?orgId=…` 查询字符串的 Astro deployments 的版本检测。 ## 自 0.8.0 以来的修复内容 - **从 Airflow URL 中剥离查询字符串 / 片段**（#210）：Astro 发现有时返回 `webserver_url=https://host/dep?orgId=org_…`。由于 API URL 是通过字符串拼接构建的（`f"{airflow_url}/api/v2/version"`），结果是 `https://host/dep?orgId=org_…/api/v2/version`，API 路径被吞入查询字符串，破坏了版本检测以及随后的每次 API 调用。新的 `normalize_airflow_url()` 辅助函数剥离查询、片段和尾部斜杠，应用于四个边界：`discovery/astro_cli.py`（在源头）、`adapters/base.py`（适配器构造函数）、`adapters/airflow_v3.py`（令牌交换）和 `adapters/__init__.py`（`detect_version`）。 - **更好的版本检测错误**：`detect_version` 现在收集每个探测的失败并在 `RuntimeError` 消息中呈现（`Probes: /api/v2: HTTP 404; /api/v1: HTTP 502; ...`），而不是通用的“Failed to detect Airflow version”。还捕获了此前静默漏过的 `200 但非 JSON 正文` 情况。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.1' af ``` ## 升级说明可直接替换 0.8.0。无配置或 CLI 变更。已将 `?orgId=…` 烘焙进其存储的 `airflow_url` 的现有用户不再需要重新运行 `af discover`——该值在读取时被规范化。

astro-airflow-mcp-0.8.0 2026-05-04

分层配置版本。`af` 现在跨全局、项目共享和项目本地文件读取和写入配置（镜像 `git config` 的 system/global/local 模型），并与 astro-cli 在 `~/.astro/` 共享配置主目录。 ## 自 0.7.0 以来的新内容 - **分层配置**（#207）：三个作用域与 astro-cli 的配置树共置 - 全局：`~/.astro/config.yaml`（每用户） - 项目共享：`/.astro/config.yaml`（已提交；团队共享） - 项目本地：`/.astro/config.local.yaml`（gitignored；每开发者当前实例） - `` 通过从 cwd 向上查找 `.astro/` 找到。项目内的写入路由：`add` / `discover` → 项目共享，`use` → 项目本地。用 `--global` / `--project` / `--local` 覆盖。`AF_CONFIG=` 完全绕过分层。 - 读取优先级：项目本地 > 项目共享 > 全局。较窄作用域中的同名实例会遮蔽。 - **默认全局路径移动**从 `~/.af/config.yaml` 到 `~/.astro/config.yaml`。旧路径作为一次性只读回退被尊重（带有 stderr 弃用提示）。运行 `af migrate` 进行显式迁移并保留 `.bak`。 - **新命令**： - `af migrate`：幂等。报告 `migrated` / `already-migrated` / `nothing-to-migrate`。 - `af instance show `：`git config --show-origin` 风格的查找，报告实例来自哪个文件。 - **`af instance list`** 现在包含作用域和来源列，并用 `*` 标记当前实例。 - **`save()` 与外部顶层键合并**（`project`、`cloud`、`contexts`、`telemetry.notice_shown`），以便 `af` 和 astro-cli 可以共存于同一文件。往返时保留文件模式；新文件以 0600 写入。 - **Skill**：在 `astro dev init` 上停止固定 Airflow 版本（#206）。修复了模型尽管 CLI 默认使用最新版却传递 `--airflow-version 3.1.0` 的幻觉。 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.8.0' af ``` ## 升级说明 - 现有 `~/.af/config.yaml` 用户：不会破坏任何东西。`af` 将其作为回退读取。方便时运行 `af migrate`。它会合并到 `~/.astro/config.yaml`，保留那里已有的任何 astro-cli 内容，并将旧文件重命名为 `.bak`。 - 在 astro 项目内，`af instance add` 现在默认写入 `.astro/config.yaml`（已提交）。凭据优先使用 `${ENV_VAR}` 插值或 `astro_pat`，或传递 `--local` 用于 gitignored 机密，或 `--global` 用于个人配置。 - `AF_CONFIG=` 和 `AF_CONFIG=/dev/null` 语义不变。

astro-airflow-mcp-0.7.0 2026-05-01

PAT 认证重写（#204）的稳定版本，加上 OSError 后续修复（#205） ## 自 0.6.4 以来的新内容 - `af instance discover astro` 现在通过 Auth0 刷新令牌交换复用用户的 `astro login` 会话，而不是铸造永久 `DEPLOYMENT_ADMIN` 令牌。发现的 deployments 使用 `auth.kind = astro_pat`，且从不将令牌写入 af 的配置 - 现有的 `kind = token` 和 `kind = basic` 实例保持不变继续工作（向后兼容） - 401 重试路径，带一次强制刷新，去抖动为每 60 秒一次 - 轮换的刷新令牌在 flock 下持久化回 `~/.astro/config.yaml`，以免 astro CLI 自身的会话中断 - `astro_context` 在发现时始终固定（避免 `astro context switch` 后的跨租户令牌泄漏） - 朴素的 `expiresin` 字符串锚定到 UTC（纵深防御） - `_read_yaml` 捕获 `FileNotFoundError`、`NotADirectoryError`、`IsADirectoryError`，因此非文件的 `ASTRO_HOME` 路径会呈现干净的“run astro login”错误，而不是被掩盖的版本检测失败 ## 验证 - 490 个单元测试通过；CI 在所有矩阵条目上绿色（py3.10/11/12，AF2/AF3 集成） - 完整破坏测试组（约 30 个场景）针对 0.7.0a1 和 0.7.0a2 运行干净 - 使用 otto agent 针对 AF3 云 deployment 和本地 AF2 独立版进行端到端测试 - 所有测试中未铸造任何 deployment 令牌 ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0' af ``` ## 升级说明 - 如果你有由旧 `af instance discover astro` 铸造的 deployment 令牌的现有 af 配置，它们继续工作。你可以不管它们，或重新运行 discover（如果传递 `--overwrite`，它会覆盖为 PAT 支持的实例） - 留在你的 astro deployments 中的现有 `af-discover-*` 令牌现在是孤儿。方便时在 astro UI 中撤销它们

astro-airflow-mcp-0.7.0a2 2026-05-01

后续 alpha，在 0.7.0a1 之上捆绑来自 #205 的 OSError 修复 ## 自 0.7.0a1 以来的新内容 - `_read_yaml` 现在捕获表示“无可读 astro 配置”的特定 OSError 形态（`FileNotFoundError`、`NotADirectoryError`、`IsADirectoryError`），而不是泄漏到 `detect_version` 成为被掩盖的“Failed to detect Airflow version”（#205） - `PermissionError` 和其他意外 OS 错误会传播，以便清晰呈现，而不是死胡同到“run astro login” ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0a2' af ```

astro-airflow-mcp-0.7.0a1 2026-05-01

PAT 认证重写（PR #204）的 alpha 版本，用于在 otto 中测试后再提升为 0.7.0 稳定版 ## 新内容 - `af instance discover astro` 现在通过 Auth0 刷新令牌交换复用用户的 `astro login` 会话，而不是铸造永久 `DEPLOYMENT_ADMIN` 令牌 - 实例配置中新增 `auth.kind = astro_pat`；现有 `token` / `basic` 实例保持不变继续工作 - 401 重试路径，带一次强制刷新，去抖动为每 60 秒一次 - 轮换的刷新令牌在 flock 下持久化回 ~/.astro/config.yaml，以免 astro CLI 自身的会话中断 - 朴素的 `expiresin` 字符串锚定到 UTC（针对手工编辑的纵深防御） ## 安装 ``` uvx --from 'astro-airflow-mcp==0.7.0a1' af ``` ## 为什么是 alpha 发布 alpha 以在提升为 0.7.0 之前，用 otto 的包装器（通过 uvx 固定 af）进行端到端验证

astro-airflow-mcp-0.6.4 2026-04-27

## 变更内容 * 在 `runs trigger-wait` 中检测暂停的 DAG，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/190 * af CLI：将空的 AIRFLOW_API_URL 视为显式无操作，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/191 * af CLI：当 AF_CONFIG 指向非普通文件时不要崩溃，作者 @kaxil，见 https://github.com/astronomer/agents/pull/193 * 修复 list_dag_runs（MCP 工具 + af CLI）返回最旧运行在前的问题，作者 @JoaVirtudes19，见 https://github.com/astronomer/agents/pull/192 ## 新贡献者 * @JoaVirtudes19 在 #192 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.3...astro-airflow-mcp-0.6.4

astro-airflow-mcp-0.6.3 2026-04-16

## 变更内容 * 扩展插件模式文档，包含 Astro 认证、角色和故障排除，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/184 * 为 MCP 服务器添加 Airflow 2.x 插件模式支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/186 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.2...astro-airflow-mcp-0.6.3

astro-airflow-mcp-0.6.2 2026-04-14

## 变更内容 * 修复远程部署的 Airflow MCP 插件模式，作者 @kaxil，见 https://github.com/astronomer/agents/pull/183 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.6.1...astro-airflow-mcp-0.6.2

astro-airflow-mcp-0.6.1 2026-04-13

## Bug 修复 - 修复当配置文件包含不同实例的凭据时的环境变量认证（#181） - 修复：从 TERMINAL_DAG_RUN_STATES 中移除 upstream_failed（#166）

astro-airflow-mcp-0.6.0 2026-03-17

## 新内容 ### `af registry` — 查询 Airflow Provider Registry（#145）四个新的 CLI 命令，可直接从终端浏览 [Airflow Provider Registry](https://airflow.apache.org/registry)——无需运行中的 Airflow 实例： - `af registry providers` — 列出所有 providers（id、name、version、lifecycle） - `af registry modules ` — 列出 operators、hooks、sensors 和 transfers - `af registry parameters ` — 显示 provider 类的构造函数参数 - `af registry connections ` — 显示连接类型及其字段支持 `--version` 固定到特定 provider 发布版，结果本地缓存（最新版 1 小时，版本化快照 30 天）。使用 `--no-cache` 绕过。 ```bash af registry modules amazon | jq '.modules[] | select(.type == "hook") | .name' af registry parameters ftp | jq '.classes | keys[]' ``` ### 改进 - 为 `list_dag_runs` MCP 工具添加 `dag_id` 过滤器（#163） - 澄清 `get_dag_stats` 需要 `dag_ids` 作为列表（#162） ### 修复 - 使发现令牌名称用户特定以避免冲突（#156） - 修复 airflow-adapter skill frontmatter（#147） **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.5.1...astro-airflow-mcp-0.6.0

astro-airflow-mcp-0.5.1 2026-03-02

## 变更内容 * 改进 agent 检测，作者 @schnie，见 https://github.com/astronomer/agents/pull/141 * 分离 agent 和 ci_system 属性，作者 @schnie，见 https://github.com/astronomer/agents/pull/142 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.5.0...astro-airflow-mcp-0.5.1

astro-airflow-mcp-0.5.0 2026-02-26

## 变更内容 * fix：运行 --plugin-dir 时加载 hooks，作者 @milton-li，见 https://github.com/astronomer/agents/pull/102 * 确保 airflow mcp 包高效使用 uvx 缓存，作者 @schnie，见 https://github.com/astronomer/agents/pull/100 * fix：从 skill 参考文件中移除 doctoc 目录，作者 @kaxil，见 https://github.com/astronomer/agents/pull/107 * 基于早期用户反馈改进 authoring-dags skill，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/104 * 添加 `af` CLI 遥测，作者 @schnie，见 https://github.com/astronomer/agents/pull/106 * 在 skills 中使用 `af` cli，作者 @milton-li，见 https://github.com/astronomer/agents/pull/108 * docs：在 README 中添加缺失的 skills，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/112 * 重构 skill hooks 并扁平化 analyzing-data 脚本，作者 @milton-li，见 https://github.com/astronomer/agents/pull/113 * docs：为 Airflow 2→3 迁移添加共享工具导入破坏性变更，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/111 * 将 init skill 重命名为 warehouse-init，作者 @kaxil，见 https://github.com/astronomer/agents/pull/114 * 添加 BigQuery 作业标签支持并修复 location 参数 bug，作者 @kaxil，见 https://github.com/astronomer/agents/pull/118 * 添加 Snowflake query_tag 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/119 * 添加 Postgres application_name 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/120 * 修复 `cosmos-dbt-core/SKILL.md`，作者 @tatiana，见 https://github.com/astronomer/agents/pull/122 * 进一步改进 Cosmos skills，作者 @tatiana，见 https://github.com/astronomer/agents/pull/123 * feat：添加部署管理 agents，作者 @kh3dron，见 https://github.com/astronomer/agents/pull/121 * fix：为自签名证书添加 SSL 证书验证绕过，作者 @kaxil，见 https://github.com/astronomer/agents/pull/126 * 触发前自动取消暂停 DAG，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/127 * docs：澄清 Snowflake 账户标识符格式，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/130 * 移除写入键，作者 @schnie，见 https://github.com/astronomer/agents/pull/128 * feat：添加 `af runs delete` 和 `af runs clear` 命令，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/129 * 迁移到 prek.toml 配置进行静态检查，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/131 * 为 MCP 工具调用添加遥测跟踪，作者 @schnie，见 https://github.com/astronomer/agents/pull/134 * 将遥测配置移入 config.yaml，作者 @schnie，见 https://github.com/astronomer/agents/pull/135 * 从 mypy 迁移到 ty 进行类型检查，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/133 * 处理 Copilot 关于类型安全的反馈，作者 @kaxil，见 https://github.com/astronomer/agents/pull/139 * 实现 AF_READ_ONLY 模式以阻止写操作，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/138 ## 新贡献者 * @tatiana 在 https://github.com/astronomer/agents/pull/122 中做出首次贡献 * @kh3dron 在 https://github.com/astronomer/agents/pull/121 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/plugin-0.2.0...astro-airflow-mcp-0.5.0

plugin-0.2.0 2026-02-05

## Claude 插件发布自初始发布以来的首次版本号提升，反映累积的变更： ### 新 Skills - Cosmos 集成 - Airflow HITL（Human-in-the-Loop） - 血缘注解 - 最佳实践 - Airflow 2-3 迁移 - 以及更多... ### 改进 - 用于 skill 建议的 hook 改进 - 用于 Astro deployments 的 `af` CLI 集成 - 多数据库支持（Snowflake、BigQuery 等） ### 安装 ```bash claude plugin marketplace add astronomer/agents claude plugin install data@astronomer ``` 或更新现有安装： ```bash claude plugin marketplace update astronomer/agents ```

astro-airflow-mcp-0.4.1 2026-02-04

## 变更内容 * feat(skills)：更新 testing-dags 以使用 af CLI，作者 @kaxil，见 https://github.com/astronomer/agents/pull/75 * refactor(cli)：用子命令替换 `af api` 标志，作者 @kaxil，见 https://github.com/astronomer/agents/pull/76 * 添加血缘注解和 OpenLineage extractor skills，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/66 * 在根 README 中添加 af CLI 文档，作者 @schnie，见 https://github.com/astronomer/agents/pull/78 * feat(cli)：为 list 命令添加过滤选项，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/79 * docs：添加社区健康文件，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/80 * docs：添加 CODE_OF_CONDUCT.md，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/81 * 在 README 中添加路线图部分，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/74 * 添加 `af instance discover` 命令以自动发现 Astro deployments，作者 @schnie，见 https://github.com/astronomer/agents/pull/63 * Skill：Airflow HITL，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/95 * Skill：更新 airflow 2-3 迁移 skill，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/99 * Skill：Cosmos，作者 @igorastronomer，见 https://github.com/astronomer/agents/pull/96 ## 新贡献者 * @igorastronomer 在 https://github.com/astronomer/agents/pull/95 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.4.0...astro-airflow-mcp-0.4.1

astro-airflow-mcp-0.4.0 2026-01-31

## 变更内容 * 更好地支持 airflow skill，作者 @schnie，见 https://github.com/astronomer/agents/pull/65 * fix：为 uvx af CLI 使用 @latest 后缀以防止陈旧版本问题，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/68 * fix：配置加载失败时警告而不是静默回退，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/70 * feat(cli)：添加 `af api` 命令以直接访问 Airflow REST API，作者 @kaxil，见 https://github.com/astronomer/agents/pull/73 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.3.0...astro-airflow-mcp-0.4.0

astro-airflow-mcp-0.3.0 2026-01-30

## 变更内容 * 将 astro-dwh-mcp 切换为从 git 标签动态版本化，作者 @schnie，见 https://github.com/astronomer/agents/pull/46 * 提升 MCP 服务器版本标签，作者 @schnie，见 https://github.com/astronomer/agents/pull/47 * feat：airflow mcp skill 和 hook，作者 @milton-li，见 https://github.com/astronomer/agents/pull/45 * 添加 Cursor hooks 兼容性，作者 @kaxil，见 https://github.com/astronomer/agents/pull/50 * 添加 clear_task_instances MCP 工具以重试失败任务，作者 @petedejoy，见 https://github.com/astronomer/agents/pull/51 * 按域将 server.py 拆分为模块化工具文件，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/52 * 更新 pre-commit hooks，作者 @jedcunningham，见 https://github.com/astronomer/agents/pull/55 * 修复 skill hook 路径以解析到正确目录，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/56 * 为 analyzing-data skill 添加多数据库支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/57 * 为 analyzing-data skill 添加多数据库文档，作者 @kaxil，见 https://github.com/astronomer/agents/pull/58 * 将配置路径从 `~/.astro/ai/config/` 重命名为 `~/.astro/agents/`，作者 @kaxil，见 https://github.com/astronomer/agents/pull/59 * 通过 SQLAlchemy 连接器添加 Redshift 支持，作者 @kaxil，见 https://github.com/astronomer/agents/pull/60 * 用统一方言注册表重构 SQLAlchemy 连接器，作者 @kaxil，见 https://github.com/astronomer/agents/pull/61 * 添加 Airflow API Skill，作者 @schnie，见 https://github.com/astronomer/agents/pull/53 * 添加 CLI 命令并修复 CI 构建，作者 @schnie，见 https://github.com/astronomer/agents/pull/62 ## 新贡献者 * @petedejoy 在 https://github.com/astronomer/agents/pull/51 中做出首次贡献 * @jedcunningham 在 https://github.com/astronomer/agents/pull/55 中做出首次贡献 **完整变更日志**：https://github.com/astronomer/agents/compare/astro-airflow-mcp-0.2.3...astro-airflow-mcp-0.3.0

astro-airflow-mcp-0.2.3 2026-01-23

该版本暂未提供更新说明。

暂无评论

暂无评论...