Skill: kansodata/kansodata-airflow-readonly (version 0.1.0)

# Airflow Read-Only Skill ## Propósito Esta skill permite consultar Apache Airflow mediante la Stable REST API `/api/v2` en modo solo lectura. Está diseñada para inspección operativa y diagnóstico, sin ejecutar mutaciones sobre DAGs, runs ni tasks. ## Cuándo usar esta skill Usa esta skill cuando necesites: - Listar DAGs disponibles. - Revisar ejecuciones (DAG runs) de un DAG específico. - Revisar task instances dentro de un DAG run específico. No uses esta skill para: - Disparar ejecuciones de DAG. - Pausar, reanudar, borrar o modificar recursos. - Cambiar configuración de Airflow. ## Prerrequisitos Antes de usarla, confirma: - El plugin `@kansodata/openclaw-airflow-plugin` está instalado y activo en OpenClaw. - Existe configuración válida para conexión al host de Airflow. - Existe autenticación válida (por ejemplo, bearer token) para consultar `/api/v2`. Si falta configuración o credenciales, repórtalo explícitamente y no improvises valores. ## Tools disponibles (mapeo exacto) Esta skill usa únicamente estas tools del plugin: - `airflow.list_dags` - `airflow.list_dag_runs` - `airflow.list_task_instances` No asumas ni menciones tools adicionales. ## Flujo recomendado Sigue este orden para mantener contexto y trazabilidad: 1. Descubrir DAG con `airflow.list_dags`. 2. Consultar ejecuciones del DAG con `airflow.list_dag_runs` usando `dag_id` exacto. 3. Consultar tasks del run con `airflow.list_task_instances` usando `dag_id` y `dag_run_id` exactos. Si un paso no devuelve datos, informa el resultado y detén el encadenamiento hasta confirmar el identificador correcto. ## Reglas operativas - Mantén el comportamiento estrictamente read-only. - No prometas acciones de escritura ni cambios de estado. - No asumas estados cuando faltan datos. - Usa identificadores exactos (`dag_id`, `dag_run_id`) sin normalizaciones inventadas. - Entrega respuestas compactas y accionables. - Si no hay resultados, decláralo claramente. - Si hay error de autenticación o configuración, repórtalo tal cual. ## Límites y seguridad - Alcance limitado a consultas de lectura sobre Airflow `/api/v2`. - Prohibido sugerir o simular mutaciones (trigger, pause, delete, patch, update). - Ante errores de auth/config/host, prioriza transparencia del error sobre respuestas especulativas. ## Estilo de salida esperado - Resumen corto al inicio. - Listas breves cuando aplique. - Identificadores exactos cuando existan. - Sin ruido ni texto decorativo. ## Ejemplos de prompts (español) - "Lista los DAGs disponibles en Airflow y muéstrame solo `dag_id` y estado." - "Para el DAG `daily_ingestion`, dame los últimos 5 DAG runs ordenados por fecha." - "En el DAG run `scheduled__2026-04-08T03:00:00+00:00` de `daily_ingestion`, lista task instances con estado y duración." - "Primero busca DAGs que contengan `sales`, luego toma el DAG más relevante, revisa sus runs más recientes y finalmente muestra las tasks del último run fallido." - "Consulta `airflow.list_dag_runs` para `finance_etl` y si no hay resultados, indícalo explícitamente sin asumir errores."


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)