Skills Astronomer

Generate verified recipe playbooks from AIPs with PR implementations (post mode), or speculative user stories from AIPs without implementations (pre mode). Use…

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…

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

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…

Airflow adapter pattern for v2/v3 API compatibility. Use when working with adapters, version detection, or adding new API methods that need to work across…

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...

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…

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…

Guide for implementing a brand-new language SDK for Airflow (AIP-108). Use this skill when a contributor wants to add support for a new programming language —…

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 —…

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…

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…

Add or update translations for the Apache Airflow UI. Guides through setting up locales, scaffolding translation files, translating with locale-specific…

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ể…

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

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...

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...

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`,…

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…

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…

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ừ…

Use when writing, editing, reviewing, or running Helm chart tests for the Astronomer APC repository. Covers pytest patterns, render_chart() usage, sub-chart…

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…

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 để...

Use when writing, editing, or reviewing CircleCI configuration for the Astronomer APC repository. Covers script organization, inline vs external scripts, and…

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à…

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,…

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...

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à...

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...

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,…

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...

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…

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…

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…

Builds and deploys compiled Airflow Java SDK bundles so workers can run them. Use when the user wants to package a JVM task bundle into a JAR, asks about the…

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…

Use when writing, editing, reviewing, or running functional (end-to-end) tests for the Astronomer APC repository. Covers scenario setup, testinfra patterns,…

Sử dụng khi viết, chỉnh sửa, xem xét hoặc chạy các bài kiểm tra chức năng (đầu cuối) cho kho lưu trữ Astronomer APC. Bao gồm thiết lập kịch bản, các mẫu testinfra,…

Sử dụng cho công việc với Helm chart - tạo chart, sửa đổi chart hiện có, thiết kế values, kiểm thử. Đối với kho lưu trữ Astronomer APC, xem docs/architecture.md để…

Khởi tạo khám phá lược đồ kho dữ liệu. Tạo tệp .astro/warehouse.md với tất cả siêu dữ liệu bảng để tra cứu tức thì. Chạy một lần cho mỗi dự án, làm mới khi lược đồ…

Khởi tạo khám phá lược đồ kho dữ liệu. Tạo tệp .astro/warehouse.md với tất cả siêu dữ liệu bảng để tra cứu tức thì. Chạy một lần cho mỗi dự án, làm mới khi lược đồ…

Adopt and maintain the apache-magpie framework in a project repo via the snapshot-based adoption mechanism. The only framework skill committed in an adopter's…

Áp dụng và duy trì framework apache-magpie trong kho dự án thông qua cơ chế áp dụng dựa trên snapshot. Kỹ năng framework duy nhất được cam kết trong…

Quản lý các deployment sản xuất Astronomer bằng Astro CLI. Sử dụng khi người dùng muốn xác thực, chuyển đổi không gian làm việc, tạo/cập nhật/xóa deployment, hoặc…

Quản lý môi trường phát triển Airflow cục bộ bằng các lệnh Astro CLI. Khởi động, dừng, khởi động lại và tắt các container Airflow cục bộ; thông tin đăng nhập mặc định là admin/admin với webserver tại http://localhost:8080 Xem nhật ký cho tất cả các thành phần hoặc các dịch vụ cụ thể (scheduler, webserver) với tùy chọn theo dõi thời gian thực Truy cập shell container và chạy các lệnh Airflow CLI trực tiếp qua astro dev bash và astro dev run Khắc phục các sự cố phổ biến bao gồm xung đột cổng, lỗi khởi động, lỗi gói, và...

Di chuyển các dự án Airflow từ airflow-ai-sdk sang apache-airflow-providers-common-ai 0.1.0+. Sử dụng kỹ năng này khi người dùng muốn thay thế airflow-ai-sdk bằng…

Phát hiện tự động và di chuyển mã để nâng cấp DAGs Apache Airflow 2.x lên Airflow 3.x. Cung cấp các quy tắc sửa lỗi tự động dựa trên Ruff (AIR30/AIR301/AIR302/AIR31/AIR311/AIR312) để phát hiện và giải quyết các thay đổi phá vỡ trong import, toán tử, hook và biến ngữ cảnh. Bao gồm các thay đổi kiến trúc quan trọng: worker không còn truy cập trực tiếp vào cơ sở dữ liệu metadata; sử dụng ứng dụng khách Python Airflow hoặc REST API thay vì truy vấn ORM session. Bao gồm danh sách kiểm tra di chuyển thủ công cho các vấn đề Ruff không thể tự động sửa: cron...

Guide for migrating Dagster projects to Apache Airflow 3 on Astro. Use when the user mentions migrating, converting, or porting Dagster (or Dagster+) code to…

Replace the manual commit-by-commit classification step in `breeze release-management prepare-provider-documentation` with AI-driven classification. For each…

Replace the manual commit-by-commit classification step in `breeze release-management prepare-provider-documentation` with AI-driven classification. For each…

Phân tích thống kê và chất lượng toàn diện các bảng cơ sở dữ liệu với đầu ra cấu trúc profiling. Tạo thống kê cấp cột phù hợp với kiểu dữ liệu: min/max/percentiles cho cột số, độ dài cho chuỗi, phạm vi ngày cho timestamp. Thực hiện phân tích cardinality để xác định cột phân loại so với cột cardinality cao và phát hiện phân phối lệch. Đánh giá chất lượng dữ liệu trên năm khía cạnh: tính đầy đủ (tỷ lệ NULL), tính duy nhất (trùng lặp), tính tươi mới (timestamp cập nhật),...

Khởi tạo và cấu hình các dự án Astro/Airflow với dependencies, kết nối và thiết lập môi trường. Tạo cấu trúc dự án hoàn chỉnh bằng lệnh astro dev init, bao gồm các thư mục cho DAG, plugin, kiểm thử và tệp cấu hình. Quản lý dependencies Python và hệ điều hành qua requirements.txt và packages.txt, hỗ trợ Dockerfile tùy chỉnh cho các thiết lập phức tạp. Cấu hình kết nối, biến và pool một cách khai báo trong airflow_settings.yaml, với các lệnh xuất/nhập cho môi trường...

Các chu trình kiểm tra-gỡ lỗi-sửa lỗi lặp đi lặp lại cho Airflow DAG với chẩn đoán lỗi toàn diện. Bắt đầu bằng af runs trigger-wait <dag_id> để chạy một DAG và chờ hoàn tất; không cần kiểm tra trước khi chạy. Khi gặp lỗi, sử dụng af runs diagnose để có bản tóm tắt lỗi toàn diện và af tasks logs để kiểm tra chi tiết lỗi từ các tác vụ cụ thể. Hỗ trợ cấu hình tùy chỉnh, thời gian chờ và số lần thử lại; xử lý các tình huống thành công, thất bại và hết thời gian chờ với diễn giải phản hồi rõ ràng. Có sẵn tính năng xác th

Use when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/). Covers where tools live, argument parsing with…

Truy xuất dòng dữ liệu xuôi dòng để đánh giá tác động của thay đổi trước khi sửa đổi bảng hoặc DAG. Xác định người tiêu dùng trực tiếp của bảng hoặc DAG mục tiêu thông qua tìm kiếm mã nguồn, phụ thuộc view và kết nối công cụ BI. Xây dựng cây phụ thuộc đầy đủ ánh xạ tất cả tác động xuôi dòng, từ bảng đến dashboard đến mô hình ML. Phân loại phụ thuộc theo mức độ quan trọng (quan trọng, cao, trung bình, thấp) để ưu tiên giao tiếp với các bên liên quan và kiểm thử. Tạo báo cáo tác động với đánh giá rủi ro, các thành phần bị

Truy xuất nguồn gốc dữ liệu thượng nguồn để xác định các nguồn, DAG và phụ thuộc cung cấp cho một bảng hoặc cột. Hỗ trợ truy xuất ba loại mục tiêu: bảng, cột và DAG; sử dụng mã nguồn DAG Airflow và kiểm tra tác vụ để tìm các pipeline sản xuất. Xử lý các nguồn SQL (mệnh đề FROM), hệ thống bên ngoài (S3, Postgres, Salesforce, HTTP API) và nguồn dựa trên tệp; truy xuất đệ quy các chuỗi thượng nguồn. Bao gồm truy xuất cấp cột thông qua ánh xạ trực tiếp, biến đổi và tổng hợp trong mã DAG...

Khắc phục sự cố triển khai sản xuất Astronomer bằng Astro CLI. Sử dụng khi điều tra các vấn đề triển khai, xem nhật ký sản xuất, phân tích lỗi, hoặc…

Upgrade the pinned Flask-AppBuilder (FAB) dependency in the Apache Airflow FAB provider (`providers/fab/`). Bumps the exact `flask-appbuilder==` pin and its…

Khởi tạo khám phá lược đồ kho dữ liệu. Tạo tệp .astro/warehouse.md chứa siêu dữ liệu tất cả bảng để tra cứu tức thì. Chạy một lần cho mỗi dự án, làm mới khi lược đồ…