القائمة
Hướng dẫn chạy Load Test và đo lường hiệu năng bằng công cụ k6.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Skill hướng dẫn triển khai và vận hành 6 trụ cột cốt lõi của pipeline NL2SQL: Schema Linking, Value Profiling, Ambiguity Detection, Generation Trace, Retry & Repair, Evaluation Suite. Triggers: Khi sửa schema, thêm bảng mới, nâng cấp prompt, thay LLM, debug SQL sai.
Skill hướng dẫn xây dựng và vận hành Semantic Layer (Lớp ngữ nghĩa doanh nghiệp). Giúp AI hiểu các khái niệm nghiệp vụ đặc thù (KPI, thuật ngữ, logic tính toán) mà Database Schema không thể hiện rõ. Bao gồm: Glossary, Value Profiles, Synonym Dictionary, Few-shot Samples. Triggers: Khi AI sinh SQL sai do không hiểu thuật ngữ nghiệp vụ, khi onboard DB mới.
Hướng dẫn dành cho AI Agent để sử dụng Trivy quét lỗ hổng bảo mật, cấu hình sai, lộ secret và kiểm tra bản quyền.
Triggers whenever the user asks to write, run, or configure API Integration Tests using Pytest and Httpx for FastAPI services. Contains strict directives for test structure, dynamic execution, mocking, and reporting.
Hướng dẫn điền kết quả kiểm thử từ API Integration và K6 Performance vào biểu mẫu Test Report chuẩn.
Hướng dẫn tự động sinh kịch bản kiểm thử (Test Case) và Test Script cho API/Unit bằng AI (LLM) hoặc công cụ chuyên dụng.
| name | k6 Performance Testing |
| description | Hướng dẫn chạy Load Test và đo lường hiệu năng bằng công cụ k6. |
Skill này dùng để chuẩn bị, thiết kế kịch bản và chạy Load Test bằng k6 nhằm đánh giá hiệu năng (tốc độ, độ ổn định, khả năng chịu tải) của các API.
Nếu k6 chưa được cài đặt, bạn có thể chạy bằng Docker để tiện lợi:
docker pull grafana/k6
Hoặc cài đặt k6 trực tiếp trên máy host theo tài liệu chính thức của k6.
Trong k6, bạn có thể thiết lập cấu hình options để chạy các loại test khác nhau tùy vào mục đích:
Các kịch bản test (script) thường được viết bằng JavaScript. Tạo thư mục tests/performance/ và lưu các script .js tại đây.
Ví dụ file load_test.js:
import http from 'k6/http';
import { check, sleep } from 'k6';
export const options = {
stages: [
{ duration: '30s', target: 20 }, // Tăng dần lên 20 user trong 30 giây
{ duration: '1m', target: 20 }, // Duy trì 20 user trong 1 phút
{ duration: '30s', target: 0 }, // Giảm dần về 0 user trong 30 giây
],
thresholds: {
http_req_duration: ['p(95)<500'], // 95% request phải phản hồi dưới 500ms
http_req_failed: ['rate<0.01'], // Tỉ lệ lỗi phải dưới 1%
},
};
export default function () {
const url = 'http://localhost:8000/api/v1/health'; // URL của API cần test
const res = http.get(url);
check(res, {
'status is 200': (r) => r.status === 200,
});
sleep(1); // Nghỉ 1 giây giữa các request
}
QUAN TRỌNG: Tương tự như các quy trình test khác, K6 phải lưu kết quả vào thư mục chuẩn để các skill khác (như Test Reporting) có thể đọc dữ liệu. Sử dụng cờ --summary-export để k6 xuất toàn bộ kết quả ra file JSON.
Chạy trực tiếp bằng command k6:
mkdir -p .agents/agents/k6-performance/output/
k6 run tests/performance/load_test.js --summary-export .agents/agents/k6-performance/output/k6_summary.json
Chạy bằng Docker (cần mount volume để lưu được file ra máy host):
docker run --rm -v $(pwd):/app -w /app grafana/k6 run tests/performance/load_test.js --summary-export .agents/agents/k6-performance/output/k6_summary.json
K6 sẽ xuất ra file JSON (như đã cấu hình ở trên). AI Agent (bạn) có nhiệm vụ đọc file .agents/agents/k6-performance/output/k6_summary.json và trích xuất các số liệu quan trọng sau để chuyển cho skill Test Report Writing: