Trích xuất mẫu SQL lịch sử
Skill dành cho ktx: đọc shard truy vấn SQL lịch sử, phát hiện các ý định phân tích lặp lại trên nhiều bảng và phát ra bằng chứng mẫu đã được xác minh.
Dữ liệu · Phân tíchNâng cao★ 1,566⑂ 101Điểm AI 8/10Cập nhật lần cuối: 19 thg 7, 2026
Nó làm được gì
- Đọc shard template SQL dạng
patterns-input/part-0001.jsonvà tìm các ý định phân tích lặp lại trải trên từ hai bảng trở lên. - Đóng gói mỗi ý định thành đối tượng bằng chứng
pattern(slug,title,narrative,definitionSql,tablesInvolved,slRefs...) rồi gọiemit_historic_sql_evidence. - Bắt buộc giao thức xác minh định danh:
discover_datađể tìm wiki/nguồn đã có,entity_detailsđể xác nhận schema/bảng/cột và cả hai phía của khóa join,sql_executionđể kiểm tra giá trị literal. - Định danh không xác minh được phải ghi
[unverified - from <rawPath>]hoặc đưa lỗi probe vàoemit_unmapped_fallback. - Ranh giới rõ ràng: không được gọi
wiki_write,sl_write_source,sl_edit_source, không tạo mẫu chỉ có một bảng.
Phù hợp với ai
- Nhóm dùng pipeline
memory_agentcủa ktx để tự động xây wiki tri thức cho data warehouse. - Data platform engineer muốn tài liệu hóa các mẫu join/aggregate phổ biến từ log truy vấn cũ.
- Người lo LLM bịa ra bảng/cột không tồn tại trong tài liệu dữ liệu.
Ví dụ sử dụng
- Mẫu vòng đời đơn hàng: gộp nhiều template join
ordersvớicustomersthành một patternorder-lifecycle-analysisrồi phát bằng chứng. - Xác minh khóa join: trước khi viết
c.id = o.customer_id, kiểm tra cả hai cột bằngentity_details, xem FK/PK và sampleValues. - Chặn định danh giả: nếu bảng không resolve, chạy
SELECT 1 FROM <ref> LIMIT 0; nếu lỗi thì coi là hư cấu và ghi lỗi vào fallback.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/Kaelio/ktx/HEAD/packages/cli/src/skills/historic_sql_patterns/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục packages/cli/src/skills/historic_sql_patterns từ repo GitHub Kaelio/ktx vào ~/.claude/skills/historic-sql-patterns/ 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.
Cài bằng lệnh thủ công
git clone https://github.com/Kaelio/ktx.git && mkdir -p ~/.claude/skills/historic_sql_patterns && cp -r ktx/packages/cli/src/skills/historic_sql_patterns/* ~/.claude/skills/historic_sql_patterns/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Clone repo:
git clone https://github.com/Kaelio/ktx.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills/historic_sql_patterns - Sao chép tệp:
cp -r ktx/packages/cli/src/skills/historic_sql_patterns/* ~/.claude/skills/historic_sql_patterns/ - Kiểm tra tệp
~/.claude/skills/historic_sql_patterns/SKILL.mdđã tồn tại. - Khởi động lại Claude Code và xác nhận
historic_sql_patternsxuất hiện trong danh sách skill. - Lưu ý: skill chỉ hoạt động khi có các tool của ktx CLI như
read_raw_file,entity_details,emit_historic_sql_evidence. Cài riêng lẻ sẽ không dùng được, cần dựng cả pipeline ktx.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0