SuperAPI AI 工具集

authoring-dags

写作与研究

查看项目

更新于 10-15 17:20

技能介绍

用途:该技能指导按最佳实践创建并校验 Airflow DAG,适用于新建 DAG、编写管道代码,以及回答 DAG 模式相关问题。测试与调试 DAG 由 testing-dags 技能负责(涵盖 测试→调试→修复→重测 流程)。

主要流程:分为六阶段。1)发现:用文件工具查找 /dags//*.py,阅读相似 DAG,检查 requirements.txt;用 af config connections、af config variables、af config providers、af config version、af dags list、af config pools 了解环境。2)规划:提出 DAG 结构、任务依赖、调度、所用 operator、所需连接、变量与包,并取得用户批准。3)实现:在合适位置创建 DAG 文件,必要时更新 requirements.txt。4)校验:先 af dags errors 检查解析错误,再 af dags get <dag_id>、af dags warnings、af dags explore <dag_id>。5)测试:见 testing-dags,需用户同意后执行,如 af runs trigger-wait <dag_id> --timeout 300。6)迭代:修复后重新校验与测试。

Astro 相关:可用 astro dev parse 在本地做解析检查;用 astro deploy --dags 进行仅 DAG 的快速部署。

CLI 运行前提:命令假设 af 在 PATH 中,可通过 astro otto 自动获取,或用 uv tool install astro-airflow-mcp 单独安装。

限制与说明:具体代码模式与反模式见 reference/best-practices.md(含 Airflow 3 特定行为);调试见 debugging-dags,部署见 deploying-airflow,迁移见 migrating-airflow-2-to-3。其他细节暂未提供。