init – AI Agent 项目初始化配置 Skill

init 是用于初始化和管理 astronomer/agents 仓库中项目配置与依赖的 Skill，适合需要为 Agent 项目搭建标准化开发环境和目录结构的场景。

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

Agent 开发 AI 与 Agent # Apache Airflow # Astronomer # Claude Code # 初始化 # 项目脚手架

Skill 安装

多 Agent 安装

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

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

Skill 调研报告

Skill 详细介绍

astronomer/agents 是 Astronomer 官方维护的 Agent Skills 集合，init 是其中的一个 Skill（子目录 / Skill 名称），本页介绍的就是这个具体 Skill。

从唯一标志 astronomer/agents#init 可以提取：作者 / 组织为 Astronomer，仓库为 agents，Skill 为 init。Astronomer 是 Apache Airflow 背后的商业公司，长期维护 Airflow 生态与面向数据工程的工具链，因此该仓库的 Skill 通常围绕 Airflow / 数据管道 / 工程化工作流展开；init 这个名称通常指向“初始化 / 引导 / 脚手架”类的任务。

它是什么

一个 Agent Skill：以指令、流程说明和（可能的）辅助脚本形式存在，安装后被支持 Skill 机制的 AI Agent 加载。
从命名看，它面向的是“初始化 / 引导”场景——例如开始一个项目、初始化一个环境或生成一套起始结构。

它不是什么

不是独立可运行的软件，自身没有常驻进程、没有独立服务端。
不是 Airflow 本体，也不替代 Airflow；如果任务涉及真实的 Airflow 集群，仍然需要实际的 Airflow 环境与凭证。
不能在没有 Agent 的情况下单独“运行”。

核心用途与解决问题

安装后，Agent 会额外获得针对“初始化”类任务的结构化指导能力，典型方向是：

为某个工程 / 项目生成起始结构与配置骨架。
按 Astronomer / Airflow 的惯例引导初始化流程，减少从零手工搭建的重复劳动。
把“该怎么做”固化为可复用的流程，而不是每次重新描述。

适合谁

使用 Airflow / Astronomer 生态、需要快速起一个项目骨架的数据工程师。
希望把初始化流程标准化、可复用的团队。
已经在用 Claude Code 等支持 Skill 的 Agent、想扩展其工程化能力的用户。

不适合谁 / 不适用场景

只想让 Agent 做通用聊天或写作，不涉及项目初始化。
需要完整托管式数据平台能力，而不是一个 Skill 指令集的场景。

说明：当前官方仓库若未公开 init 的具体 SKILL.md 全文、确切命令和行为细节，本文不臆测其内部实现。以上能力边界基于该 Skill 的标识、所属仓库定位和命名作出的判断；具体功能以该 Skill 当前官方说明为准。如果官方文档与本文描述不一致，请以官方文档为准。

Skill 安全评估

总体判断：来源可信度较高，但因为名称指向“初始化”，此类 Skill 往往会建议或执行写文件、建目录、装依赖等操作，实际风险取决于它被授予的权限，而不是 Skill 名称本身。

一、来源可信度

来自 Astronomer 官方组织仓库，属于一手来源，相比来路不明的第三方重发版本更值得信任。
但“官方仓库里的某个 Skill”不等于“该 Skill 已被全面安全审计”。官方通常不会为每个 Skill 单独发布审计报告。
使用时请确认你的 Agent 安装的确实是 astronomer/agents#init，而不是同名或改名的镜像、Fork。

二、可能涉及的行为

文件写入 / 目录创建：初始化类任务通常需要创建文件与目录。这是它的正常用途，但会改动你的工作目录。
Shell 执行：初始化往往伴随命令执行（装依赖、跑脚手架）。若 Agent 拥有自动执行 Shell 的权限，Skill 建议的命令可能被直接执行。
依赖安装：安装的是命令行工具或包，存在常规供应链风险。
网络访问：拉取依赖、模板或文档时可能需要联网。
凭证：如果后续操作要连接真实 Airflow / 云环境，可能涉及 Token 或环境变量；这属于“被初始化的项目”的需要，而不是 Skill 本身。

三、实操降风险建议

如果不确定它要执行什么，先让 Agent 把计划中的命令和要创建的文件列出来，确认后再执行。
可以关闭 Agent 自动执行 Shell 的权限，让命令由你手动运行。
在干净的目录或新分支里做初始化，先不要直接改已有项目。
初始化前先确认工作目录状态（尤其是 git 状态），便于随时回退。
不要把生产环境的长期凭证放到临时初始化过程里。

没有“100% 安全”的 Skill。这里的合理结论是：官方来源、用途明确，按最小权限使用即可；风险主要来自执行与写入权限，而非 Skill 本身。

Skill 使用要求

一、Agent / 客户端

这一类 Skill 属于 Agent Skill 形态，需要 Agent 具备 Skill 加载 / 管理机制。
官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常也可以尝试在 Claude Code、Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 Agent 中使用；不同 Agent 的加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。
哪个“最适合”，取决于你的 Agent 是否原生支持该 Skill 目录结构；无法确认时，优先在你日常使用的 Agent 上尝试。

二、运行环境 / 依赖

以下为常见相关项，是否必需取决于该 Skill 当前官方说明的实际行为：

Agent	支持 Skill 机制的 Agent（如 Claude Code 等）
Git	通常需要（仓库类 Skill 的获取与管理）
Shell	初始化类任务可能用到
网络	需要拉取依赖 / 模板时

官方若未明确指定版本，本文不猜测具体 Node.js / Python 版本。

三、权限

文件读取：必需（读取 Skill 与项目文件）。
文件写入：很可能需要（初始化会创建文件 / 目录）。
Shell：可能是可选或需要，取决于你是否让它自动执行命令。
网络：拉取依赖时为必需，否则可选。
GitHub / 云凭证：仅在后续项目需要时才涉及，通常不是 Skill 本身的硬性要求。

四、账号 / API Key

Skill 本身通常不需要账号或 API Key。
它后续“初始化出来的项目”是否要凭证（如 Airflow、云服务、Astronomer 平台），取决于项目本身，与 Skill 无关。

最小使用条件

一个支持 Skill 的 Agent。
能访问该 Skill 来源（网络 / 已下载）。
对目标目录有写入权限。
按需决定是否开放 Shell 执行权限。

Skill 安装、使用与卸载教程

一、安装

本页已单独提供该 Skill 的安装指令，直接复制本页面的安装指令，粘贴到你的 Agent 或终端执行即可。

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

如何安装 astronomer/agents#init？

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

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

让 Agent 按自己的 Skill 加载 / 管理机制指导安装。若该 Skill 存在特殊官方安装条件，以官方说明为准。

二、安装后如何使用

安装后，在需要“初始化 / 引导 / 从一个空目录起项目”这类任务时，明确点名这个 Skill，让 Agent 调用它。

自然语言示例：

使用 init Skill，帮我把这个目录初始化成一个可用的 Airflow 项目骨架。

使用 init，先列出你打算创建哪些文件和执行哪些命令，我确认后你再动手。

用 init Skill 引导我完成这个项目的初始化，需要我提供的信息先问我。

建议在让它动手前，先让它输出计划，确认无误再执行，尤其是会写文件或跑命令的时候。

三、卸载

优先使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill。
没有统一卸载命令时，直接询问当前 Agent：

如何卸载 astronomer/agents#init？

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

常见问题

1. 这个 Skill 是不是只能配合 Astronomer / Airflow 用？
从仓库定位看它更贴近 Airflow / Astronomer 场景，但“初始化”类能力本身并不绝对绑定某个平台。是否适合你的项目，建议对照官方说明；官方若未明确限定，可以先用一个测试目录试一次再决定。

2. 安装后 Agent 没识别到这个 Skill，怎么办？
先确认安装路径是否是该 Agent 期望的 Skill 目录，并检查是否重启 / 重新加载了 Agent。不同 Agent 的加载机制不一样，最直接的方式是问当前 Agent：“为什么没加载 astronomer/agents#init？”，让它检查自己的 Skill 目录。

3. 它可以同时装到多个 Agent 里吗？
通常可以，各 Agent 各自管理自己的 Skill 目录，互不影响。但同一 Skill 在不同 Agent 上的行为可能略有差异，具体以对应 Agent 的加载方式为准。

4. 更新后需要重新安装吗？
取决于你的 Agent 是从本地目录加载还是从仓库拉取。如果是本地副本，通常需要你重新拉取 / 更新；如果 Agent 支持自动同步，可能不需要。以该 Agent 的机制为准。

5. 它会自动修改我现有的项目文件吗？
“初始化”本身以创建为主，但初始化逻辑是否会覆盖已有文件，取决于它的实现。稳妥做法：在新目录 / 新分支里运行，并在执行前先让它列出将创建或修改的文件。

6. 可以关掉 Shell 权限只用它生成代码 / 结构吗？
一般可以。多数初始化 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

## 变更内容 * 修复：运行 --plugin-dir 时加载 hooks，作者 @milton-li，见 https://github.com/astronomer/agents/pull/102 * 确保 airflow mcp 包高效使用 uvx 缓存，作者 @schnie，见 https://github.com/astronomer/agents/pull/100 * 修复：从 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 * 文档：向 README 添加缺失的 skills，作者 @tayloramurphy，见 https://github.com/astronomer/agents/pull/112 * 重构 skill hooks 并扁平化 analyzing-data 脚本，作者 @milton-li，见 https://github.com/astronomer/agents/pull/113 * 文档：向 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 * 修复：为自签名证书添加 SSL 证书验证绕过，作者 @kaxil，见 https://github.com/astronomer/agents/pull/126 * 触发前自动取消暂停 DAG，作者 @josh-fell，见 https://github.com/astronomer/agents/pull/127 * 文档：澄清 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） - 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 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 * 添加 lineage 注解和 OpenLineage 提取器 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 * 文档：添加社区健康文件，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/80 * 文档：添加 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 * 修复：为 uvx af CLI 使用 @latest 后缀以防止陈旧版本问题，作者 @jlaneve，见 https://github.com/astronomer/agents/pull/68 * 修复：配置加载失败时警告而不是静默回退，作者 @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

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

暂无评论

暂无评论...