Quy trình phân tích dữ liệu ktx

Skill này làm gì

Skill định nghĩa một quy trình chuẩn 7 bước để Claude trả lời mọi câu hỏi dữ liệu bằng các công cụ ktx MCP (discover_data, entity_details, dictionary_search, sl_query, sql_execution, memory_ingest).

• Bắt buộc khám phá → kiểm tra → lập kế hoạch → truy vấn → kiểm chứng → lưu kiến thức, không được đoán tên bảng hay tên cột.
• Ưu tiên semantic layer (measure/dimension) hơn SQL thô để định nghĩa chỉ số luôn thống nhất.
• Phần <sql_craft> là một bộ quy tắc dày dặn chống các lỗi SQL "chạy được nhưng kết quả sai": fan-out join làm phồng SUM, INNER JOIN bảng dimension làm mất hàng fact, phân tích số lưu dưới dạng text (1.2K, $1,200), bẫy frame RANGE khi tính running total, phép chia số nguyên trên postgres/sqlite, lọc trước window function, phân biệt macro/micro average.
• Yêu cầu liệt kê danh sách cột đầu ra trước khi viết SQL và chạy bước kiểm tra đầy đủ trước khi trả lời.

Phù hợp với ai

• Đội nhóm đã dùng ktx CLI/MCP và đã kết nối data warehouse (BigQuery, Postgres, Snowflake...).
• Data analyst/engineer hay để Claude viết SQL ad-hoc nhưng gặp cảnh con số lệch một cách âm thầm.
• Tổ chức muốn tích lũy định nghĩa chỉ số và các "bẫy schema" thành tri thức chung.

Ví dụ sử dụng

1. "Mỗi vùng có bao nhiêu đơn hàng chứa sản phẩm bị trả lại?" → skill gom order_lines về mức đơn hàng trước rồi mới join, tránh đếm trùng đơn có 2 dòng bị trả.
2. "Đơn đầu tiên của mỗi khách, chỉ tính từ 2024-01-01" → tính window trên toàn bộ partition rồi mới lọc ở query ngoài, nên "đơn đầu tiên" là đúng thật.
3. "Tổng doanh thu là bao nhiêu?" nhưng giá trị lưu là text '3M', '$1,200', '-' → skill chuẩn hóa trong một CTE (bỏ ký hiệu, nhân hệ số K/M/B, xử lý sentinel) để tổng không bị về 0 một cách âm thầm.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục packages/cli/src/skills/analytics từ repo GitHub Kaelio/ktx vào ~/.claude/skills/ktx-analytics/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.