managing-astro-deployments – Astro 部署管理 Skill

3周前更新 8 0 0 0

managing-astro-deployments 是用于指导 AI Agent 管理 Astronomer 平台 Astro 部署的运维型 Skill，可帮助完成部署配置、版本发布及相关运行状态管理，适合使用 Astro 编排 Airflow 工作流并需要自动化部署操作的场景。

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

Skill 安装

多 Agent 安装 
npx skills add https://github.com/astronomer/agents --skill managing-astro-deployments

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

Skill 调研报告

Skill 详细介绍

astronomer/agents#managing-astro-deployments 是什么

这是 Astronomer 官方 agents 仓库中提供的一个 Skill，名字是 managing-astro-deployments。从命名和组织归属来看，它面向的是 Astronomer 平台上的部署管理工作，也就是把与 Astro（Astronomer 的托管 Apache Airflow 服务）相关的部署流程，整理成 AI Agent 可以理解和执行的指令集。

它本身不是一个可以独立运行的软件，也不是一个 CLI 工具或安装包。按照 Agent Skill 的通用形态，它更接近一套结构化的指令与工作流说明：当你在支持 Skills 的 AI Agent 中加载它之后，Agent 会获得与 Astronomer 部署相关的操作知识和任务分解能力。

核心解决的问题

Airflow 在 Astronomer 平台上的部署并不只是“把代码推上去”这么简单，它通常涉及：

  • Astro 项目结构与环境配置
  • Deployment 的创建、更新、删除
  • DAG 部署与版本管理
  • 环境变量与连接配置
  • 部署状态排查

managing-astro-deployments 的价值，是把这些环节的知识固化成 Skill，让 Agent 在用户提出“帮我把这个 Airflow 项目部署到 Astro”这类需求时，能够按照规范流程去协助，而不是从零猜测命令。

它不是什么

  • 不是 Astronomer 官方 CLI（astro CLI）的替代品
  • 不是独立的部署引擎
  • 不会替你托管 Airflow
  • 不包含 Astronomer 平台的账号或计费能力

真正的部署动作仍然发生在 Astronomer 平台上，Skill 只是把 Agent 引导到正确的操作路径上。Skill 提供的是“怎么做、按什么顺序做”的知识，平台提供的是“实际执行”的能力。

典型任务与使用场景

  • 协助在 Astro 上创建或管理 Deployment
  • 把本地 Airflow 项目部署到 Astro 环境
  • 按要求组织项目结构、DAG 目录、依赖文件
  • 在部署出问题时引导排查方向
  • 把部署流程以自然语言方式讲清楚，降低上手门槛

适合谁

  • 使用 Astronomer / Astro 管理 Airflow 的团队
  • 希望用 AI Agent 辅助部署流程、减少手查文档的工程师
  • 刚开始接触 Astro 部署、需要流程引导的用户

不适合什么需求

  • 本地自建 Airflow、完全不使用 Astronomer 的场景
  • 需要真实部署执行、但不准备 Astronomer 账号的用户
  • 想找一个通用 Kubernetes / Docker 部署工具的用户

当前官方资料对 Skill 内部具体指令条目的公开描述有限，具体行为以该 Skill 当前官方说明为准。

Skill 安全评估

总体判断：来自 Astronomer 官方组织的 Skill，来源可信度较高；但它涉及部署操作，属于“能力较强、需要留意权限”的一类 Skill，而不是纯文本生成类 Skill。

关注点

  • 来源可信度：Skill 归属 astronomer/agents 官方仓库。只要从官方仓库安装，来源风险较低。
  • Shell 权限：部署类任务通常需要 Agent 运行命令（例如 astro 相关操作）。这是这类 Skill 的正常需求，但意味着 Agent 可能在你的机器上执行命令。
  • 凭证 / API Key：与 Astronomer 平台交互通常需要认证信息。这些凭证本身属于你与 Astronomer 之间的关系，Skill 不会凭空产生凭证，但 Agent 可能会在你授权后读取或使用它们。
  • 网络访问：与 Astronomer 平台通信需要联网。
  • 供应链风险：第三方 Skill 仓库始终存在被篡改或镜像替换的可能，关键是从官方来源安装。

降低风险的建议

  • 只从官方仓库安装，不使用来路不明的镜像或转载版本。
  • 如果不希望 Agent 自动执行命令，可以关闭自动执行 Shell 的权限，让 Agent 只给出命令、由你手动执行。
  • 在测试环境或非生产项目中先试用，确认行为符合预期后再用于生产部署。
  • 不要把生产环境的高权限凭证交给未经确认的 Agent 会话。

这不代表该 Skill 本身存在已知漏洞或恶意行为，而是提醒：部署类 Skill 天然拥有较高操作权限，权限管理和来源确认比“是否安全”的简单判断更重要。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Astronomer 官方 agents 仓库，属于通用的 Agent Skill 形态，官方未公布完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式看，凡是支持 Skills 或自定义指令加载机制的环境，通常都可以尝试使用：

  • Claude Code：作为常见 Skill 使用环境，可优先尝试
  • Codex、Cursor、Trae、OpenClaw、WorkBuddy：在支持 Skill / 自定义指令加载的前提下通常可尝试

不同 Agent 的加载方式与兼容程度可能不同，具体以对应 Agent 当前版本为准。官方是否明确支持某一具体 Agent，请以该 Skill 当前官方说明为准。

二、运行环境 / 依赖

项目 要求
Agent 支持 Skill / 自定义指令的 Agent
Astronomer 账号 执行真实部署时需要
Astronomer CLI（astro） 涉及本地与平台交互时通常需要
网络 与 Astronomer 平台通信时需要
Git 管理部署代码时常见需要

官方没有公开明确的最低版本要求，具体版本约束以该 Skill 当前官方说明为准。

三、权限

  • 文件读取：需要（读取项目与配置）
  • 文件写入：视任务而定，修改部署文件时可能需要
  • Shell：通常需要（执行部署相关命令）
  • 网络：需要（与 Astronomer 平台通信）
  • Docker：视本地运行 / 调试方式而定，非必需

四、账号 / API Key

Skill 本身不需要额外的账号或 API Key。但真实部署到 Astronomer 平台，需要你拥有 Astronomer 账号，并按平台方式完成认证。这部分凭证属于你与 Astronomer 之间的关系，不是 Skill 自带或内置的。

最小使用条件

  1. 一个支持 Skill 的 AI Agent
  2. 可联网环境
  3. 需要真实部署时，准备 Astronomer 账号与认证信息

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。如果不知道自己的 Agent 如何安装，直接问它就行：

如何安装 astronomer/agents#managing-astro-deployments？

如何在 Claude Code 中安装 astronomer/agents#managing-astro-deployments？

如何在 Cursor 中安装 astronomer/agents#managing-astro-deployments？

让当前 Agent 根据它自己的 Skill 加载 / 管理机制来指导安装即可。如果该 Skill 存在需要额外说明的官方安装条件，以官方仓库说明为准。

二、安装后如何使用

安装后，通常在对话中直接描述部署相关需求即可触发该 Skill。适合交给它的任务包括创建 / 管理 Astro Deployment、组织 Airflow 项目结构、排查部署问题等。用自然语言说清楚目标、项目位置和当前状态，效果最好。

示例：

使用 managing-astro-deployments，帮我把这个 Airflow 项目整理成可以部署到 Astro 的结构。

使用 managing-astro-deployments，说明在 Astro 上创建一个新 Deployment 需要哪些步骤。

使用 managing-astro-deployments，我的 DAG 部署后没生效，帮我列一下排查方向。

三、卸载

卸载方式取决于你使用的 Agent。常见做法是使用对应 Agent / Skill 管理器提供的删除功能移除该 Skill，或直接询问当前 Agent：

如何卸载 astronomer/agents#managing-astro-deployments？

不同 Agent 的 Skill 安装位置和管理方式可能不同，如果没有统一的卸载命令，直接让当前 Agent 帮你移除通常更稳妥。

常见问题

这个 Skill 和 astro CLI 是一回事吗？

不是。astro CLI 是执行部署的实际命令行工具，该 Skill 是让 AI Agent 理解和协助部署流程的指令集。两者可能配合使用，但定位不同。

不用 Astronomer，能用这个 Skill 吗？

它的核心围绕 Astronomer / Astro 平台的部署，脱离这个平台，它的价值有限。本地自建 Airflow 建议找对应场景的资料。

安装后 Agent 没识别到 Skill 怎么办？

先确认安装路径与加载方式是否符合当前 Agent 的规则，然后重载或重启 Agent 会话。仍不生效时，直接问当前 Agent“为什么没加载这个 Skill”通常能给出针对性答案。

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

通常可以，不同 Agent 的 Skill 目录相互独立，安装位置由各自机制决定。

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

取决于你使用的 Agent 如何管理 Skill。有的会跟随来源自动更新，有的需要手动重新拉取。以对应 Agent 当前机制为准。

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

与 Astronomer 平台通信需要能访问该平台。若本地网络访问受限，可能影响真实部署环节；纯流程问答一般不受明显影响。

它会直接改动我已有的项目吗？

是否改动取决于任务和 Agent 的权限设置。如果你不希望它自动改文件，可以关闭对应的写入或执行权限，让它先给出建议再手动执行。

Skill 更新日志

版本列表
astro-airflow-mcp-0.9.1 最新
补丁版本：修复了在 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
次要版本：现在每个 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
补丁版本：修复当环境中设置了 `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
补丁版本：修复针对 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
分层配置版本。`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
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
后续 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
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
## 变更内容 * 在 `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
## 变更内容 * 扩展插件模式文档，包含 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
## 变更内容 * 修复远程部署的 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
## Bug 修复 - 修复当配置文件包含不同实例的凭据时的环境变量认证（#181） - 修复：从 TERMINAL_DAG_RUN_STATES 中移除 upstream_failed（#166）
astro-airflow-mcp-0.6.0
## 新内容 ### `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
## 变更内容 * 改进 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
## 变更内容 * 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：添加 deployment 管理 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
## Claude 插件发布 自初始发布以来的首次版本号提升，反映累积的变更： ### 新 Skills - Cosmos 集成 - Airflow HITL（Human-in-the-Loop） - Lineage 注解 - 最佳实践 - 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
## 变更内容 * 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 * 添加 lineage 注解和 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
## 变更内容 * 更好地支持 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
## 变更内容 * 将 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
该版本暂未提供更新说明。

暂无评论

none
暂无评论...