📦 Airflow Read-Only Skill — Airflow只读查询

目的

本技能允许通过 Stable REST API /api/v2 以只读模式查询 Apache Airflow，专为运营检查与诊断设计，不对 DAG、run 或 task 执行任何变更操作。

何时使用本技能

在以下场景使用本技能：

• 列出可用 DAG。
• 查看某个 DAG 的执行（DAG runs）。
• 查看某个 DAG run 内的 task instances。

请勿用于：

• 触发 DAG 执行。
• 暂停、恢复、删除或修改资源。
• 更改 Airflow 配置。

前置条件

使用前请确认：

• 插件 @kansodata/openclaw-airflow-plugin 已在 OpenClaw 安装并启用。
• 存在有效的 Airflow 主机连接配置。
• 拥有有效的认证（如 bearer token）以访问 /api/v2。

若缺少配置或凭证，请明确报告，不得自行编造数值。

可用工具（精确映射）

本技能仅使用插件中的以下工具：

• airflow.list_dags
• airflow.list_dag_runs
• airflow.list_task_instances

不要假设或提及其他工具。

推荐流程

按以下顺序保持上下文与可追溯性：

• 用 airflow.list_dags 发现 DAG。
• 用 airflow.list_dag_runs 查询该 DAG 的执行，使用精确 dag_id。
• 用 airflow.list_task_instances 查询该 run 的 tasks，使用精确 dag_id 与 dag_run_id。

若某步无数据返回，请报告结果并停止链式调用，直至确认正确标识符。

操作规则

• 严格保持只读行为。
• 不承诺任何写入或状态变更操作。
• 数据缺失时不假设状态。
• 使用精确标识符（dag_id、dag_run_id），不得自行规范化。
• 提供简洁、可执行的回答。
• 无结果时明确声明。
• 出现认证或配置错误时如实报告。

限制与安全

• 仅限对 Airflow /api/v2 的只读查询。
• 禁止建议或模拟任何变更操作（trigger、pause、delete、patch、update）。
• 遇到 auth/config/host 错误时，优先透明报告错误，而非猜测性回答。

期望输出风格

• 开头给出简短摘要。
• 适用时提供简短列表。
• 存在时给出精确标识符。
• 去除冗余与装饰性文字。

示例提示（中文）

• “列出 Airflow 中可用 DAG，仅显示 dag_id 与状态。”
• “针对 DAG daily_ingestion，按时间倒序列出最近 5 个 DAG runs。”
• “在 daily_ingestion 的 DAG run scheduled__2026-04-08T03:00:00+00:00 中，列出 task instances 及其状态与耗时。”
• “先查找包含 sales 的 DAG，再取最相关者，查看其最近运行，最后展示最近一次失败 run 的 tasks。”
• “对 finance_etl 执行 airflow.list_dag_runs，若无结果请明确说明，勿自行推断错误。”