ai-developer-skill-os 8.3.0 → 8.3.1

package/.agents/skills/qk-production-release/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-production-release-eval
+description: Đánh giá quá trình kiểm duyệt phát hành (Release Gate)
+version: 8.3.1
+threshold: 100 # Phải đạt 100 điểm vì lỗi ở Gate này có thể gây sập Production
+
+metrics:
+  - id: strict_gate_enforcement
+    name: Kỷ luật thi hành Checklist 8-Gate
+    description: Agent có nghiêm túc chặn việc release nếu phát hiện lỗi Hard-block không?
+    weight: 40
+    criteria:
+      - BẮT BUỘC chặn đứng (EXIT: FAILED) nếu các cổng P1–P5 hoặc P7 (CRITICAL security) thất bại (40đ)
+
+  - id: pre_flight_checks
+    name: Kiểm tra rác mã và Cấu hình (Pre-flight)
+    description: Agent có phát hiện được log rác và nhầm lẫn file môi trường không?
+    weight: 30
+    criteria:
+      - Rà soát thành công các tàn dư debug (console.log, debugger) trong mã nguồn (15đ)
+      - Xác minh chắc chắn biến môi trường đang trỏ về Production (.env.production) (15đ)
+
+  - id: build_and_security
+    name: Kiểm thử Build và Bảo mật
+    description: Phân tích Build Bundle và Dependency Audit có được chạy không?
+    weight: 30
+    criteria:
+      - Chạy lệnh build để đảm bảo source code không bị gãy (15đ)
+      - Chạy npm audit/yarn audit để chặn mã độc/vulnerabilities lên server (15đ)

package/.agents/skills/qk-project-bootstrap/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-bootstrap
-version: 8.2.0
+version: 8.3.1
 status: stable
 description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-project-bootstrap/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-bootstrap"
+version: "8.3.1"
+description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "project-structure"
+    - "initial-setup"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-bootstrap"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-bootstrap/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-project-bootstrap-eval
+description: Đánh giá chất lượng khởi tạo dự án V8.2 Blueprint
+version: 8.3.1
+threshold: 85 # Đảm bảo cấu trúc kiến trúc được thiết lập chuẩn xác ngay từ đầu
+
+metrics:
+  - id: blueprint_selection
+    name: Lựa chọn Blueprint phù hợp
+    description: Chọn đúng Blueprint và Manifest project.yaml tương ứng chưa?
+    weight: 35
+    criteria:
+      - Nhận diện đúng loại hình dự án (Coding, RAG/AI, Workflow) và áp dụng Blueprint cấu trúc thư mục phù hợp (15đ)
+      - Tạo ra file project.yaml chứa manifest của workspace (20đ)
+
+  - id: mandatory_files_scaffolding
+    name: Cấu trúc thư mục và File bắt buộc
+    description: Cây thư mục có thiếu các file quản lý chất lượng lõi không?
+    weight: 40
+    criteria:
+      - Sinh đúng kiến trúc (Ví dụ: 4-folder architecture cho AI RAG) (20đ)
+      - Đảm bảo đầy đủ các files chống thoái hóa: DESIGN.md, security.md, anti-patterns.md, scorecard.yaml (20đ)
+
+  - id: tooling_configuration
+    name: Cấu hình Công cụ (Tooling)
+    description: Môi trường có được thiết lập strict type và linter chưa?
+    weight: 25
+    criteria:
+      - Các cấu hình (tsconfig, eslint, prettier) được thiết lập chặt chẽ, không dễ dãi (25đ)

package/.agents/skills/qk-project-health/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-health
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-project-health/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-health"
+version: "8.3.1"
+description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "tech-debt"
+    - "codebase-health"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-health"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-health/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-project-health-eval
+description: Đánh giá năng lực Kiểm toán toàn diện sức khỏe Codebase
+version: 8.3.1
+threshold: 85 # Đảm bảo chấm điểm công tâm và vạch ra Roadmap cải thiện rõ ràng
+
+metrics:
+  - id: five_dimensions_scoring
+    name: Chấm điểm 5 Phương diện (5 Dimensions)
+    description: Đánh giá toàn diện 5 yếu tố cốt lõi của codebase chưa?
+    weight: 40
+    criteria:
+      - Quét và tính điểm đầy đủ 5 phương diện: Security, Code Quality, Architecture, Dependencies, Documentation (20đ)
+      - Có bằng chứng (Evidence) cho các vi phạm bị trừ điểm (20đ)
+
+  - id: security_and_antipatterns
+    name: Quét Bảo mật (R-SEC-04) và Anti-patterns (R-C-09)
+    description: Agent có tìm ra các lỗ hổng bảo mật hoặc rác mã nghiêm trọng không?
+    weight: 30
+    criteria:
+      - Tìm thấy hardcoded secrets, eval(), hoặc vi phạm kiến trúc (God files, circular deps) nếu có (30đ)
+
+  - id: actionable_roadmap
+    name: Roadmap Tái cấu trúc thực tiễn
+    description: Báo cáo có vạch ra con đường sửa chữa rõ ràng không?
+    weight: 30
+    criteria:
+      - Output không chỉ chê bai mà còn sắp xếp các vấn đề theo độ ưu tiên (CRITICAL sửa trước) để team fix (30đ)

package/.agents/skills/qk-project-memory/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-memory
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-project-memory/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-memory"
+version: "8.3.1"
+description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "project-facts"
+    - "verified-context"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-memory"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-memory/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-project-memory-eval
+description: Đánh giá quá trình lưu trữ và truy xuất ngữ cảnh dài hạn (Project Memory)
+version: 8.3.1
+threshold: 85 # Yêu cầu độ chính xác cao khi ghi đè hoặc lưu trữ để tránh ảo giác
+
+metrics:
+  - id: fact_verification
+    name: Chỉ lưu trữ Sự thật (Fact), không lưu Giả thuyết
+    description: Agent có kiểm chứng thông tin qua source code trước khi lưu vào Memory không?
+    weight: 40
+    criteria:
+      - Tuyệt đối không lưu các giả định (assumptions) hoặc fact có Confidence LOW (20đ)
+      - Có bằng chứng (file:line) đính kèm khi ghi dữ liệu (20đ)
+
+  - id: zero_trust_memory
+    name: An toàn dữ liệu trong Memory (Zero Trust)
+    description: Agent có vô tình lưu thông tin nhạy cảm vào Memory không?
+    weight: 35
+    criteria:
+      - KHÔNG lưu trữ PII, API Keys, raw JWTs hay credentials dưới dạng clear text (35đ)
+
+  - id: ui_diversification
+    name: Áp dụng UI Diversification
+    description: Có lưu và kiểm tra lịch sử thiết kế để tránh UI lặp lại nhàm chán không?
+    weight: 25
+    criteria:
+      - Đọc và ghi đúng vào file `ui-diversification.json` để ngăn chặn trùng lặp theme/macrostructure (25đ)

package/.agents/skills/qk-refactor/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: qk-refactor
+version: 8.3.1
+status: stable
+description: "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+type: capability
+
+intent:
+  - refactoring
+  - code-cleanup
+  - complexity-reduction
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "2-5"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - refactor
+  - tái cấu trúc
+  - clean up this code
+  - simplify
+  - reduce complexity
+  - dẫn cấu trúc code
+
+selection:
+  priority: medium
+  confidence_threshold: 0.80
+
+workflow: refactor
+
+rules:
+  - global
+  - coding
+  - safety
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+  - qk-project-health
+
+knowledge_scope:
+  owns:
+    - refactoring-patterns
+    - code-smells
+  references:
+    - architecture
+    - coding-standards
+
+verification:
+  required: true
+  strategy: refactor
+
+examples: []
+learnings: []
+
+execution_mode: deterministic
+cost: medium
+latency: medium
+risk: medium
+side_effects: edit_files
+produces: [code, report]
+consumes: [source-code]
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 2
+  stop_early: true
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-refactor - Safe Refactor
+
+> Language rule: Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Target file(s) or module(s) are specified
+- [ ] Tests exist for the target code (or can be created)
+
+On missing precondition:
+  EXIT: BLOCKED
+  Message: "Missing: target files or test coverage"
+
+## Scope
+- Improve internal code quality without changing external behavior
+- Reduce complexity, improve naming, extract functions
+- Remove dead code and duplication
+
+## Non-Goals
+- Add new functionality
+- Change public API signatures
+- Modify behavior or business logic
+
+## Workflow
+1. Establish baseline (current behavior + tests)
+2. Plan refactor steps
+3. Execute step by step
+4. Verify behavior unchanged
+5. Run validation gate
+
+## Exit Codes
+| Code | Meaning |
+|------|---------|
+| SUCCESS | Refactor complete, behavior preserved, tests pass |
+| PARTIAL | Refactor done, some tests need attention |
+| BLOCKED | Missing preconditions |
+| FAILED | Behavior changed or tests broken |

package/.agents/skills/qk-refactor/capability.yaml

@@ -0,0 +1,26 @@
+schema_version: 1
+id: "qk-refactor"
+version: "8.3.1"
+description: "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."
+dependencies:
+  - "refactor"
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "refactoring-patterns"
+    - "code-smells"
+  references:
+    - "architecture"
+    - "coding-standards"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "refactoring-patterns"
+  does_not_own:
+    - "new-functionality"
+    - "api-changes"
+  conflicts_with: []
+  delegates_to: []

package/.agents/skills/qk-refactor/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-refactor-eval
+description: Đánh giá an toàn và hiệu quả của tiến trình Refactor
+version: 8.3.1
+threshold: 90 # Yêu cầu an toàn rất cao, refactor không được làm hỏng tính năng
+
+metrics:
+  - id: behavior_preservation
+    name: Bảo toàn Logic (Behavior Preservation)
+    description: Tái cấu trúc có làm thay đổi logic hoạt động hoặc API public không?
+    weight: 40
+    criteria:
+      - Tuyệt đối không thêm tính năng mới trong quá trình refactor (20đ)
+      - Không thay đổi chữ ký (signature) của các public API (20đ)
+
+  - id: test_coverage_precondition
+    name: Tiền điều kiện Kiểm thử (Tests)
+    description: Agent có từ chối refactor nếu không có Tests bảo vệ không?
+    weight: 35
+    criteria:
+      - Chặn (BLOCKED) và yêu cầu viết test nếu code chưa có coverage (35đ)
+
+  - id: complexity_reduction
+    name: Giảm Độ phức tạp (Complexity Reduction)
+    description: Kết quả refactor có thực sự làm code sạch và dễ bảo trì hơn không?
+    weight: 25
+    criteria:
+      - Tách hàm, loại bỏ code chết, giảm cyclomatic complexity rõ rệt (25đ)

package/.agents/skills/qk-security-audit/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-security-audit
-version: 8.1.0
+version: 8.3.1
 status: experimental
 description: "Security audit (OWASP, dependency security, secret detection, permission model)."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-security-audit/capability.yaml

@@ -0,0 +1,30 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-security-audit"
+version: "8.3.1"
+description: "Security audit (OWASP, dependency security, secret detection, permission model)."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "qk-security-audit"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "application-security"
+    - "agent-security"
+    - "prompt-injection"
+    - "dependency-risk"
+  does_not_own:
+    - "access control implementation"
+    - "penetration testing"
+    - "compliance certification"
+  conflicts_with: []
+  delegates_to:
+    - "qk-validation-gate"

package/.agents/skills/qk-security-audit/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-security-audit-eval
+description: Đánh giá chất lượng Kiểm toán Bảo mật
+version: 8.3.1
+threshold: 95 # Threshold gần như tuyệt đối vì đây là lưới lọc bảo mật cuối cùng
+
+metrics:
+  - id: secret_leak_detection
+    name: Nhận diện rò rỉ Secret (Secret Leak)
+    description: Agent có phát hiện được API keys/Passwords bị hardcode không?
+    weight: 40
+    criteria:
+      - Rà quét và chỉ điểm chính xác file/line chứa secret bị hardcode (40đ)
+
+  - id: r_sec_04_enforcement
+    name: Rà soát Zero-Trust & Phân quyền
+    description: Có kiểm tra các lỗ hổng RBAC/ABAC và Prompt Injection không?
+    weight: 35
+    criteria:
+      - Đánh giá mô hình quyền hạn xem có lỗ hổng BOLA hoặc Broken Auth không (15đ)
+      - Quét nguy cơ Prompt Injection (nếu có LLM integration) theo chuẩn R-SEC-04 (20đ)
+
+  - id: owasp_and_dependencies
+    name: Lỗ hổng OWASP & Dependencies
+    description: Có kiểm tra các thư viện lỗi thời hoặc lỗ hổng phổ biến không?
+    weight: 25
+    criteria:
+      - Đưa ra danh sách cảnh báo dựa trên OWASP Top 10 và Dependency Tree (25đ)

package/.agents/skills/qk-system-evolution/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-system-evolution
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Nâng cấp thư viện/framework an toàn với rollback plan bắt buộc — incremental, không big-bang."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-system-evolution/capability.yaml

@@ -0,0 +1,24 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-system-evolution"
+version: "8.3.1"
+description: "Nâng cấp thư viện/framework an toàn với rollback plan bắt buộc — incremental, không big-bang."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "upgrade-strategy"
+    - "rollback-plan"
+  references:
+    - "testing"
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-system-evolution"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-system-evolution/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-system-evolution-eval
+description: Đánh giá độ an toàn của quy trình nâng cấp System & Framework
+version: 8.3.1
+threshold: 90 # Việc nâng cấp framework mang rủi ro sập hệ thống rất cao
+
+metrics:
+  - id: rollback_safety
+    name: Cơ chế Rollback bắt buộc
+    description: Agent có thiết lập và ghi chép lại lệnh rollback trước khi nâng cấp không?
+    weight: 40
+    criteria:
+      - Phải yêu cầu/lưu lại Rollback command (git tag / version trước đó) trước khi sửa code (40đ)
+
+  - id: changelog_awareness
+    name: Phân tích Breaking Changes
+    description: Agent có đọc Changelog thay vì nhắm mắt upgrade không?
+    weight: 35
+    criteria:
+      - Quét và liệt kê các Breaking Changes từ Changelog/Migration Guide trước khi chạy (35đ)
+
+  - id: incremental_upgrade
+    name: Nâng cấp gia tăng (Incremental)
+    description: Có nâng cấp từng phần và chạy test xác minh thay vì Big-bang không?
+    weight: 25
+    criteria:
+      - Chạy test ngay sau khi nâng cấp 1 package thay vì update hàng loạt (25đ)

package/.agents/skills/qk-test-engineering/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-test-engineering
-version: 8.1.0
+version: 8.3.1
 status: experimental
 description: "Công cụ quyết định chiến lược kiểm thử (Unit, Integration, E2E, Coverage, Regression, Mock)."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-test-engineering/capability.yaml

@@ -0,0 +1,28 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-test-engineering"
+version: "8.3.1"
+description: "Công cụ quyết định chiến lược kiểm thử (Unit, Integration, E2E, Coverage, Regression, Mock)."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "qk-test-engineering"
+  references:
+    - "architecture"
+    - "anti-patterns"
+    - "playwright"
+    - "vitest"
+    - "storybook-testing"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "test pyramid"
+    - "coverage strategy"
+    - "regression planning"
+  does_not_own:
+    - "business logic implementation"
+    - "writing tests"
+  conflicts_with: []

package/.agents/skills/qk-test-engineering/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-test-engineering-eval
+description: Đánh giá tư duy Chiến lược Kiểm thử (Test Strategy)
+version: 8.3.1
+threshold: 85 # Đảm bảo tư vấn chiến lược rõ ràng và bao quát rủi ro
+
+metrics:
+  - id: pyramid_strategy
+    name: Chiến lược Test Pyramid
+    description: Chiến lược có phân bổ hợp lý giữa Unit, Integration và E2E không?
+    weight: 35
+    criteria:
+      - Phân tách rõ ràng loại test nào dùng cho logic nào thay vì bắt viết E2E cho mọi thứ (35đ)
+
+  - id: boundary_testing_r_sec_04
+    name: Negative & Boundary Testing (R-SEC-04)
+    description: Có bao phủ các test cases ranh giới để ngăn chặn tấn công/lỗi dữ liệu không?
+    weight: 35
+    criteria:
+      - Bắt buộc đưa ra các test case biên (Boundary) và trường hợp lỗi (Negative tests) (35đ)
+
+  - id: mocking_strategy
+    name: Chiến lược Mock/Stub
+    description: Có tư vấn rõ ràng khi nào nên Mock và khi nào dùng Database thật không?
+    weight: 30
+    criteria:
+      - Phân biệt rõ việc Mock API bên thứ ba vs Integration DB nội bộ (30đ)

package/.agents/skills/qk-ui-audit/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-ui-audit
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Kiểm toán giao diện (UI) với 57-check Anti-Slop checklist — fail nếu score < 76/85 base."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-ui-audit/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-ui-audit"
+version: "8.3.1"
+description: "Kiểm toán giao diện (UI) với 57-check Anti-Slop checklist — fail nếu score < 76/85 base."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "ui-standards"
+    - "anti-slop"
+  references:
+    - "design-system"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-ui-audit"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-ui-audit/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-ui-audit-eval
+description: Đánh giá khả năng rà soát UI Anti-Slop
+version: 8.3.1
+threshold: 90 # Đóng vai trò chốt chặn UI chất lượng cao, không khoan nhượng với Slop
+
+metrics:
+  - id: design_contract_compliance
+    name: Tuân thủ Hợp đồng Thiết kế (DESIGN.md)
+    description: Có bắt lỗi chính xác các giá trị hardcode không nằm trong Design Tokens không?
+    weight: 40
+    criteria:
+      - Tìm và đánh dấu các mã màu hex, px hardcode vi phạm token của DESIGN.md (40đ)
+
+  - id: anti_slop_detection
+    name: Nhận diện AI-Slop (Generic aesthetics)
+    description: Có phát hiện được các thiết kế chung chung, xám xịt, viền nhạt nhòa không?
+    weight: 30
+    criteria:
+      - Trừ điểm nặng các thẻ card thiếu chiều sâu, text quá nhỏ, hoặc thiếu hover state (30đ)
+
+  - id: accessibility_check
+    name: Kiểm tra Trải nghiệm Tiếp cận (A11y)
+    description: Có rà soát các thẻ ARIA, độ tương phản và Semantic HTML không?
+    weight: 30
+    criteria:
+      - Cảnh báo các element tương tác (button, link) thiếu roles, alt text hoặc độ tương phản < 4.5:1 (30đ)