Astronomer 스킬

airflow/.agents/skills/aip-user-stories

AIP에서 PR 구현이 포함된 검증된 레시피 플레이북을 생성하거나(포스트 모드), 구현이 없는 AIP에서 추측성 사용자 스토리를 생성합니다(프리 모드). 사용…

agents/skills/airflow

Apache Airflow DAG, 실행, 작업 및 시스템 구성을 쿼리, 관리 및 문제 해결합니다. DAG 검사, 실행 관리, 작업 로깅, 구성 쿼리 및 직접 REST API 액세스에 걸쳐 30개 이상의 명령을 지원합니다. 지속적인 구성으로 여러 Airflow 인스턴스를 관리하고 로컬 및 Astro 배포를 자동으로 검색합니다. DAG 실행을 동기식(완료 대기) 또는 비동기식으로 트리거하고, 실패를 진단하고, 재시도를 위해 실행을 지우고, 재시도/맵 인덱스 필터링을 통해 작업 로그에 액세스합니다. 출력...

agents/astro-airflow-mcp/.claude/skills/airflow-adapter

Airflow 어댑터 패턴으로 v2/v3 API 호환성을 제공합니다. 어댑터, 버전 감지, 또는 여러 버전에서 작동해야 하는 새 API 메서드를 추가할 때 사용하세요.

agents/skills/airflow-hitl

인간 승인 게이트, 폼 입력, 그리고 지연 가능 연산자를 사용한 Airflow DAG 내 분기 처리. 네 가지 연산자 유형: 승인/거부 결정을 위한 ApprovalOperator, 폼을 통한 다중 옵션 선택을 위한 HITLOperator, 인간 주도 작업 라우팅을 위한 HITLBranchOperator, 폼 데이터 수집을 위한 HITLEntryOperator. 모든 연산자는 지연 가능하며, Airflow UI의 Required Actions 탭 또는 REST API를 통해 인간 응답을 기다리는 동안 작업자 슬롯을 해제합니다. 선택적 기능 지원 포함: 사용자 정의...

airflow/.agents/skills/airflow-java-sdk

Guide for contributing to the Airflow Java SDK (AIP-108). Use this skill whenever a contributor is working in the `java-sdk/` directory or on the Java…

airflow/.agents/skills/airflow-new-sdk

Airflow를 위한 완전히 새로운 언어 SDK(AIP-108)를 구현하는 가이드입니다. 기여자가 새로운 프로그래밍 언어에 대한 지원을 추가하려 할 때 이 스킬을 사용하세요 —…

agents/skills/airflow-plugins

Airflow 3.1+ 플러그인을 빌드하여 FastAPI 앱, 커스텀 UI 페이지, React 컴포넌트, 미들웨어, 매크로 및 연산자 링크를 Airflow UI에 직접 임베드합니다. 사용…

agents/skills/airflow-state-store

Persists task and asset state across retries and DAG runs using Airflow 3.3's AIP-103 key/value stores (`task_state_store`, `asset_state_store`) and the…

airflow/.agents/skills/airflow-translations

Apache Airflow UI에 대한 번역을 추가하거나 업데이트합니다. 로케일 설정, 번역 파일 스캐폴딩, 로케일별 번역 작업을 안내합니다…

agents/skills/analyzing-data

데이터 웨어하우스에 질의하여 캐시된 패턴과 개념 매핑을 통해 비즈니스 질문에 답변합니다. 반복되는 질문 유형에 대한 패턴 조회 및 캐싱을 지원하며, 결과 기록을 통해 향후 질의를 개선합니다. 개념-테이블 매핑 캐시와 INFORMATION_SCHEMA 또는 코드베이스 grep을 통한 테이블 스키마 탐색을 포함합니다. 분석을 위해 Polars 또는 Pandas DataFrame을 반환하는 run_sql() 및 run_sql_pandas() 커널 함수를 제공합니다. 개념, 패턴 및 테이블 캐시를 관리하기 위한 CLI 명령어와 추가 기능을 포함합니다.

agents/skills/annotating-task-lineage

Airflow 태스크에 인렛과 아웃렛을 사용하여 데이터 계보를 주석 처리합니다. 입력 및 출력을 데이터베이스, 데이터 웨어하우스, 클라우드 스토리지 전반에 걸쳐 정의하기 위해 OpenLineage Dataset 객체, Airflow Assets 및 Airflow Datasets를 지원합니다. 운영자에 내장된 OpenLineage 추출기가 없는 경우 대체 수단으로 사용되며, 사용자 정의 추출기와 OpenLineage 메서드가 우선 적용되는 4단계 우선순위 시스템을 따릅니다. Snowflake, BigQuery, S3 및 PostgreSQL에 대한 일관된 명명을 보장하는 데이터셋 명명 헬퍼를 포함합니다.

agents/skills/authoring-dags

Apache Airflow DAG 생성을 위한 안내 워크플로우로, 검증 및 테스트 통합을 포함합니다. 구조화된 6단계 접근 방식: 환경 및 기존 패턴 발견, DAG 구조 계획, 모범 사례에 따른 구현, af CLI 명령어로 검증, 사용자 동의 하에 테스트, 수정 반복. 발견을 위한 CLI 명령어(af config connections, af config providers, af dags list)와 검증을 위한 명령어(af dags errors, af dags get, af dags explore)는 DAG에 대한 즉각적인 피드백을 제공합니다...

agents/skills/authoring-go-sdk-tasks

Writes Airflow task logic in Go using the Airflow Go SDK. Use when the user wants to implement Airflow tasks in Go, asks about `BundleProvider`/`RegisterDags`,…

agents/skills/authoring-java-sdk-tasks

Airflow 작업 로직을 Java, Kotlin 또는 Airflow Java SDK를 사용하는 모든 JVM 언어로 작성합니다. 사용자가 Java/JVM에서 Airflow 작업을 구현하려 하거나, 요청할 때 사용합니다…

agents/skills/authoring-language-sdk-tasks

Airflow 언어 SDK를 위한 언어 중립적 기반 — DAG는 Python으로 유지하면서 비Python 언어로 작업 로직을 구현합니다. 사용자가...

agents/skills/blueprint

Pydantic 검증을 통해 재사용 가능한 Airflow 태스크 그룹 템플릿을 정의하고 YAML로 DAG를 구성합니다. blueprint 템플릿을 생성하거나 DAG를 구성할 때 사용합니다.

astronomer/.agents/skills/chart-tests

Astronomer APC 저장소의 Helm 차트 테스트를 작성, 편집, 검토 또는 실행할 때 사용합니다. pytest 패턴, render_chart() 사용법, 서브 차트 등을 다룹니다.

agents/skills/checking-freshness

테이블 타임스탬프와 업데이트 패턴을 확인하여 데이터 신선도를 검증하고, 부패 정도를 평가합니다. 일반적인 ETL 명명 패턴(_loaded_at, _updated_at, created_at 등)을 사용하여 타임스탬프 열을 식별하고, 최대값을 조회하여 데이터의 기간을 파악합니다. 데이터 신선도를 네 가지 상태로 분류합니다: 신선(4시간 미만), 부패(4~24시간), 매우 부패(24시간 초과), 또는 알 수 없음(타임스탬프 없음). 최근 며칠간의 마지막 업데이트 시간과 행 수 추세를 확인하기 위한 SQL 템플릿을 제공합니다.

astronomer/.agents/skills/circleci

Astronomer APC 저장소의 CircleCI 구성을 작성, 편집 또는 검토할 때 사용합니다. 스크립트 구성, 인라인 vs 외부 스크립트 등을 다룹니다.

agents/skills/configuring-airflow-language-sdks

Airflow가 언어 SDK 작업(Go 및 향후 네이티브 SDK)을 실행하도록 구성합니다 — 코디네이터 등록, 큐 매핑, 워커의 런타임/아티팩트 확인 등.

agents/skills/cosmos-dbt-core

dbt Core 프로젝트를 Astronomer Cosmos를 사용하여 Airflow DAG 또는 TaskGroup으로 변환합니다. 세 가지 어셈블리 패턴을 지원합니다: 독립형 DbtDag, 기존 DAG 내 DbtTaskGroup, 세밀한 제어를 위한 개별 Cosmos 연산자. 격리 및 성능 요구 사항에 따라 8가지 실행 모드(WATCHER, LOCAL, VIRTUALENV, KUBERNETES, AIRFLOW_ASYNC 등) 중에서 선택할 수 있습니다. 속도와 선택기 복잡성의 균형을 맞추기 위해 세 가지 파싱 전략(dbt_manifest, dbt_ls, dbt_ls_file, automatic)을 제공합니다...

agents/skills/cosmos-dbt-fusion

Astronomer Cosmos를 Snowflake, Databricks, BigQuery 또는 Redshift에서 dbt Fusion 프로젝트에 맞게 로컬 실행으로 구성합니다. Cosmos 1.11.0+ 필요, dbt Fusion 바이너리를 Airflow 런타임에 별도 설치, ExecutionMode.LOCAL 및 서브프로세스 호출 사용. 세 가지 파싱 전략 지원: dbt_manifest(대규모 프로젝트에 가장 빠름), dbt_ls(복잡한 선택기용), 또는 자동(간단한 설정). ProfileConfig를 통한 웨어하우스 연결 설정, ProjectConfig를 통한 dbt 프로젝트 경로 설정 등을 다룹니다.

agents/skills/creating-openlineage-extractors

지원되지 않는 Airflow 연산자와 복잡한 계보 시나리오를 위한 맞춤형 OpenLineage 추출기. 두 가지 접근 방식: 소유한 연산자에 직접 OpenLineage 메서드를 추가(권장)하거나, 수정할 수 없는 타사 연산자를 위한 맞춤형 추출기를 생성합니다. 추출기는 세 지점에서 연산자 실행을 가로챕니다: 정적 계보를 위한 실행 전, 런타임에 결정된 출력을 위한 성공 후, 그리고 선택적으로 부분 계보를 위한 실패 후. airflow.cfg 또는 환경을 통해 추출기를 등록합니다...

agents/skills/dag-factory

Apache Airflow DAG를 dag-factory YAML 설정으로 선언적으로 작성합니다. dag-factory 템플릿을 생성하거나, dag-factory용 YAML로 DAG를 구성할 때 사용합니다.

agents/skills/debugging-dags

체계적인 근본 원인 분석 및 구조화된 조사 워크플로를 통한 실패한 Airflow DAG의 문제 해결. 4단계 진단 프로세스를 안내합니다: 실패 식별, 오류 세부 정보 추출, 컨텍스트 정보 수집, 실행 가능한 수정 단계 제공. 실패를 네 가지 유형(데이터, 코드, 인프라, 종속성)으로 분류하여 조사에 집중하고 적절한 수정을 제안합니다. 로그 검색, 실행 비교, 작업 정리, DAG...을 위한 즉시 사용 가능한 CLI 명령을 제공합니다.

agents/skills/delegating-to-otto

Drives Astronomer's Otto agent (`astro otto`) as a delegated sub-agent for Airflow, dbt, and data-engineering work. Use when the user explicitly asks to "use…

agents/skills/deploying-airflow

Airflow DAG 및 프로젝트를 배포합니다. 사용자가 코드를 배포하거나, DAG를 푸시하거나, CI/CD를 설정하거나, 프로덕션에 배포하거나, 배포 전략에 대해 질문할 때 사용하세요.

agents/skills/deploying-go-sdk-bundles

컴파일된 Airflow Go SDK 번들을 빌드, 패킹 및 배포하여 ExecutableCoordinator가 실행할 수 있도록 합니다. 사용자가 Go 태스크 번들을 컴파일하려고 하거나 요청할 때 사용합니다.

agents/skills/deploying-java-sdk-bundles

컴파일된 Airflow Java SDK 번들을 빌드하고 배포하여 작업자가 실행할 수 있게 합니다. 사용자가 JVM 작업 번들을 JAR로 패키징하려 하거나, 이에 대해 질문할 때 사용하세요.

agents/skills/discovering-data

개념이나 도메인에 대한 데이터를 발견하고 탐색합니다. 사용자가 특정 주제(예: "ARR", "고객", "주문")에 어떤 데이터가 있는지 묻거나 찾고자 할 때 사용합니다.