🏆 Tiêu chuẩn Chất lượng & Xác thực

Để biến Antigravity Awesome Skills từ một tập hợp các script thành một nền tảng đáng tin cậy, mỗi skill (kỹ năng) phải đáp ứng một tiêu chuẩn cụ thể về chất lượng và an toàn.

Huy hiệu "Đã xác thực" (Validated) ✅

Một skill chỉ nhận được huy hiệu "Đã xác thực" nếu nó vượt qua 5 bước kiểm tra tự động sau:

1. Tính toàn vẹn của siêu dữ liệu (Metadata Integrity)

Phần frontmatter trong SKILL.md phải là mã YAML hợp lệ và chứa:

name: Định dạng Kebab-case, khớp với tên thư mục.
description: Dưới 200 ký tự, nêu rõ giá trị mang lại.
risk: Thuộc một trong các loại [none, safe, critical, offensive].
source: URL dẫn đến nguồn gốc (hoặc "self" nếu là nội dung gốc).

2. Điều kiện kích hoạt rõ ràng ("Khi nào nên dùng")

Skill BẮT BUỘC phải có một phần nêu rõ thời điểm nên kích hoạt nó.

Tốt: "Sử dụng khi người dùng yêu cầu debug (gỡ lỗi) một component React."
Tệ: "Skill này giúp bạn xử lý code."

3. Phân loại An toàn & Rủi ro

Mỗi skill phải khai báo mức độ rủi ro của nó:

🟢 none: Chỉ là văn bản/tư duy thuần túy (ví dụ: Brainstorming).
🔵 safe: Đọc file, chạy các lệnh an toàn (ví dụ: Linter).
🟠 critical: Sửa đổi trạng thái, xóa file, push lên môi trường production (ví dụ: Git Push).
🔴 offensive: Các công cụ Pentesting/Red Team. BẮT BUỘC phải có cảnh báo "Chỉ dành cho mục đích sử dụng đã được cấp phép".

4. Ví dụ thực tế (Copy-Pasteable)

Ít nhất một khối code hoặc ví dụ tương tác mà người dùng (hoặc agent) có thể sử dụng ngay lập tức.

5. Giới hạn rõ ràng (Explicit Limitations)

Danh sách các trường hợp biên hoặc những việc mà skill không thể thực hiện.

Ví dụ: "Không hoạt động trên Windows nếu không có WSL."

Các cấp độ Hỗ trợ

Chúng tôi cũng phân loại skill dựa trên người duy trì chúng:

Cấp độ	Huy hiệu	Ý nghĩa
Official	🟣	Do đội ngũ cốt lõi duy trì. Độ tin cậy cao.
Community	⚪	Do cộng đồng đóng góp. Hỗ trợ theo khả năng tốt nhất.
Verified	✨	Skill cộng đồng đã vượt qua vòng kiểm duyệt thủ công chuyên sâu.

Cách Xác thực Skill của bạn

Chạy script xác thực trước khi gửi Pull Request (PR):

python3 scripts/validate_skills.py --strict

2.9 KiB Raw Blame History