Skills Astronomer

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

Tạo các sổ tay công thức đã được xác minh từ các AIP có triển khai PR (chế độ post) hoặc các câu chuyện người dùng suy đoán từ các AIP chưa có triển khai (chế độ pre). Sử dụng…

agents/skills/airflow

Truy vấn, quản lý và khắc phục sự cố DAG, lần chạy, tác vụ và cấu hình hệ thống Apache Airflow. Hỗ trợ hơn 30 lệnh bao gồm kiểm tra DAG, quản lý lần chạy, ghi nhật ký tác vụ, truy vấn cấu hình và truy cập trực tiếp REST API. Quản lý nhiều phiên bản Airflow với cấu hình liên tục; tự động phát hiện triển khai cục bộ và Astro. Kích hoạt chạy DAG đồng bộ (chờ hoàn thành) hoặc không đồng bộ, chẩn đoán lỗi, xóa lần chạy để thử lại, và truy cập nhật ký tác vụ với bộ lọc thử lại/ch

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

Mẫu adapter Airflow cho khả năng tương thích API v2/v3. Sử dụng khi làm việc với các adapter, phát hiện phiên bản, hoặc thêm các phương thức API mới cần hoạt động trên…

agents/skills/airflow-hitl

Cổng phê duyệt của con người, đầu vào biểu mẫu và phân nhánh trong DAG Airflow sử dụng các toán tử có thể trì hoãn. Bốn loại toán tử: ApprovalOperator cho quyết định phê duyệt/từ chối, HITLOperator cho lựa chọn nhiều tùy chọn với biểu mẫu, HITLBranchOperator cho định tuyến tác vụ do con người điều khiển và HITLEntryOperator cho thu thập dữ liệu biểu mẫu. Tất cả các toán tử đều có thể trì hoãn, giải phóng slot worker trong khi chờ phản hồi của con người qua tab Required Actions của giao diện Airflow hoặc REST API. Hỗ trợ các tính năng tùy chọn bao gồm tùy chỉnh...

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

Hướng dẫn triển khai SDK ngôn ngữ hoàn toàn mới cho Airflow (AIP-108). Sử dụng kỹ năng này khi người đóng góp muốn thêm hỗ trợ cho một ngôn ngữ lập trình mới —…

agents/skills/airflow-plugins

Xây dựng plugin Airflow 3.1+ nhúng ứng dụng FastAPI, trang UI tùy chỉnh, thành phần React, middleware, macro và liên kết toán tử trực tiếp vào giao diện Airflow. Sử dụng…

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

Thêm hoặc cập nhật bản dịch cho giao diện Apache Airflow. Hướng dẫn thiết lập ngôn ngữ, tạo khung tệp dịch, dịch với ngôn ngữ cụ thể…

agents/skills/analyzing-data

Truy vấn kho dữ liệu của bạn để trả lời các câu hỏi kinh doanh với các mẫu đã lưu trong bộ nhớ đệm và ánh xạ khái niệm. Hỗ trợ tra cứu mẫu và lưu vào bộ nhớ đệm cho các loại câu hỏi lặp lại, với ghi nhận kết quả để cải thiện các truy vấn trong tương lai. Bao gồm bộ nhớ đệm ánh xạ khái niệm sang bảng và khám phá lược đồ bảng qua INFORMATION_SCHEMA hoặc tìm kiếm trong mã nguồn. Cung cấp các hàm kernel run_sql() và run_sql_pandas() trả về DataFrame Polars hoặc Pandas để phân tích. Các lệnh CLI để quản lý bộ nhớ đệm khái

agents/skills/annotating-task-lineage

Chú thích các tác vụ Airflow với dòng dữ liệu (data lineage) bằng cách sử dụng inlets và outlets. Hỗ trợ các đối tượng Dataset của OpenLineage, Assets của Airflow và Datasets của Airflow để xác định đầu vào và đầu ra trên các cơ sở dữ liệu, kho dữ liệu và lưu trữ đám mây. Sử dụng như phương án dự phòng khi các toán tử thiếu bộ trích xuất OpenLineage tích hợp sẵn; tuân theo hệ thống ưu tiên bốn cấp, trong đó các bộ trích xuất tùy chỉnh và phương thức OpenLineage được ưu tiên. Bao gồm các trình trợ giúp đặt tên dataset cho Snowflake, BigQuery, S3 và PostgreSQL để đảm bảo tính nhất quán...

agents/skills/authoring-dags

Quy trình làm việc có hướng dẫn để tạo DAG Apache Airflow với tích hợp xác thực và kiểm thử. Phương pháp sáu giai đoạn có cấu trúc: khám phá môi trường và các mẫu hiện có, lập kế hoạch cấu trúc DAG, triển khai theo các phương pháp tốt nhất, xác thực bằng lệnh CLI af, kiểm thử với sự đồng ý của người dùng, và lặp lại các bước sửa lỗi. Các lệnh CLI để khám phá (af config connections, af config providers, af dags list) và xác thực (af dags errors, af dags get, af dags explore) cung cấp phản hồi tức thì về 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

Viết logic tác vụ Airflow bằng Java, Kotlin hoặc bất kỳ ngôn ngữ JVM nào sử dụng Airflow Java SDK. Sử dụng khi người dùng muốn triển khai các tác vụ Airflow bằng Java/JVM, yêu cầu…

agents/skills/authoring-language-sdk-tasks

Nền tảng trung lập về ngôn ngữ cho các SDK ngôn ngữ của Airflow — triển khai logic tác vụ bằng ngôn ngữ không phải Python trong khi DAG vẫn giữ bằng Python. Sử dụng khi người dùng…

agents/skills/blueprint

Xác định các mẫu nhóm tác vụ Airflow có thể tái sử dụng với xác thực Pydantic và soạn DAG từ YAML. Sử dụng khi tạo mẫu blueprint, soạn DAG từ…

astronomer/.agents/skills/chart-tests

Sử dụng khi viết, chỉnh sửa, xem xét hoặc chạy các bài kiểm tra biểu đồ Helm cho kho lưu trữ Astronomer APC. Bao gồm các mẫu pytest, cách sử dụng render_chart(), biểu đồ con…

agents/skills/checking-freshness

Kiểm tra độ tươi mới của dữ liệu bằng cách đối chiếu dấu thời gian bảng và mẫu cập nhật với thang đo độ cũ. Xác định các cột dấu thời gian sử dụng các mẫu đặt tên ETL phổ biến (_loaded_at, _updated_at, created_at, v.v.) và truy vấn giá trị tối đa của chúng để xác định tuổi. Phân loại dữ liệu thành bốn trạng thái độ tươi mới: Tươi (< 4 giờ), Cũ (4–24 giờ), Rất cũ (> 24 giờ) hoặc Không xác định (không tìm thấy dấu thời gian). Cung cấp các mẫu SQL để kiểm tra thời gian cập nhật cuối cùng và xu hướng số lượng hàng trong những ngày gần đây để...

astronomer/.agents/skills/circleci

Sử dụng khi viết, chỉnh sửa hoặc xem xét cấu hình CircleCI cho kho lưu trữ Astronomer APC. Bao gồm tổ chức script, script nội tuyến so với script bên ngoài, và…

agents/skills/configuring-airflow-language-sdks

Cấu hình Airflow để chạy các tác vụ SDK ngôn ngữ (Go và các SDK gốc trong tương lai) — đăng ký một bộ điều phối, ánh xạ một hàng đợi tới nó, đảm bảo runtime/artifact trên worker,…

agents/skills/cosmos-dbt-core

Chuyển đổi các dự án dbt Core thành DAGs hoặc TaskGroups của Airflow bằng Astronomer Cosmos. Hỗ trợ ba mẫu lắp ráp: DbtDag độc lập, DbtTaskGroup trong các DAG hiện có và các toán tử Cosmos riêng lẻ để kiểm soát chi tiết. Chọn từ tám chế độ thực thi (WATCHER, LOCAL, VIRTUALENV, KUBERNETES, AIRFLOW_ASYNC và các chế độ khác) dựa trên nhu cầu cách ly và hiệu suất. Cung cấp ba chiến lược phân tích cú pháp (dbt_manifest, dbt_ls, dbt_ls_file, tự động) để cân bằng giữa tốc độ và độ phức tạp của bộ chọn...

agents/skills/cosmos-dbt-fusion

Cấu hình Astronomer Cosmos cho các dự án dbt Fusion trên Snowflake, Databricks, BigQuery hoặc Redshift với thực thi cục bộ. Yêu cầu Cosmos 1.11.0+, tệp nhị phân dbt Fusion được cài đặt riêng trong thời gian chạy Airflow và ExecutionMode.LOCAL với lệnh gọi quy trình con. Hỗ trợ ba chiến lược phân tích: dbt_manifest (nhanh nhất cho dự án lớn), dbt_ls (cho bộ chọn phức tạp) hoặc tự động (thiết lập đơn giản). Bao gồm thiết lập ProfileConfig cho kết nối kho dữ liệu, ProjectConfig cho đường dẫn dự án dbt và...

agents/skills/creating-openlineage-extractors

Các extractor OpenLineage tùy chỉnh cho các toán tử Airflow không được hỗ trợ và các kịch bản lineage phức tạp. Hai cách tiếp cận: thêm các phương thức OpenLineage trực tiếp vào các toán tử bạn sở hữu (khuyến nghị), hoặc tạo các extractor tùy chỉnh cho các toán tử bên thứ ba mà bạn không thể sửa đổi. Extractor can thiệp vào quá trình thực thi toán tử tại ba điểm: trước khi thực thi để lấy lineage tĩnh, sau khi thành công để lấy đầu ra được xác định trong thời gian chạy, và tùy chọn sau khi thất bại để lấy lineage một phần. Đăng ký extractor thông qua airflow.cfg hoặc môi trường...

agents/skills/dag-factory

Tác giả Apache Airflow DAGs một cách khai báo với cấu hình YAML dag-factory. Sử dụng khi tạo mẫu dag-factory, soạn DAGs từ YAML cho dag-factory,…

agents/skills/debugging-dags

Phân tích nguyên nhân gốc rễ có hệ thống và khắc phục cho các DAG Airflow bị lỗi với quy trình điều tra có cấu trúc. Hướng dẫn qua quy trình chẩn đoán bốn bước: xác định lỗi, trích xuất chi tiết lỗi, thu thập thông tin ngữ cảnh và đưa ra các bước khắc phục khả thi. Phân loại lỗi thành bốn loại (dữ liệu, mã, cơ sở hạ tầng, phụ thuộc) để tập trung điều tra và đề xuất các bản sửa lỗi phù hợp. Cung cấp các lệnh CLI sẵn sàng sử dụng để truy xuất nhật ký, so sánh lần chạy, xóa tác vụ và DAG...

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

Triển khai Airflow DAGs và các dự án. Sử dụng khi người dùng muốn triển khai mã, đẩy DAGs, thiết lập CI/CD, triển khai lên môi trường sản xuất hoặc hỏi về các chiến lược triển khai…

agents/skills/deploying-go-sdk-bundles

Xây dựng, đóng gói và triển khai các gói Airflow Go SDK đã biên dịch để ExecutableCoordinator có thể chạy chúng. Sử dụng khi người dùng muốn biên dịch một gói tác vụ Go, yêu cầu…

agents/skills/deploying-java-sdk-bundles

Xây dựng và triển khai các gói Java SDK của Airflow đã được biên dịch để workers có thể chạy chúng. Sử dụng khi người dùng muốn đóng gói một bundle tác vụ JVM thành JAR, hỏi về…

agents/skills/discovering-data

Khám phá và tìm hiểu dữ liệu cho một khái niệm hoặc lĩnh vực. Sử dụng khi người dùng hỏi dữ liệu nào tồn tại cho một chủ đề (ví dụ: "ARR", "khách hàng", "đơn hàng"), muốn tìm…