1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | managed-airflow-migrations-google-skills |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/managed-airflow-migrations |
| 许可证 | Apache-2.0（GitHub API 获取，适用于整个仓库） |
| GitHub Stars | 19,010（GitHub API 获取；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,532（GitHub API 获取，同为合集整体数据） |
| 最新版本 | 无独立版本号；技能目录最近一次提交于 2026-08-06（GitHub API 获取） |
| 安装方式 | npx skills add google/skills 后勾选对应技能，或手动复制 skills/cloud/managed-airflow-migrations 目录 |
2. 功能介绍与亮点
这是一个专注于 Managed Service for Apache Airflow（MSAA，原 Cloud Composer）版本迁移的技能，指导把现有 DAG 代码适配到 Airflow 2.11.1（MSAA Gen 2/3）或 Airflow 3（MSAA Gen 3）。核心能力包括：
- 版本演进依赖映射表：按 Composer 具体小版本（2.10.0 → 2.15.3 → …）逐级列出 Google Provider、SSH Provider、HTTP Provider 等关键依赖的版本号变化与对应 breaking change，而不是笼统地说“检查兼容性”。
- 可直接执行的静态扫描命令：针对 Airflow 3 迁移的每一类 breaking change（禁止直连元数据库、核心 import 路径迁移到
airflow.sdk、Dataset→Asset重命名等）都配有可直接运行的grep -rn扫描命令与精确的新旧 API 映射表，而非泛泛建议。 - 本地验证闭环：额外提供基于 Composer Local Development CLI（
composer-dev）的本地验证流程，可在部署到目标环境前先跑通 DAG 解析与导入错误检查。 - 环境取证与下载：附带独立参考文档指导如何仅在用户明确要求时列出/下载源环境的 DAG、依赖与配置，避免技能默认执行不必要的取证操作。
3. 适用场景
所属分类：DevOps 与基础设施
适用于正在使用 Google Cloud Composer（Managed Service for Apache Airflow）、需要把生产 DAG 代码迁移到 Airflow 2.11.1 或 Airflow 3 的数据工程团队与平台运维人员：从确认源环境版本、逐条排查 breaking change、到本地验证迁移结果，均可按技能给出的分阶段流程执行，避免遗漏某个 Provider 版本引入的隐性不兼容。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | SKILL.md 遵循 Agent Skills 规范（YAML frontmatter + references/ 子目录），该规范由 Claude Code 率先定义并读取 |
| Codex | 原生支持 ✅ | Codex CLI 读取同一 SKILL.md 目录结构，属公开标准的通用兼容对象 |
| OpenClaw | 原生支持 ✅ | OpenClaw 采用相同的 AgentSkills SKILL.md 规范（name/description frontmatter），结构可直接迁移 |
| Hermes Agent | 原生支持 ✅ | 遵循 agentskills.io 开放标准，跨兼容框架可移植 |
⚠️ 本地验证环节依赖 Composer Local Development CLI（composer-dev），需额外安装；跳过本地验证不影响扫描与迁移映射等核心工作流。
5. 推荐理由
它把 Airflow 版本迁移这件容易漏检的事情，拆成了“按 Provider 版本逐级核对 breaking change → 用固定 grep 命令扫描代码 → 按映射表替换 API → 本地跑通验证”的确定性流程，省去了逐个翻阅多个 Provider 各自 changelog、手工比对新旧 API 的过程，尤其对从较早 Composer 版本一次性跳级迁移的场景价值明显。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Google 官方发布（第一方，google/skills 是 MSAA/Cloud Composer 所属厂商自建仓库）；本技能自身在第三方平台尚无独立评价或可查的采用数据，合集仓库整体 19,010 星属于整个仓库，不代表本技能自身热度 |
| 可用性 | 9 | 正文含分阶段流程 + 独立参考文档（Airflow 3 迁移检查、环境取证下载、本地开发验证），每类 breaking change 都配可直接运行的扫描命令与精确映射表；最近一次提交为 2026-08-06，维护活跃；无付费依赖（Composer 本身按量计费，非技能自身要求） |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅限 gcloud composer/gcloud storage/grep 等只读或本地文件操作，环境取证与文件下载明确要求“仅在用户要求时执行” |
| ② 运行时联网外发 | 仅访问 Google Cloud Composer 官方 API，外联目标透明 |
| ③ 凭据处理 | 依赖 gcloud 本地应用默认凭据，不落盘存储额外密钥 |
| ④ 可疑指令 | 未发现 prompt injection 或夹带无关推广内容 |
| ⑤ 作者信誉 | Google 官方仓库，无造假迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护 | 2026-08-06，活跃 |
综合评分：8.33（三项均值）
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| Airflow 2 to 3 Migration（第三方，独立发布） | 通用 Airflow 2→3 迁移助手，依赖 Ruff 迁移规则自动重写代码 | 面向通用自建 Airflow 部署，不覆盖 Managed Service for Apache Airflow 各 Composer 小版本对应的 Provider 依赖映射表 |
| Airflow Adapter（第三方，独立发布） | 提供统一接口让 Agent 跨 Airflow 2.x/3.x 版本操作 DAG（列出、触发运行） | 定位是运行时兼容层而非迁移工具，不提供静态代码扫描与逐版本 breaking change 核对 |
| airflow（astronomer 官方） | Astronomer（Airflow 商业化公司）发布的通用 Airflow 使用技能 | 面向 Astronomer 自家托管平台的日常开发与运维，未针对 Google Cloud Composer 的版本演进路径与 Provider 版本号做专门梳理 |
8. 用户评价
该技能所在的 google/skills 仓库尚处活跃开发阶段，目前在 GitHub Issues、Reddit、Hacker News 等平台尚无具名第三方用户对该技能本身的评价。
9. 其他补充
无。
10. 安装使用方式
方式一（推荐）：
npx skills add google/skills运行后在交互列表中勾选 “Managed Airflow Migrations”（即 managed-airflow-migrations）。
方式二（手动）：
git clone https://github.com/google/skills.git
cp -r skills/skills/cloud/managed-airflow-migrations ~/.claude/skills/安装后注意事项：
- 需已安装并登录
gcloudCLI（gcloud auth application-default login），并已开通 Cloud Composer API。 - 环境取证（列出/下载源环境 DAG 与依赖）默认不执行，仅在用户明确要求时才会运行。
- 若需本地验证迁移结果，需额外安装 Composer Local Development CLI（
composer-dev）；跳过不影响核心迁移映射流程。
11. 注意事项
- 技能专注于 DAG 代码层面的版本迁移映射与扫描，不负责实际部署新 Composer 环境或数据迁移。
- 依赖版本映射表覆盖的是官方仓库记录在案的 Composer 小版本路径，若源环境版本过旧、不在已记录的版本演进链上，需要人工补充核对中间版本的 breaking change。
- 本地验证依赖的
composer-dev工具需单独安装配置，技能正文未提供其安装步骤。