ai-developer-skill-os 8.3.0 → 8.3.1

package/.agents/skills/qk-design-system-engineering/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-design-system-engineering-eval
+description: Đánh giá chất lượng quản trị hệ thống thiết kế (Design System)
+version: 8.3.1
+threshold: 85 # Đảm bảo sự nhất quán và ngăn chặn UI Slop từ gốc
+
+metrics:
+  - id: token_and_rules_definition
+    name: Định nghĩa Token và Quy tắc
+    description: Agent có thiết lập hệ thống token rõ ràng và nhất quán không?
+    weight: 40
+    criteria:
+      - Định nghĩa đầy đủ các quy tắc cho spacing, colors, typography (20đ)
+      - Ngăn chặn triệt để UI Slop bằng cách không cung cấp các token sai chuẩn (vd: độ tương phản quá thấp, font quá bé) (20đ)
+
+  - id: a11y_compliance
+    name: Tuân thủ Accessibility (A11y)
+    description: Các quy chuẩn có tính đến khả năng truy cập không?
+    weight: 30
+    criteria:
+      - Thiết lập quy tắc A11y ngay từ cấp độ Token (30đ)
+
+  - id: boundary_respect
+    name: Tôn trọng ranh giới (Decision Boundary)
+    description: Agent có giữ đúng vai trò Governance mà không lấn sân sang Implementation không?
+    weight: 30
+    criteria:
+      - Chỉ tập trung định nghĩa (Governance), KHÔNG thay thế việc viết UI code trực tiếp (nhường lại cho qk-ui-system-builder) (30đ)

package/.agents/skills/qk-devops-platform/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-devops-platform
-version: 8.1.1
+version: 8.3.1
 status: experimental
 description: "Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường và chiến lược rollback."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-devops-platform/capability.yaml

@@ -0,0 +1,29 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-devops-platform"
+version: "8.3.1"
+description: "Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường và chiến lược rollback."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "qk-devops-platform"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "CI/CD strategy"
+    - "deployment architecture"
+    - "environment management"
+    - "rollback strategy"
+  does_not_own:
+    - "application code"
+    - "cloud billing"
+    - "releasing features"
+  conflicts_with:
+    - "qk-production-release"

package/.agents/skills/qk-devops-platform/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-devops-platform-eval
+description: Đánh giá chất lượng cấu trúc DevOps và CI/CD
+version: 8.3.1
+threshold: 85 # Đảm bảo an toàn hạ tầng và khả năng chịu lỗi (Rollback)
+
+metrics:
+  - id: secure_secrets_management
+    name: Quản lý Secrets an toàn (R-SEC-04)
+    description: Cấu hình CI/CD có vô tình làm lộ credentials không?
+    weight: 40
+    criteria:
+      - Tuyệt đối không hardcode API keys, mật khẩu hoặc tokens vào file cấu hình (20đ)
+      - Sử dụng cơ chế inject biến môi trường an toàn (Github Secrets, Vault) (20đ)
+
+  - id: robust_pipeline_design
+    name: Thiết kế Pipeline và Môi trường
+    description: Luồng CI/CD có phân tách rõ ràng và tự động hóa tốt không?
+    weight: 35
+    criteria:
+      - Phân tách rõ ràng cấu hình cho các môi trường (Dev, Staging, Prod) (15đ)
+      - Có quy trình containerization (Docker, K8s) hoặc chiến lược deployment hợp lý (20đ)
+
+  - id: rollback_strategy
+    name: Chiến lược Rollback
+    description: Có kịch bản dự phòng khi deploy thất bại không?
+    weight: 25
+    criteria:
+      - Có cơ chế hoặc hướng dẫn rõ ràng để rollback hệ thống về trạng thái ổn định trước đó (25đ)

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

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-docs
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Viết và duy trì tài liệu chính xác tuyệt đối — phải match code thực tế, cấm bịa đặt."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

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

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-docs"
+version: "8.3.1"
+description: "Viết và duy trì tài liệu chính xác tuyệt đối — phải match code thực tế, cấm bịa đặt."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "code-documentation"
+    - "architecture-docs"
+  references:
+    - "source-code"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-docs"
+  does_not_own: []
+  conflicts_with: []

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

@@ -0,0 +1,27 @@
+name: qk-docs-eval
+description: Đánh giá chất lượng tài liệu và kỹ năng viết Docs
+version: 8.3.1
+threshold: 85 # Đảm bảo tài liệu phản ánh chính xác 100% logic code thực tế
+
+metrics:
+  - id: accurate_documentation
+    name: Phản ánh chính xác Code (Không bịa đặt)
+    description: Tài liệu viết ra có khớp hoàn toàn với parameters/returns trong code không?
+    weight: 40
+    criteria:
+      - Đọc code trước khi viết, không tự bịa (hallucinate) các params/lỗi không tồn tại trong code (20đ)
+      - Sử dụng đúng format chuẩn (JSDoc/TSDoc) cho hàm/class (20đ)
+
+  - id: documentation_depth
+    name: Giải thích Nguyên nhân (WHY, not WHAT)
+    description: Comments có giải thích tại sao đoạn code tồn tại thay vì diễn giải lại code không?
+    weight: 35
+    criteria:
+      - Comment tập trung giải thích lý do (WHY) thay vì viết những dòng vô nghĩa (WHAT) như `// gets the user` (35đ)
+
+  - id: verify_accuracy
+    name: Kiểm chứng độ chính xác
+    description: Agent có đọc lại tài liệu sau khi viết để đối chiếu với code không?
+    weight: 25
+    criteria:
+      - Re-read để spot check lại từng param/type nhằm đảm bảo độ chính xác tuyệt đối (25đ)

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

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-engineering-standard
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule mơ hồ."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

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

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-engineering-standard"
+version: "8.3.1"
+description: "Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule mơ hồ."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "coding-standards"
+    - "best-practices"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-engineering-standard"
+  does_not_own: []
+  conflicts_with: []

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

@@ -0,0 +1,28 @@
+name: qk-engineering-standard-eval
+description: Đánh giá việc áp dụng Tiêu chuẩn Kỹ thuật và Clean Code
+version: 8.3.1
+threshold: 80 # Đánh giá tính chính xác của việc tính điểm Health Score
+
+metrics:
+  - id: concrete_thresholds
+    name: Áp dụng Thresholds định lượng
+    description: Agent có áp dụng đúng các ngưỡng cứng (Concrete Thresholds) không?
+    weight: 40
+    criteria:
+      - Nhận diện đúng hàm > 30 dòng, độ phức tạp > 10, file > 300 dòng (20đ)
+      - Phát hiện mã trùng lặp (DRY violation) nếu lặp lại >= 3 lần (20đ)
+
+  - id: health_score_calculation
+    name: Chấm điểm Health Score
+    description: Báo cáo có tính toán điểm sức khỏe (Health Score) chuẩn xác không?
+    weight: 35
+    criteria:
+      - Trừ điểm đúng theo thang điểm (CRITICAL: -25, HIGH: -10, MEDIUM: -5, LOW: -2) (20đ)
+      - Trả về đúng mức Exit Code tương ứng (SUCCESS nếu >=80, FAILED nếu <60) (15đ)
+
+  - id: non_intrusive_reporting
+    name: Báo cáo không can thiệp (Read-only)
+    description: Agent có tuân thủ quy tắc chỉ report mà không tự ý sửa code không?
+    weight: 25
+    criteria:
+      - Giữ nguyên trạng thái read-only, chỉ cung cấp report và suggestion (không tự sửa file) (25đ)

package/.agents/skills/qk-fe-api-integration/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-fe-api-integration
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base dự án"
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-fe-api-integration/capability.yaml

@@ -0,0 +1,21 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-fe-api-integration"
+version: "8.3.1"
+description: "Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base dự án"
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "api-integration"
+    - "state-management"
+  references:
+    - "architecture"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-fe-api-integration"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-fe-api-integration/evals/scorecard.yaml

@@ -0,0 +1,29 @@
+name: qk-fe-api-integration-eval
+description: Đánh giá chất lượng tích hợp API vào giao diện Frontend
+version: 8.3.1
+threshold: 85 # Đảm bảo tính toàn vẹn của DTO, UI State và ranh giới bảo mật
+
+metrics:
+  - id: type_and_validation
+    name: Khởi tạo Types và Validation (Zod)
+    description: Agent có gen ra Types và Zod schema từ JSON payload mẫu không?
+    weight: 30
+    criteria:
+      - Khởi tạo chính xác Zod Schema và xuất TypeScript interfaces (15đ)
+      - Phân biệt rõ ràng các trường bắt buộc và tùy chọn (.optional(), .nullable()) (15đ)
+
+  - id: architecture_compliance
+    name: Tuân thủ Kiến trúc dự án (Base Architecture)
+    description: Agent có tái sử dụng API Client có sẵn không?
+    weight: 30
+    criteria:
+      - Ưu tiên dùng wrapper có sẵn (Axios/TanStack Query) thay vì viết raw fetch tràn lan (15đ)
+      - Tuyệt đối không hardcode Base URL vào trong component (15đ)
+
+  - id: ui_state_handling
+    name: Xử lý State giao diện toàn diện
+    description: Có bao phủ đủ 3 trạng thái Loading, Success, Error không?
+    weight: 40
+    criteria:
+      - Xử lý mượt mà trạng thái Loading và Success (20đ)
+      - Có cơ chế bắt lỗi HTTP bài bản (401, 404, 500, Network Error) và map với Error state của giao diện (20đ)

package/.agents/skills/qk-feature-delivery/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-feature-delivery
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Phát triển tính năng mới end-to-end: Requirements → Context → Design → Implement → Self-audit."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-feature-delivery/capability.yaml

@@ -0,0 +1,24 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-feature-delivery"
+version: "8.3.1"
+description: "Phát triển tính năng mới end-to-end: Requirements → Context → Design → Implement → Self-audit."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "feature-implementation"
+    - "requirement-analysis"
+  references:
+    - "testing"
+    - "security"
+    - "anti-patterns"
+    - "design-system"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-feature-delivery"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-feature-delivery/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-feature-delivery-eval
+description: Đánh giá quy trình phát triển tính năng mới (End-to-End)
+version: 8.3.1
+threshold: 85 # Tính năng mới phải đáp ứng các tiêu chuẩn khắt khe trước khi hoàn thành
+
+metrics:
+  - id: requirement_and_context
+    name: Phân tích Yêu cầu và Ngữ cảnh
+    description: Agent có đọc kỹ requirements và context graph trước khi code không?
+    weight: 30
+    criteria:
+      - Đọc spec và DESIGN.md (nếu có UI) trước khi bắt đầu (15đ)
+      - Kiểm tra dependency graph qua qk-context-loader (15đ)
+
+  - id: implementation_standards
+    name: Tuân thủ Tiêu chuẩn Lập trình (R-C-09 & R-SEC-04)
+    description: Code sinh ra có sạch sẽ và an toàn không?
+    weight: 40
+    criteria:
+      - Tuân thủ Zero Slop (hàm < 30 dòng, không có God Files) (20đ)
+      - Tuân thủ Zero Trust (validate đầu vào chặt chẽ) (20đ)
+
+  - id: self_audit_and_testing
+    name: Kiểm thử và Tự kiểm toán (Self-Audit)
+    description: Agent có tự kiểm tra lại code thông qua Validation Gate không?
+    weight: 30
+    criteria:
+      - Bắt buộc gọi qk-validation-gate hoặc chạy linter/tests trước khi kết thúc (30đ)

package/.agents/skills/qk-frontend-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-frontend-architecture
-version: 8.1.0
+version: 8.3.1
 status: experimental
 description: "Công cụ quyết định kiến trúc Frontend (Chiến lược component, quản lý state, định tuyến)."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-frontend-architecture/capability.yaml

@@ -0,0 +1,28 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-frontend-architecture"
+version: "8.3.1"
+description: "Công cụ quyết định kiến trúc Frontend (Chiến lược component, quản lý state, định tuyến)."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "qk-frontend-architecture"
+  references:
+    - "architecture"
+    - "coding"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "architecture decisions"
+    - "state strategy"
+  does_not_own:
+    - "component implementation"
+    - "pixel styling"
+  conflicts_with:
+    - "qk-ui-builder"
+  delegates_to:
+    - "qk-ui-builder"
+    - "qk-ui-system-builder"

package/.agents/skills/qk-frontend-architecture/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-frontend-architecture-eval
+description: Đánh giá năng lực thiết kế Kiến trúc Frontend
+version: 8.3.1
+threshold: 85 # Đảm bảo các quyết định kiến trúc đúng đắn và không bị lấn sân
+
+metrics:
+  - id: tech_stack_selection
+    name: Lựa chọn Tech Stack & State Management
+    description: Các lựa chọn công nghệ có tuân theo quy chuẩn dự án không?
+    weight: 40
+    criteria:
+      - Ưu tiên TanStack Query cho Server State và Zustand/Context cho Client State (20đ)
+      - Lựa chọn đúng cơ chế Routing (Next.js App Router hoặc TanStack Router) (20đ)
+
+  - id: component_breakdown
+    name: Chiến lược phân tách Component
+    description: Cấu trúc component có hợp lý và dễ bảo trì không?
+    weight: 30
+    criteria:
+      - Phân chia component rõ ràng (Smart vs Dumb components) (15đ)
+      - Ngăn chặn triệt để các Anti-patterns trong luồng dữ liệu (R-C-09) (15đ)
+
+  - id: boundary_respect
+    name: Tôn trọng ranh giới Kiến trúc
+    description: Agent có tập trung vào kiến trúc thay vì viết UI trực tiếp không?
+    weight: 30
+    criteria:
+      - Giữ vai trò Kiến trúc sư (Architect), không lấn sân sang việc viết pixel styling hay implement chi tiết UI (nhường cho qk-ui-builder) (30đ)

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

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-help
-version: 8.0.0
+version: 8.3.1
 status: deprecated
 description: "Hiển thị danh sách skills V8 và hướng dẫn dùng lệnh ./qk-[skill-name]."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -29,7 +29,7 @@ triggers:
   - "qk-help"
 
 # ── V8: References ─────────────────────────────────────────
-workflow: internal
+workflow: documentation
 
 rules:
   - global

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

@@ -0,0 +1,20 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-help"
+version: "8.3.1"
+description: "Hiển thị danh sách skills V8 và hướng dẫn dùng lệnh ./qk-[skill-name]."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "skill-directory"
+  references:
+    - "registry"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-help"
+  does_not_own: []
+  conflicts_with: []

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

@@ -0,0 +1,13 @@
+name: qk-help-eval
+description: Đánh giá khả năng cung cấp thông tin hướng dẫn
+version: 8.3.1
+threshold: 100 # Kỹ năng đơn giản, yêu cầu độ chính xác cao khi cung cấp thông tin
+
+metrics:
+  - id: provide_accurate_info
+    name: Cung cấp thông tin chính xác
+    description: Agent có in ra đúng các lệnh và kiến trúc V8.3 không?
+    weight: 100
+    criteria:
+      - Hướng dẫn cú pháp ./qk-[skill-name] rõ ràng (50đ)
+      - Liệt kê chính xác danh sách các Quality Gates của hệ thống (50đ)

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

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-orchestrator
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm tra preconditions và routing table."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

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

@@ -0,0 +1,22 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-orchestrator"
+version: "8.3.1"
+description: "Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm tra preconditions và routing table."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "task-routing"
+    - "skill-selection"
+    - "precondition-validation"
+  references:
+    - "all-skills"
+    - "architecture"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-orchestrator"
+  does_not_own: []
+  conflicts_with: []

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

@@ -0,0 +1,27 @@
+name: qk-orchestrator-eval
+description: Đánh giá khả năng điều phối và định tuyến tác vụ (Task Routing)
+version: 8.3.1
+threshold: 85 # Đóng vai trò kiểm soát luồng, yêu cầu độ chính xác cao
+
+metrics:
+  - id: intent_classification
+    name: Phân loại Intent chính xác
+    description: Agent có hiểu đúng yêu cầu và route đến đúng skill tương ứng không?
+    weight: 35
+    criteria:
+      - Phân tích và map đúng ý định người dùng với Routing Table (20đ)
+      - Đặt câu hỏi làm rõ nếu yêu cầu quá mờ nhạt thay vì đoán mò (15đ)
+
+  - id: precondition_enforcement
+    name: Kỷ luật kiểm tra Tiền điều kiện (Preconditions)
+    description: Cố tình route tác vụ khi thiếu thông tin hay chặn lại để yêu cầu cung cấp thêm?
+    weight: 35
+    criteria:
+      - Bắt buộc kiểm tra Preconditions của skill đích TRƯỚC KHI thực sự gọi skill đó (35đ)
+
+  - id: pipeline_execution
+    name: Thực thi Pipeline tuần tự
+    description: Có đảm bảo tuân thủ chuỗi phụ thuộc (e.g., context-loader -> feature-delivery) không?
+    weight: 30
+    criteria:
+      - Bắt buộc gọi các kỹ năng bổ trợ (như qk-context-loader cho Logic) trước khi bắt đầu công việc chính (30đ)

package/.agents/skills/qk-product-specification/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-product-specification
-version: 8.1.0
+version: 8.3.1
 status: experimental
 description: "Product thinking (Idea → Requirement → Acceptance criteria → Technical spec)."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-product-specification/capability.yaml

@@ -0,0 +1,27 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-product-specification"
+version: "8.3.1"
+description: "Product thinking (Idea → Requirement → Acceptance criteria → Technical spec)."
+tools:
+  - "filesystem"
+knowledge:
+  owns:
+    - "qk-product-specification"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "technical-ready specification"
+    - "acceptance criteria"
+  does_not_own:
+    - "market research"
+    - "pricing"
+    - "roadmap"
+  conflicts_with: []
+  delegates_to:
+    - "qk-feature-delivery"

package/.agents/skills/qk-product-specification/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-product-specification-eval
+description: Đánh giá Tư duy Sản phẩm và Phân tích Yêu cầu
+version: 8.3.1
+threshold: 85 # Đảm bảo Spec rõ ràng và chứa đầy đủ tiêu chí bảo mật
+
+metrics:
+  - id: requirement_clarification
+    name: Làm rõ Yêu cầu (Requirement Analysis)
+    description: Agent có phân tích sâu ý tưởng để xác định ranh giới tính năng không?
+    weight: 35
+    criteria:
+      - Từ một Idea mơ hồ, bóc tách thành các gạch đầu dòng rõ ràng về scope (những gì làm và KHÔNG làm) (35đ)
+
+  - id: acceptance_criteria_quality
+    name: Chất lượng Acceptance Criteria (AC)
+    description: Các tiêu chí nghiệm thu có định lượng và bao phủ các trường hợp không?
+    weight: 35
+    criteria:
+      - Liệt kê các AC mạch lạc, testable (kiểm thử được) (15đ)
+      - BẮT BUỘC phải có tiêu chí bảo mật (Security AC) theo chuẩn R-SEC-04 (Zero Trust) (20đ)
+
+  - id: technical_readiness
+    name: Mức độ sẵn sàng cho Kỹ thuật (Technical Spec)
+    description: Spec viết ra có đủ độ chi tiết để delegate cho qk-feature-delivery chưa?
+    weight: 30
+    criteria:
+      - Tài liệu đầu ra được cấu trúc chặt chẽ (Technical Ready) không để lập trình viên phải đoán mò (30đ)

package/.agents/skills/qk-production-release/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-production-release
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -28,7 +28,7 @@ triggers:
   - "kiểm tra release"
 
 # ── V8: References ─────────────────────────────────────────
-workflow: internal
+workflow: production-release
 
 rules:
   - global

package/.agents/skills/qk-production-release/capability.yaml

@@ -0,0 +1,27 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-production-release"
+version: "8.3.1"
+description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "release-checklist"
+    - "deployment-gate"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "release-gate-checklist"
+    - "deployment-readiness-verdict"
+  does_not_own:
+    - "ci-cd-pipeline-design"
+    - "infrastructure-provisioning"
+  conflicts_with:
+    - "qk-devops-platform"