ai-developer-skill-os 8.3.0 → 8.3.1

package/.agents/skills/qk-access-policy/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-access-policy"
+version: "8.3.1"
+description: "Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware sau."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "security-policy"
+    - "role-matrix"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-access-policy"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-access-policy/evals/scorecard.yaml

@@ -0,0 +1,36 @@
+name: qk-access-policy-eval
+description: Đánh giá chất lượng thực thi của kỹ năng qk-access-policy
+version: 8.3.1
+threshold: 100 # Cần đạt điểm tuyệt đối với Access Policy vì tính chất bảo mật
+
+metrics:
+  - id: matrix_defined
+    name: Định nghĩa Role-Permission Matrix
+    description: Agent có tạo bảng phân quyền rõ ràng trước khi code không?
+    weight: 30
+    criteria:
+      - Bảng ma trận đầy đủ resource và roles (15đ)
+      - Không có xung đột (contradiction) trong ma trận (15đ)
+
+  - id: middleware_implemented
+    name: Cài đặt Middleware/Guard
+    description: Agent có tạo middleware/guard để kiểm tra quyền ở phía Backend không?
+    weight: 30
+    criteria:
+      - Áp dụng đúng R-SEC-04, phân quyền bằng middleware, không tin tưởng JWT Claims thô (15đ)
+      - Routes được gắn guard theo đúng Role-Permission Matrix (15đ)
+
+  - id: deny_by_default
+    name: Áp dụng Deny-by-default
+    description: Các endpoint không được khai báo có bị chặn mặc định không?
+    weight: 20
+    criteria:
+      - Implement cơ chế deny-by-default cho các non-public routes (20đ)
+
+  - id: no_anti_patterns
+    name: Không vi phạm Anti-patterns
+    description: Không cấp quyền wildcard và không hardcode role trong business logic
+    weight: 20
+    criteria:
+      - Không có quyền wildcard (*) được cấp (10đ)
+      - Không có câu lệnh kiểm tra role (vd: if role === 'admin') nằm rải rác trong Service/Business layer (10đ)

package/.agents/skills/qk-agent-observability/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-agent-observability
-version: 8.1.3
+version: 8.3.1
 status: experimental
 description: "Lớp theo dõi (Observability) cho phép giám sát quyết định, luân chuyển và các mô hình lỗi."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -45,7 +45,7 @@ knowledge_scope:
     - evaluation-metrics
   references:
     - architecture
-    - scorecard          # bổ sung: file scorecard.yaml giờ nằm trong references/ của skill này
+    - scorecard          # bổ sung: file scorecard.yaml giờ nằm trong evals/ của skill này
 
 decision_boundary:
   owns:
@@ -124,7 +124,7 @@ This skill enables tracking and observing the AI agent's own behavior, decisions
 ## Preconditions
 
 - [ ] Task vừa hoàn tất (bất kỳ `exit_code` nào — kể cả `FAILED`/`BLOCKED` cũng phải ghi trace, vì thất bại cũng là dữ liệu quan sát quan trọng).
-- [ ] `references/scorecard.yaml` tồn tại và định nghĩa được metric cần ghi nhận.
+- [ ] `evals/scorecard.yaml` tồn tại và định nghĩa được metric cần ghi nhận.
 
 ```
 On missing scorecard.yaml:

package/.agents/skills/qk-agent-observability/capability.yaml

@@ -0,0 +1,29 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-agent-observability"
+version: "8.3.1"
+description: "Lớp theo dõi (Observability) cho phép giám sát quyết định, luân chuyển và các mô hình lỗi."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "qk-agent-observability"
+  references:
+    - "architecture"
+    - "scorecard"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "agent_decision_trace"
+    - "routing_accuracy_metrics"
+    - "skill_success_rate"
+    - "failure_pattern_detection"
+    - "feedback_loop"
+  does_not_own:
+    - "application_monitoring"
+    - "infrastructure_monitoring"
+    - "log_aggregation"
+    - "uptime_monitoring"
+    - "pass_fail_enforcement"
+  conflicts_with: []

package/.agents/skills/qk-agent-observability/evals/scorecard.yaml

@@ -0,0 +1,29 @@
+name: qk-agent-observability-eval
+description: Đánh giá khả năng thu thập dữ liệu (trace) và phát hiện lỗi của agent
+version: 8.3.1
+threshold: 85 # Không yêu cầu tuyệt đối, nhưng cần đảm bảo observability hoạt động tốt
+
+metrics:
+  - id: write_trace_file
+    name: Ghi file trace JSON hợp lệ
+    description: Agent có tạo file JSON đúng chuẩn vào thư mục evals/traces/ không?
+    weight: 40
+    criteria:
+      - File trace được tạo trong evals/traces/ với định dạng {yyyy-mm-dd}_{task-slug}.json (20đ)
+      - File JSON có cấu trúc chuẩn, final_score = null (20đ)
+
+  - id: collect_signals
+    name: Thu thập đầy đủ tín hiệu (Signals)
+    description: File trace có chứa đầy đủ các thông tin cần thiết không?
+    weight: 40
+    criteria:
+      - Có đủ thông tin Routing (skill_used, clarification, switched) (15đ)
+      - Có đủ thông tin Boundary & Token Budget (15đ)
+      - Có đủ thông tin Zero-trust và Exit Code thực tế (10đ)
+
+  - id: detect_failure_patterns
+    name: Phát hiện pattern lỗi lặp lại
+    description: Agent có khả năng cảnh báo khi một skill thất bại liên tục không?
+    weight: 20
+    criteria:
+      - Nhận diện đúng khi có >= 3 trace gần nhất bị fail hoặc vi phạm boundary (20đ)

package/.agents/skills/qk-ai-builder/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-ai-builder
-version: 8.2.0
+version: 8.3.1
 status: stable
 description: "Thiết kế Governed AI Agent & RAG pipelines theo chuẩn V8.2 — Đóng gói bằng capability.yaml, data discipline 4-folder và Eval Pipeline."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-ai-builder/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-ai-builder"
+version: "8.3.1"
+description: "Thiết kế Governed AI Agent & RAG pipelines theo chuẩn V8.2 — Đóng gói bằng capability.yaml, data discipline 4-folder và Eval Pipeline."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "agent-architecture"
+    - "skill-generation"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-ai-builder"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-ai-builder/evals/scorecard.yaml

@@ -0,0 +1,30 @@
+name: qk-ai-builder-eval
+description: Đánh giá chất lượng thiết kế Agent & RAG Pipeline
+version: 8.3.1
+threshold: 90 # Yêu cầu rất cao vì liên quan đến an ninh (injection) và cấu trúc V8
+
+metrics:
+  - id: prompt_design
+    name: Thiết kế System Prompt
+    description: Prompt có tuân thủ đúng cấu trúc chuẩn và giới hạn an toàn không?
+    weight: 30
+    criteria:
+      - Có cấu trúc rõ ràng (ROLE, TASK, CONSTRAINTS) (10đ)
+      - Có định dạng đầu ra (OUTPUT FORMAT) bằng JSON Schema chuẩn (10đ)
+      - Có Examples (few-shot) để hướng dẫn LLM (10đ)
+
+  - id: security_anti_injection
+    name: Bảo mật Anti-Injection (R-SEC-04)
+    description: Các biện pháp phòng ngừa Prompt Injection có được áp dụng không?
+    weight: 40
+    criteria:
+      - Input của user được bọc trong thẻ XML `<user_input>...</user_input>` (20đ)
+      - Output có chứa trường `confidence` để fallback/human review nếu kết quả có vấn đề (20đ)
+
+  - id: v8_packaging
+    name: Đóng gói chuẩn V8.2
+    description: Kiến trúc 4-folder và file định nghĩa có đầy đủ không?
+    weight: 30
+    criteria:
+      - Khởi tạo đúng cấu trúc 4 thư mục: prompts/, data/, agents/, evals/ (15đ)
+      - Tự động sinh ra `capability.yaml` và `scorecard.yaml` cho skill mới (15đ)

package/.agents/skills/qk-api-lifecycle/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-api-lifecycle
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code sau."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-api-lifecycle/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-api-lifecycle"
+version: "8.3.1"
+description: "Thiết kế, triển khai API endpoints với Zero-Trust — contract trước, code sau."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "api-contracts"
+    - "endpoints"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-api-lifecycle"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-api-lifecycle/evals/scorecard.yaml

@@ -0,0 +1,29 @@
+name: qk-api-lifecycle-eval
+description: Đánh giá chất lượng thiết kế và triển khai API
+version: 8.3.1
+threshold: 90 # Tiêu chuẩn cao vì liên quan đến hợp đồng dữ liệu và bảo mật cổng vào
+
+metrics:
+  - id: contract_first_design
+    name: Thiết kế theo hợp đồng (Contract-first)
+    description: Agent có định nghĩa Types/Interfaces rõ ràng trước khi code logic không?
+    weight: 30
+    criteria:
+      - Định nghĩa rõ ràng Request & Response structure bằng TypeScript interface / DTO (15đ)
+      - Khai báo đầy đủ HTTP method, route path và các HTTP status codes có thể trả về (15đ)
+
+  - id: zero_trust_validation
+    name: Tuân thủ Zero-Trust (R-SEC-04)
+    description: Mọi API Endpoint có được bảo vệ và validate dữ liệu ở cổng vào không?
+    weight: 40
+    criteria:
+      - Áp dụng thư viện validation (zod/yup/class-validator) cho toàn bộ input payload (20đ)
+      - Không rò rỉ dữ liệu nhạy cảm ở response cổng ra (sanitize/mask data) (20đ)
+
+  - id: error_handling_and_compat
+    name: Xử lý lỗi và Tương thích ngược
+    description: API có xử lý mượt mà các tình huống lỗi và giữ tính backward compatibility không?
+    weight: 30
+    criteria:
+      - Trả về đúng HTTP status code (400, 401, 403, 404, 422, 500) thay vì trả 500 cho mọi lỗi (15đ)
+      - Không làm hỏng (breaking changes) các trường dữ liệu của contract cũ mà không tăng version (15đ)

package/.agents/skills/qk-bug-resolution/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-bug-resolution
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng → Sửa."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-bug-resolution/capability.yaml

@@ -0,0 +1,25 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-bug-resolution"
+version: "8.3.1"
+description: "Sửa lỗi (bugs) bằng chu trình khép kín: Quan sát → Giả thuyết → Bằng chứng → Sửa."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "bug-diagnosis"
+    - "fix-strategies"
+    - "root-cause-analysis"
+  references:
+    - "testing"
+    - "language-specific-features"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-bug-resolution"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-bug-resolution/evals/scorecard.yaml

@@ -0,0 +1,30 @@
+name: qk-bug-resolution-eval
+description: Đánh giá chất lượng quy trình sửa lỗi (Bug Resolution)
+version: 8.3.1
+threshold: 85 # Quy trình sửa lỗi cần bằng chứng rõ ràng và sửa đúng trọng tâm
+
+metrics:
+  - id: evidence_based_diagnosis
+    name: Chẩn đoán dựa trên bằng chứng
+    description: Agent có tìm ra chính xác dòng code gây lỗi trước khi sửa không?
+    weight: 40
+    criteria:
+      - Xác định được chính xác file và dòng gây lỗi (file:line) dựa vào stack trace/log thay vì đoán mò (20đ)
+      - Phân tích đúng Root Cause (nguyên nhân gốc rễ) trước khi đưa ra giải pháp (20đ)
+
+  - id: minimal_targeted_patch
+    name: Sửa lỗi tối giản và đúng trọng tâm
+    description: Bản vá lỗi có gọn gàng và không ảnh hưởng đến logic khác không?
+    weight: 35
+    criteria:
+      - Sửa trực tiếp vào source code, thay đổi mã nguồn ít nhất có thể (minimal diff) (15đ)
+      - Không refactor lan man ra ngoài phạm vi gây lỗi (10đ)
+      - Giải quyết triệt để nguyên nhân, không dùng mẹo che giấu lỗi (vd: không lạm dụng `?` hoặc `!` chỉ để ép kiểu) (10đ)
+
+  - id: verification_and_safety
+    name: Kiểm chứng và an toàn
+    description: Agent có kiểm tra lại sau khi sửa và tuân thủ ranh giới không?
+    weight: 25
+    criteria:
+      - Re-read (đọc lại) code sau khi sửa để xác nhận logic đã chuẩn xác (Static Verification) (15đ)
+      - Không phá vỡ ranh giới bảo mật (Zero-Trust) chỉ để code chạy được (10đ)

package/.agents/skills/qk-code-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-code-review
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Elite AI/Code Review System: Kiểm toán, Review code và cấu hình AI với tư duy Architect, áp dụng 4-Phase Review."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-code-review/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-code-review"
+version: "8.3.1"
+description: "Elite AI/Code Review System: Kiểm toán, Review code và cấu hình AI với tư duy Architect, áp dụng 4-Phase Review."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "code-review-standards"
+    - "ai-configuration-review"
+    - "feedback-delivery"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-code-review"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-code-review/evals/scorecard.yaml

@@ -0,0 +1,29 @@
+name: qk-code-review-eval
+description: Đánh giá chất lượng thực thi quy trình Code/AI Review
+version: 8.3.1
+threshold: 85 # Đánh giá tư duy Architect và ngôn ngữ phản hồi
+
+metrics:
+  - id: structured_review_process
+    name: Tuân thủ 4-Phase Review Process
+    description: Agent có thực hiện tuần tự và đầy đủ 4 giai đoạn phân tích không?
+    weight: 35
+    criteria:
+      - Tải ngữ cảnh động (Dynamic Context Loading) hợp lý, không tải dư thừa (15đ)
+      - Có Review High-level (Kiến trúc, SOLID, R-SEC-04) và Deep-dive (Logic chuyên sâu, Hallucination) (20đ)
+
+  - id: collaborative_and_tagged_feedback
+    name: Ngôn ngữ Hợp tác & Đánh nhãn Severity
+    description: Feedback có tính xây dựng và được phân loại đúng mức độ không?
+    weight: 40
+    criteria:
+      - Sử dụng câu hỏi gợi mở, ngôn từ hợp tác thay vì ra lệnh (15đ)
+      - Phân loại rõ ràng bằng nhãn `[blocking]`, `[important]`, `[nit]`, `[suggestion]`, `[praise]` (25đ)
+
+  - id: safe_execution
+    name: Không tự ý sửa mã
+    description: Agent chỉ review và đưa ra suggestion chứ không tự động thay đổi code?
+    weight: 25
+    criteria:
+      - Đưa ra code diff (Suggested Fixes) để user tham khảo (15đ)
+      - Tuyệt đối không tự sửa file (sử dụng replace_file_content) nếu user không yêu cầu (10đ)

package/.agents/skills/qk-context-loader/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-context-loader
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Tải context và vẽ dependency graph chính xác trước khi code — ngăn hallucination kiến trúc."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-context-loader/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-context-loader"
+version: "8.3.1"
+description: "Tải context và vẽ dependency graph chính xác trước khi code — ngăn hallucination kiến trúc."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "project-context"
+    - "architecture-discovery"
+  references:
+    - "coding"
+    - "repository-structure"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-context-loader"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-context-loader/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-context-loader-eval
+description: Đánh giá khả năng phân tích kiến trúc và tải context
+version: 8.3.1
+threshold: 85 # Tính chính xác của context là cốt lõi để tránh hallucination
+
+metrics:
+  - id: accurate_graph_traversal
+    name: Phân tích Graph chính xác và giới hạn
+    description: Agent có tuân thủ giới hạn chiều sâu và không quét thừa file không?
+    weight: 35
+    criteria:
+      - Quét đúng dependency graph từ entry point (15đ)
+      - Tuân thủ giới hạn max depth 3 và max_files_read, không bị tràn (infinite loop) (20đ)
+
+  - id: risk_assessment
+    name: Đánh giá mức độ rủi ro (Risk Assessment)
+    description: Agent có nhận diện đúng các module dùng chung (shared) hoặc vi phạm ranh giới không?
+    weight: 35
+    criteria:
+      - Đánh dấu chính xác các file được import nhiều lần là HIGH/CRITICAL risk (20đ)
+      - Phát hiện được các file vi phạm cấu trúc (vd: trộn lẫn Server Logic và Client UI) (15đ)
+
+  - id: strict_json_output
+    name: Định dạng Output JSON chuẩn mực
+    description: Agent có xuất ra được JSON Schema như yêu cầu để các agent khác đọc không?
+    weight: 30
+    criteria:
+      - Định dạng JSON trả về chứa đầy đủ nodes, imports, exports và risks theo đúng schema (30đ)

package/.agents/skills/qk-data-lifecycle/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-data-lifecycle
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Quản lý Schema, Migrations an toàn — schema freeze → backward-compat migration → cleanup."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-data-lifecycle/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-data-lifecycle"
+version: "8.3.1"
+description: "Quản lý Schema, Migrations an toàn — schema freeze → backward-compat migration → cleanup."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "schema"
+    - "migrations"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-data-lifecycle"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-data-lifecycle/evals/scorecard.yaml

@@ -0,0 +1,29 @@
+name: qk-data-lifecycle-eval
+description: Đánh giá chất lượng quản lý Schema và an toàn Migration
+version: 8.3.1
+threshold: 90 # Tiêu chuẩn rất cao vì rủi ro mất mát dữ liệu (Data loss) là CRITICAL
+
+metrics:
+  - id: backward_compatible_migration
+    name: Migration tương thích ngược và an toàn
+    description: Agent có tạo migration an toàn, tránh phá vỡ dữ liệu đang chạy không?
+    weight: 40
+    criteria:
+      - Không sử dụng các lệnh destructive (DROP COLUMN, RENAME TABLE) một cách trực tiếp mà không qua chiến lược 3-phase (20đ)
+      - Các cột mới (add column) phải nullable hoặc có default value (10đ)
+      - Luôn định nghĩa hàm rollback `down()` (10đ)
+
+  - id: pii_and_security
+    name: Bảo mật dữ liệu PII (R-SEC-04)
+    description: Dữ liệu nhạy cảm có được mã hóa theo yêu cầu không?
+    weight: 30
+    criteria:
+      - Tự động nhận diện và áp dụng cơ chế hashing/encryption cho các cột chứa dữ liệu PII (Personal Identifiable Information) (30đ)
+
+  - id: layer_separation
+    name: Tách biệt Logic và Schema
+    description: Schema và truy vấn có được tách biệt khỏi Business Logic không?
+    weight: 30
+    criteria:
+      - Khai báo Schema (Model/Entity) rõ ràng trước khi viết truy vấn (15đ)
+      - Repository chỉ chứa truy vấn Database, không chứa Business Logic phức tạp (15đ)

package/.agents/skills/qk-db-optimizer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-db-optimizer
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join — không đoán mò."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-db-optimizer/capability.yaml

@@ -0,0 +1,22 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-db-optimizer"
+version: "8.3.1"
+description: "Tối ưu Database dựa trên bằng chứng: EXPLAIN → phân tích → index/join — không đoán mò."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "database-performance"
+    - "query-optimization"
+  references:
+    - "architecture"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-db-optimizer"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-db-optimizer/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-db-optimizer-eval
+description: Đánh giá chất lượng tối ưu hóa Database
+version: 8.3.1
+threshold: 85 # Yêu cầu dựa trên bằng chứng, không đoán mò
+
+metrics:
+  - id: evidence_based_analysis
+    name: Phân tích dựa trên bằng chứng (EXPLAIN)
+    description: Agent có chạy EXPLAIN/Analyze trước khi thêm Index/Sửa query không?
+    weight: 40
+    criteria:
+      - Bắt buộc phải có thông tin Slow query log hoặc chạy EXPLAIN trước khi hành động (20đ)
+      - Phân tích đúng nguyên nhân từ Plan (vd: Seq Scan, Nested Loop, N+1) (20đ)
+
+  - id: optimal_solution
+    name: Đưa ra giải pháp tối ưu
+    description: Giải pháp đưa ra có giải quyết triệt để và an toàn không?
+    weight: 35
+    criteria:
+      - Không tạo các index dư thừa (overlapping) (15đ)
+      - Xử lý triệt để bài toán N+1 bằng JOIN hoặc DataLoader theo đúng chuẩn dự án (20đ)
+
+  - id: verification
+    name: Kiểm chứng cải thiện (Verification)
+    description: Agent có cố gắng đo lường lại sau khi sửa không?
+    weight: 25
+    criteria:
+      - Đối chiếu/ước lượng mức độ cải thiện sau khi áp dụng giải pháp (25đ)

package/.agents/skills/qk-design-system-engineering/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-design-system-engineering
-version: 8.1.0
+version: 8.3.1
 status: experimental
 description: "Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến thể component)."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-design-system-engineering/capability.yaml

@@ -0,0 +1,25 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-design-system-engineering"
+version: "8.3.1"
+description: "Quản trị hệ thống thiết kế (Định nghĩa quy tắc hệ thống, tokens, các biến thể component)."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "qk-design-system-engineering"
+  references:
+    - "architecture"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "tokens"
+    - "components rules"
+    - "design governance"
+  does_not_own:
+    - "page implementation"
+    - "business logic"
+  conflicts_with:
+    - "qk-ui-system-builder"