用途:该技能驱动 airflow-admin-pp-cli 二进制,对 Apache Airflow 做只读排查,用于列出 DAG、检查失败的 DAG 运行、查看任务实例状态、审阅池、验证 API 健康,以及在本地同步与搜索 Airflow 元数据。它是读取优先的工具,面向调查、分诊和报告;不会部署 DAG、修改调度、清除任务或变更 Airflow 状态。
安装:先确认 CLI 已安装,运行 airflow-admin-pp-cli --version 验证,并确保 $GOPATH/bin(或 $HOME/go/bin)在 $PATH 中。必要命令保持原样: npx -y @mvanhorn/printing-press-library install airflow-admin --cli-only 若 npx 安装失败,可回退到 Go 安装(需 Go 1.26.6 或更新): go install github.com/mvanhorn/printing-press-library/library/developer-tools/airflow-admin/cmd/airflow-admin-pp-cli@latest MCP 安装使用:go install github.com/mvanhorn/printing-press-library/library/developer-tools/airflow-admin/cmd/airflow-admin-pp-mcp@latest,再执行 claude mcp add airflow-admin-pp-mcp -- airflow-admin-pp-mcp。
认证:可用用户名密码换取 JWT,再存储令牌:airflow-admin-pp-cli apache-airflow-admin-auth --username <username> --password <password> --json 与 airflow-admin-pp-cli auth set-token YOUR_TOKEN_HERE;也可设置 AIRFLOW_ADMIN_BEARER_AUTH 环境变量。远端环境需设置 AIRFLOW_ADMIN_BASE_URL(默认 http://localhost:8080)。运行 airflow-admin-pp-cli doctor 验证配置。不要把凭据粘贴到仓库、issue、PR 或共享日志。
主要能力:dags get/list、dags dag-runs list/get/list-task-instances/get-task-instance、dags tasks list、dags details;pools get/list;connections 列表;variables 列表;apache-airflow-admin-version;monitor 健康检查。支持通过 airflow-admin-pp-cli which "<自然语言能力>" 匹配命令;退出码 0 表示有匹配,2 表示无可靠匹配。
用法要点:任意命令可加 --agent(展开为 --json --compact --no-input --no-color --yes);--select 可裁剪字段;--dry-run 预览请求;sync 与 search 可在有本地 SQLite 时离线使用;输出可包在含 meta.source(live 或 local)与 results 的信封中。--deliver 支持 stdout、file:<path>、webhook:<url>。可用 profile save/list/show/delete 保存常用参数组合。退出码:0 成功、2 用法错误、3 资源未找到、4 需认证、5 API 错误、7 限流、10 配置错误。
适用场景:数据团队日常巡检 DAG 与运行状态、定位失败任务、检查池与变量、通过本地同步做重复调查。
限制:只读,不改变 Airflow 状态;功能与命令细节以 CLI 实际帮助为准;具体收费、价格与部署平台暂未提供。