SuperAPI AI 工具集

authoring-dags

数据与分析

查看项目

更新于 10-15 23:46

技能介绍

用途:指导创建并验证 Apache Airflow DAG,遵循最佳实践,适用于用户想新建 DAG、编写管道代码或询问 DAG 模式时。

主要能力:围绕发现、计划、实现、验证、测试、迭代六阶段工作流展开。发现阶段用文件工具查找已有 DAG、阅读相似 DAG 了解约定、查看 requirements.txt,并用 af 命令了解环境:af config connections、af config variables、af config providers、af config version、af dags list、af config pools。计划阶段提出 DAG 结构、运算符、连接、变量和依赖包,取得用户批准后再实现。验证阶段先查解析错误 af dags errors,再 af dags get <dag_id>、af dags warnings、af dags explore <dag_id>。测试阶段需用户同意后触发:af runs trigger-wait <dag_id> --timeout 300,失败时用 af runs diagnose <dag_id> <run_id> 与 af tasks logs <dag_id> <run_id> <task_id> 排查。迭代阶段修复问题后重新验证与测试。

使用方式:命令假定 af 已在 PATH 上,可通过 astro otto 自动获得,或使用 uv tool install astro-airflow-mcp 独立安装。在 Astro 上还可用 astro dev parse 本地解析检查,用 astro deploy --dags 做仅 DAG 的快速部署。代码模式与反模式见 reference/best-practices.md,包含 Airflow 3 相关行为。

适用场景:编写新建 DAG、管道代码与 DAG 模式相关任务。

限制:测试需用户同意后才触发;测试、调试与修复循环的完整内容见 testing-dags 技能;故障排查见 debugging-dags;生产部署见 deploying-airflow;Airflow 2 到 3 迁移见 migrating-airflow-2-to-3。具体命令与参数以资料为准,其余细节暂未提供。