ai-developer-skill-os 7.5.0 → 8.1.4

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

@@ -1,9 +1,66 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-data-lifecycle
-category: backend
-version: 7.5.0
+version: 8.0.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - schema-management
+  - database-migration
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "sửa schema"
+  - "cập nhật database"
+  - "tạo migration"
+  - "đổi model"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-db-optimizer
+
+knowledge_scope:
+  owns:
+    - schema
+    - migrations
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: migration-safety
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
@@ -11,15 +68,14 @@ risk: high
 side_effects: edit_files
 produces: [code, schema]
 consumes: [context-graph, user-description]
+
 token_budget:
   max_files_read: 4
   max_lines_per_read: 100
   max_shell_commands: 1
   stop_early: false
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-data-lifecycle — Database Schema & Repository Manager

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

@@ -1,9 +1,66 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-db-optimizer
-category: backend
-version: 7.5.0
+version: 8.0.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - database-optimization
+  - performance-tuning
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "tối ưu query"
+  - "query chậm"
+  - "optimize db"
+  - "thêm index"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: refactor
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-data-lifecycle
+
+knowledge_scope:
+  owns:
+    - database-performance
+    - query-optimization
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: performance-regression
+
+selection:
+  priority: medium
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: medium
 latency: medium
@@ -11,15 +68,14 @@ risk: medium
 side_effects: edit_files
 produces: [code, report]
 consumes: [query-log, source-code]
+
 token_budget:
   max_files_read: 3
   max_lines_per_read: 100
   max_shell_commands: 2
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-db-optimizer — Database Performance Tuner

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

@@ -0,0 +1,112 @@
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-design-system-engineering
+version: 8.1.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - design-system
+  - tokens
+  - component-library
+  - accessibility
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "định nghĩa design system"
+  - "cấu trúc token"
+  - "quy chuẩn ui"
+  - "variants"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+
+related_skills:
+  - qk-frontend-architecture
+
+knowledge_scope:
+  domain:
+    - design-system
+    - tokens
+  concepts:
+    - visual-consistency
+    - components-rules
+  references:
+    - architecture
+
+decision_boundary:
+  owns:
+    - tokens
+    - components rules
+    - design governance
+  does_not_own:
+    - page implementation
+    - business logic
+  conflicts_with:
+    - qk-ui-system-builder
+
+knowledge_dependencies:
+  - design-intelligence
+  - accessibility-guidelines
+  - component-patterns
+
+# ── 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, tokens_definition]
+consumes: [user-description]
+
+token_budget:
+  max_files_read: 5
+  max_lines_per_read: 150
+  max_shell_commands: 0
+  stop_early: false
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-design-system-engineering — Design System Governance
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Brand guidelines hoặc UX heuristics cơ bản đã có.
+
+## Scope
+- Định nghĩa các quy tắc hệ thống cho tokens, khoảng cách (spacing), màu sắc, phông chữ (typography).
+- Xác định quy chuẩn xây dựng component (composition, variants).
+- Thiết lập quy tắc A11y (Accessibility) ở cấp độ token.
+- KHÔNG thay thế việc viết UI code (`qk-ui-system-builder`). Skill này là "governance", không phải "implementation".

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

@@ -0,0 +1,117 @@
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-devops-platform
+version: 8.1.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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - devops-strategy
+  - cicd-pipeline
+  - deployment-architecture
+  - environment-management
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "cấu hình ci/cd"
+  - "deployment strategy"
+  - "quản lý môi trường"
+  - "devops platform"
+  - "dockerize"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+  - security
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-production-release
+  - qk-security-audit
+
+knowledge_scope:
+  domain:
+    - devops
+    - platform-engineering
+    - cloud-infrastructure
+  concepts:
+    - continuous-integration
+    - continuous-deployment
+    - containerization
+    - rollback-strategy
+  references:
+    - architecture
+
+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
+
+# ── 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: high
+side_effects: edit_files
+produces: [report, plan, code]
+consumes: [user-description]
+
+token_budget:
+  max_files_read: 5
+  max_lines_per_read: 150
+  max_shell_commands: 2
+  stop_early: false
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-devops-platform — Platform Engineer
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Requirements cho môi trường triển khai đã có sẵn.
+
+## Scope
+- Thiết kế và thiết lập luồng CI/CD (GitHub Actions, GitLab CI, v.v.).
+- Xây dựng kiến trúc deployment, quản lý các container (Docker, Kubernetes).
+- Đưa ra chiến lược Rollback an toàn khi có sự cố.
+- Quản lý và phân tách các môi trường (Dev, Staging, Prod).
+- KHÔNG thay thế `qk-production-release` (đóng gói và release app), skill này quản lý *hạ tầng và quy trình* bên dưới việc release đó.

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

@@ -1,9 +1,66 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-docs
-category: documentation
-version: 7.5.0
+version: 8.0.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - documentation
+  - technical-writing
+
+complexity:
+  level: low
+  criteria:
+    files_affected: "1-3"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "viết docs"
+  - "viết tài liệu"
+  - "document this"
+  - "generate docs"
+  - "cập nhật readme"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: documentation
+
+rules:
+  - global
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - code-documentation
+    - architecture-docs
+  references:
+    - source-code
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: documentation
+
+selection:
+  priority: medium
+  confidence_threshold: 0.75
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: low
 latency: fast
@@ -11,20 +68,19 @@ risk: low
 side_effects: edit_files
 produces: [report]
 consumes: [source-code]
+
 token_budget:
   max_files_read: 3
   max_lines_per_read: 100
   max_shell_commands: 0
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-docs — Technical Writer & Documentation Maintainer
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---
 

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

@@ -1,11 +1,69 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-engineering-standard
-category: qa
-version: 7.5.0
+version: 8.0.0
+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]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - code-quality
+  - standards-enforcement
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "review code"
+  - "clean code"
+  - "check standard"
+  - "refactor clean"
+  - "kiểm tra chuẩn"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: code-review
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-project-health
+  - qk-system-evolution
+
+knowledge_scope:
+  owns:
+    - coding-standards
+    - best-practices
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+selection:
+  priority: high
+  confidence_threshold: 0.80
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: medium
 latency: medium
 risk: low
@@ -20,19 +78,11 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-engineering-standard — Code Quality Enforcer
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ## Preconditions
 - [ ] Target file(s) or module(s) are specified

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

@@ -1,11 +1,68 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-fe-api-integration
-category: frontend
-version: 7.5.0
+version: 8.0.0
+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]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - api-integration
+  - frontend-development
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "tích hợp api"
+  - "gọi api"
+  - "fetch data"
+  - "consume api"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-api-lifecycle
+  - qk-ui-builder
+
+knowledge_scope:
+  owns:
+    - api-integration
+    - state-management
+  references:
+    - architecture
+
+# ── 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
@@ -20,9 +77,6 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-fe-api-integration — Frontend API Consumer