Trình tóm tắt mức sử dụng bảng SQL lịch sử
Skill pipeline biến một file JSON bảng do adapter historic-sql tạo ra thành bằng chứng 'table usage' có kiểu rõ ràng.
Dữ liệu · Phân tíchNâng cao★ 1,571⑂ 101Điểm AI 7/10Cập nhật lần cuối: 3 thg 9, 2026
Làm được gì
Đọc đúng một file tables/<schema>.<name>.json do adapter historic-sql chuẩn bị, rồi tóm tắt cách bảng đó thực sự được truy vấn thành một mô tả ngắn kèm các trường có cấu trúc.
- Thứ tự đọc: ghi chú WorkUnit → file JSON bảng → chỉ xem
manifest.jsonkhi thiếu dialect - Ánh xạ
columnsByClause.wherethành filter phổ biến,groupBythành group-by,observedJoinsthành join - Chọn
frequencyTier(high/mid/low/unused) dựa trên bucket số lần chạy, số người dùng và độ mới - Gọi
emit_historic_sql_evidencevớikind: "table_usage"đúng một lần rồi dừng - Cấm rõ ràng: không ghi wiki, không sửa SL source, không phát nhiều bằng chứng, không tự bịa cột/join/bảng
- Giao thức xác minh định danh: dùng
discover_data,entity_detailsvà probesql_executionđể kiểm traschema.table.columncó tồn tại thật; nếu không, đánh dấu[unverified - from <rawPath>]
Phù hợp với ai
- Lập trình viên vận hành hoặc mở rộng pipeline memory agent của ktx (Kaelio)
- Nhóm data platform tự động sinh tài liệu schema kho dữ liệu từ log truy vấn
- Người muốn học mẫu thiết kế chống ảo giác (hallucination) tên bảng/cột của LLM
Ví dụ sử dụng
- File
tables/public.orders.jsonthay đổi → skill phát một bằng chứng với mô tả "được truy vấn liên tục cho phân tích vòng đời paid/refunded",frequencyTier: "high", filterstatus,created_at. - Bảng không còn template gần đây → đặt
frequencyTier: "unused"vàstaleSince, rồi dừng. - Không rõ giá trị
tiertrongpublic.planscó thật hay không → chạy probeSELECT DISTINCT tier ... LIMIT 50để xác minh trước khi ghi.
· · · 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_table_digest/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_table_digest từ repo GitHub Kaelio/ktx vào ~/.claude/skills/historic-sql-table-digest/ 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 /tmp/ktx && mkdir -p ~/.claude/skills/historic_sql_table_digest && cp -r /tmp/ktx/packages/cli/src/skills/historic_sql_table_digest/* ~/.claude/skills/historic_sql_table_digest/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo:
git clone https://github.com/Kaelio/ktx.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills/historic_sql_table_digest - Sao chép file:
cp -r ktx/packages/cli/src/skills/historic_sql_table_digest/* ~/.claude/skills/historic_sql_table_digest/ - Khởi động lại Claude Code và kiểm tra
historic_sql_table_digestxuất hiện trong danh sách skill. - Lưu ý: skill gọi các tool nội bộ của runtime ktx như
read_raw_file,emit_historic_sql_evidence,entity_details. Nếu chưa cài/cấu hình ktx CLI thì skill không chạy độc lập được.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0