ai-developer-skill-os 9.3.1 → 10.1.0

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

@@ -1,21 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-fe-api-integration"
-version: "9.1.0"
-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

@@ -1,29 +0,0 @@
-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: 9.1.0
-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/capability.yaml

@@ -1,24 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-feature-delivery"
-version: "9.1.0"
-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-frontend-architecture/SKILL.md

@@ -1,127 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-frontend-architecture
-version: 9.2.1
-status: archived
-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]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - frontend-architecture
-  - component-strategy
-  - state-management
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "5-10"
-    has_behavior_change: true
-    has_external_dependency: true
-    has_breaking_change: false
-
-triggers:
-  - "cấu trúc frontend"
-  - "thiết kế component"
-  - "quản lý state"
-  - "kiến trúc react"
-
-# ── V8: References ─────────────────────────────────────────
-workflow: feature-delivery
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-
-related_skills:
-  - qk-design-system-engineering
-  - qk-web-quality-gate
-
-knowledge_scope:
-  domain:
-    - react
-    - frontend-architecture
-    - state-management
-  concepts:
-    - component-hierarchy
-    - routing-strategy
-  references:
-    - architecture
-    - coding
-    - anti-patterns
-
-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
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: feature
-
-lifecycle:
-  promotion_gate:
-    requirements:
-      tests:
-        minimum_pass_rate: 0.95
-      usage:
-        minimum_runs: 20
-      conflicts:
-        zero_boundary_violation: true
-      evidence:
-        required:
-          - evaluation_report
-          - usage_history
-          - boundary_audit
-  demotion_gate:
-    triggers:
-      - repeated_failure
-      - boundary_violation
-      - outdated_reference
-    action:
-      change_status: "stable -> experimental"
-
-selection:
-  priority: medium
-  confidence_threshold: 0.80
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: medium
-risk: low
-side_effects: read_only
-produces: [report, architecture_plan]
-consumes: [user-description]
-
-token_budget:
-  max_files_read: 5
-  max_lines_per_read: 150
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-frontend-architecture — Frontend Architect
-
-> **⚠️ ARCHIVED (v9.2.1):** Skill này đã được archive. Conflict với `qk-ui-builder`. Quyết định kiến trúc FE được xử lý qua `DEV_PROFILE.md` + `qk-ui-builder`.
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.

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

@@ -1,28 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-frontend-architecture"
-version: "9.1.0"
-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

@@ -1,28 +0,0 @@
-name: qk-frontend-architecture-eval
-description: Đánh giá năng lực thiết kế Kiến trúc Frontend
-version: 9.1.0
-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,107 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-help
-version: 9.1.0
-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]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - skill-discovery
-  - command-help
-
-complexity:
-  level: low
-  criteria:
-    files_affected: "1"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "help"
-  - "có những skill nào"
-  - "danh sách skill"
-  - "làm sao để dùng"
-  - "qk-help"
-
-# ── V8: References ─────────────────────────────────────────
-workflow: documentation
-
-rules:
-  - global
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-orchestrator
-
-knowledge_scope:
-  owns:
-    - skill-directory
-  references:
-    - registry
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: false
-  strategy: none
-
-selection:
-  priority: low
-  confidence_threshold: 0.75
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: low
-latency: fast
-risk: low
-side_effects: none
-produces: [skill-recommendation]
-consumes: [registry]
-
-token_budget:
-  max_files_read: 1
-  max_lines_per_read: 150
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS]
----
-
-# 🆘 V8.3 Skill System Help
-
-> Lệnh: `./qk-help`
-
-Hệ thống AI Developer Skin V8.3 (Zero-Trust & Anti-Slop Architecture) sử dụng kiến trúc **Governed Capabilities** thay vì Prompt Engineering truyền thống. Mỗi kỹ năng (skill) là một module độc lập, có Decision Boundary (giới hạn quyền hạn) và Token Budget (ngân sách thực thi) riêng.
-
-## 🛠 Cách Kích Hoạt Kỹ Năng
-Gõ `./qk-[tên-skill] [yêu cầu của bạn]`
-
-**Ví dụ:**
-- `./qk-ui-builder tạo trang login với Tailwind`
-- `./qk-feature-delivery thêm tính năng quên mật khẩu`
-- `./qk-bug-resolution fix lỗi hydration mismatch ở trang chủ`
-- `./qk-project-health đánh giá codebase`
-
-## 🚦 V8.3 Quality Gates
-Hệ thống áp dụng các checkpoint nghiêm ngặt. Nếu không qua được, AI sẽ tự động Block:
-1. **Validation Gate:** `qk-validation-gate` chạy lint/test/type-check.
-2. **Release Gate:** `qk-production-release` kiểm tra 8 cổng trước khi deploy.
-3. **Web Quality Gate:** `qk-web-quality-gate` check A11y, SEO, Performance.
-4. **UI Audit Gate:** `qk-ui-audit` check Anti-Slop (R-C-09).
-5. **Security Gate:** Tất cả các luồng phải tuân thủ Zero-Trust (R-SEC-04).
-
-## 📋 Xem Danh Sách Kỹ Năng
-Các kỹ năng được chia theo nhóm (Capabilities).
-Đọc file `.agents/skills/skills.json` hoặc thư mục `.agents/skills/` để xem toàn bộ danh sách.
-
-*Mẹo: Nếu không biết dùng skill nào, hãy nhờ `qk-orchestrator` phân tích yêu cầu của bạn.*

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

@@ -1,20 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-help"
-version: "9.1.0"
-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

@@ -1,13 +0,0 @@
-name: qk-help-eval
-description: Đánh giá khả năng cung cấp thông tin hướng dẫn
-version: 9.1.0
-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/capability.yaml

@@ -1,22 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-orchestrator"
-version: "9.1.0"
-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-product-specification/SKILL.md

@@ -1,187 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-product-specification
-version: 9.2.0
-status: experimental
-description: "Product thinking (Idea → Requirement → Acceptance criteria → Technical spec). Dùng skill này khi user nhắc đến: viết spec, phân tích yêu cầu, acceptance criteria, prd, đặc tả kỹ thuật, user story, làm rõ yêu cầu — kể cả khi chỉ nói 'tôi có ý tưởng làm tính năng X'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - product-specification
-  - requirement-analysis
-  - acceptance-criteria
-  - technical-spec
-
-complexity:
-  level: medium
-  criteria:
-    files_affected: "1-3"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "viết spec"
-  - "phân tích yêu cầu"
-  - "acceptance criteria"
-  - "prd"
-  - "đặc tả kỹ thuật"
-  - "user story"
-  - "làm rõ yêu cầu"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: spec-driven-development
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-
-related_skills:
-  - qk-feature-delivery
-
-knowledge_scope:
-  domain:
-    - product-requirements
-    - technical-specifications
-  concepts:
-    - user-story
-    - acceptance-criteria
-  references:
-    - architecture
-    - security
-    - anti-patterns
-
-decision_boundary:
-  owns:
-    - technical-ready specification
-    - acceptance criteria
-  does_not_own:
-    - market research
-    - pricing
-    - roadmap
-  conflicts_with: []
-  delegates_to:
-    - qk-feature-delivery
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: feature
-
-selection:
-  priority: medium
-  confidence_threshold: 0.80
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: medium
-risk: low
-side_effects: read_only
-produces: [report, specification]
-consumes: [user-description]
-
-token_budget:
-  max_files_read: 3
-  max_lines_per_read: 150
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-product-specification — Product & Technical Specifier
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm chuyển hóa các ý tưởng kinh doanh còn mơ hồ thành bản đặc tả kỹ thuật chi tiết (Technical Specification & PRD) hoàn chỉnh: **User Problem → User Stories → Acceptance Criteria (Given-When-Then) → Technical Constraints & Edge Cases**.
-
----
-
-## Preconditions
-
-Trước khi viết đặc tả kỹ thuật, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định đối tượng người dùng cuối (User persona) và bài toán kinh doanh cần giải quyết.
-- [ ] Đọc `.agents/DEV_PROFILE.md` để hiểu kiến trúc tổng quan và các ràng buộc công nghệ sẵn có.
-- [ ] Kiểm tra xem ý tưởng có mục tiêu đầu ra (Success metric / KPI) cụ thể chưa.
-- [ ] Nếu ý tưởng hoàn toàn không có mục đích sử dụng rõ ràng:
-  → **EXIT: BLOCKED**
-  → Báo cáo user câu hỏi định hình mục tiêu trước khi lập tài liệu spec.
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Viết User Stories theo chuẩn: "As a [role], I want to [action], so that [benefit]".
-- Thiết lập Acceptance Criteria (AC) theo định dạng BDD Given/When/Then.
-- Liệt kê Edge Cases, Empty States, Error States, Permission constraints.
-- Phác thảo Data Model sơ bộ và các API endpoints cần có để phục vụ kỹ sư triển khai.
-- Chế độ hoạt động: **Read-Only / Documentation Output** (không can thiệp vào code).
-
-❌ Skill này KHÔNG làm:
-- Trực tiếp triển khai mã nguồn (→ chuyển giao cho `qk-feature-delivery`).
-- Nghiên cứu thị trường sâu, định giá sản phẩm (Pricing) hay marketing strategy.
-- Thiết kế UI Mockup chi tiết (→ `qk-ui-builder`).
-
----
-
-## Execution Steps
-
-### Step 1 — Problem Framing & Persona Identification
-```
-Inputs:  Ý tưởng thô từ user
-Actions:
-  - Xác định ai là người hưởng lợi trực tiếp từ tính năng.
-  - Phân tách bài toán cốt lõi (Core problem) khỏi các mong muốn phụ (Nice-to-haves).
-Output: Problem statement & User personas
-```
-
-### Step 2 — Story Mapping & Scope Boundary
-```
-Inputs:  Problem statement
-Actions:
-  - Chia nhỏ tính năng thành các User Stories độc lập, có thể bàn giao trong từng sprint.
-  - Phân loại rõ ràng: In-Scope (Làm ngay) vs Out-of-Scope (Giai đoạn sau).
-Output: User stories & Scope fence
-```
-
-### Step 3 — Acceptance Criteria & Edge Cases Definition
-```
-Inputs:  User stories
-Actions:
-  - Viết Acceptance Criteria rõ ràng cho từng story (Given/When/Then).
-  - Định nghĩa các trường hợp biên: Dữ liệu quá lớn, mất mạng, token hết hạn, quyền truy cập bị từ chối.
-Output: Verification criteria
-```
-
-### Step 4 — Technical Blueprint Hand-off
-```
-Inputs:  Stories, AC, DEV_PROFILE.md
-Actions:
-  - Phác thảo kiến trúc kỹ thuật dự kiến: Entity fields, API route patterns.
-  - Tổng hợp thành file markdown đặc tả (Spec Markdown Document) sẵn sàng chuyển giao cho kỹ sư.
-Exit: SUCCESS
-```
-
----
-
-## Prompt Template
-
-```
-Ý tưởng:     [Mô tả tính năng hoặc ý tưởng của bạn]
-Đối tượng:   [Ai sẽ dùng tính năng này — admin / user thông thường / khách vãng lai]
-Mục đích:    [Giải quyết vấn đề gì, mang lại giá trị gì]
-Ràng buộc:   [Thời hạn, không được đụng vào phần nào của hệ thống]
-```

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

@@ -1,27 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-product-specification"
-version: "9.1.0"
-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

@@ -1,27 +0,0 @@
-name: qk-product-specification-eval
-description: Đánh giá Tư duy Sản phẩm và Phân tích Yêu cầu
-version: 9.1.0
-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đ)