ai-developer-skill-os 8.3.0 → 8.3.1

package/.agents/registry/index.yaml

@@ -2,257 +2,231 @@
 # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
 schema_version: 1
 manifest_version: '8.2'
-generated_at: '2026-07-29T04:03:48.865Z'
+generated_at: '2026-07-29T10:15:54.630Z'
 capabilities:
   qk-access-policy:
     path: .agents/skills/qk-access-policy
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - access
       - policy
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-agent-observability:
     path: .agents/skills/qk-agent-observability
-    version: 8.1.3
+    version: 8.3.1
     tags:
       - agent
       - observability
-    dependencies:
-      - skill-evolution
+    dependencies: []
   qk-ai-builder:
     path: .agents/skills/qk-ai-builder
-    version: 8.2.0
+    version: 8.3.1
     tags:
       - ai
       - builder
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-api-lifecycle:
     path: .agents/skills/qk-api-lifecycle
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - api
       - lifecycle
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-bug-resolution:
     path: .agents/skills/qk-bug-resolution
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - bug
       - resolution
-    dependencies:
-      - bug-resolution
+    dependencies: []
   qk-code-review:
     path: .agents/skills/qk-code-review
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - code
       - review
-    dependencies:
-      - code-review
+    dependencies: []
   qk-context-loader:
     path: .agents/skills/qk-context-loader
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - context
       - loader
-    dependencies:
-      - research
+    dependencies: []
   qk-data-lifecycle:
     path: .agents/skills/qk-data-lifecycle
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - data
       - lifecycle
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-db-optimizer:
     path: .agents/skills/qk-db-optimizer
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - db
       - optimizer
-    dependencies:
-      - refactor
+    dependencies: []
   qk-design-system-engineering:
     path: .agents/skills/qk-design-system-engineering
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - design
       - system
       - engineering
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-devops-platform:
     path: .agents/skills/qk-devops-platform
-    version: 8.1.1
+    version: 8.3.1
     tags:
       - devops
       - platform
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-docs:
     path: .agents/skills/qk-docs
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - docs
-    dependencies:
-      - documentation
+    dependencies: []
   qk-engineering-standard:
     path: .agents/skills/qk-engineering-standard
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - engineering
       - standard
-    dependencies:
-      - code-review
+    dependencies: []
   qk-fe-api-integration:
     path: .agents/skills/qk-fe-api-integration
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - fe
       - api
       - integration
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-feature-delivery:
     path: .agents/skills/qk-feature-delivery
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - feature
       - delivery
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-frontend-architecture:
     path: .agents/skills/qk-frontend-architecture
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - frontend
       - architecture
-    dependencies:
-      - feature-delivery
-      - qk-ui-builder
-      - qk-ui-system-builder
+    dependencies: []
   qk-help:
     path: .agents/skills/qk-help
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - help
-    dependencies:
-      - internal
+    dependencies: []
   qk-orchestrator:
     path: .agents/skills/qk-orchestrator
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - orchestrator
-    dependencies:
-      - research
+    dependencies: []
   qk-product-specification:
     path: .agents/skills/qk-product-specification
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - product
       - specification
-    dependencies:
-      - spec-driven-development
-      - qk-feature-delivery
+    dependencies: []
   qk-production-release:
     path: .agents/skills/qk-production-release
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - production
       - release
-    dependencies:
-      - internal
+    dependencies: []
   qk-project-bootstrap:
     path: .agents/skills/qk-project-bootstrap
-    version: 8.2.0
+    version: 8.3.1
     tags:
       - project
       - bootstrap
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-project-health:
     path: .agents/skills/qk-project-health
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - project
       - health
-    dependencies:
-      - code-review
+    dependencies: []
   qk-project-memory:
     path: .agents/skills/qk-project-memory
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - project
       - memory
+    dependencies: []
+  qk-refactor:
+    path: .agents/skills/qk-refactor
+    version: 8.3.1
+    tags:
+      - refactor
     dependencies:
-      - documentation
+      - refactor
   qk-security-audit:
     path: .agents/skills/qk-security-audit
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - security
       - audit
-    dependencies:
-      - security-audit
-      - qk-validation-gate
+    dependencies: []
   qk-system-evolution:
     path: .agents/skills/qk-system-evolution
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - system
       - evolution
-    dependencies:
-      - refactor
+    dependencies: []
   qk-test-engineering:
     path: .agents/skills/qk-test-engineering
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - test
       - engineering
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-ui-audit:
     path: .agents/skills/qk-ui-audit
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - ui
       - audit
-    dependencies:
-      - code-review
+    dependencies: []
   qk-ui-builder:
     path: .agents/skills/qk-ui-builder
-    version: 8.2.0
+    version: 8.3.1
     tags:
       - ui
       - builder
-    dependencies: []
+    dependencies:
+      - feature-delivery
   qk-ui-system-builder:
     path: .agents/skills/qk-ui-system-builder
-    version: 8.0.0
+    version: 8.3.1
     tags:
       - ui
       - system
       - builder
-    dependencies:
-      - feature-delivery
+    dependencies: []
   qk-validation-gate:
     path: .agents/skills/qk-validation-gate
-    version: 8.2.0
+    version: 8.3.1
     tags:
       - validation
       - gate
-    dependencies:
-      - code-review
+    dependencies: []
   qk-web-quality-gate:
     path: .agents/skills/qk-web-quality-gate
-    version: 8.1.0
+    version: 8.3.1
     tags:
       - web
       - quality
       - gate
-    dependencies:
-      - feature-delivery
+    dependencies: []

package/.agents/registry/skills-index.yml

@@ -1,8 +1,8 @@
 # registry/skills-index.yml
-# GENERATED FILE — DO NOT EDIT MANUALLY
+# GENERATED FILE - DO NOT EDIT MANUALLY.
 version: 8.1.1
-generated_at: '2026-07-23T06:25:44.553Z'
-total_skills: 30
+generated_at: '2026-07-29T07:30:07.984Z'
+total_skills: 31
 skills:
   - name: qk-access-policy
     version: 8.0.0
@@ -24,8 +24,8 @@ skills:
     version: 8.1.3
     status: experimental
     description: >-
-      Agent Observability layer for tracking decisions, routing metrics, and
-      failure patterns.
+      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.
     complexity: medium
     workflow: skill-evolution
     triggers:
@@ -37,11 +37,11 @@ skills:
       - agent-metrics
       - decision-trace
   - name: qk-ai-builder
-    version: 8.0.0
+    version: 8.2.0
     status: stable
     description: >-
-      Thiết kế AI logic, Prompts, RAG pipelines với bảo mật chống Injection —
-      structured output bắt buộc.
+      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.
     complexity: high
     workflow: feature-delivery
     triggers:
@@ -87,6 +87,27 @@ skills:
       - bug-fixing
       - debugging
       - error-resolution
+  - name: qk-code-review
+    version: 8.0.0
+    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.
+    complexity: high
+    workflow: code-review
+    triggers:
+      - review code
+      - code review
+      - kiểm tra code
+      - đánh giá code
+      - review skin
+      - review rule
+      - review ai
+    intent:
+      - code-review
+      - quality-assurance
+      - architecture-review
+      - ai-config-audit
   - name: qk-context-loader
     version: 8.0.0
     status: stable
@@ -141,8 +162,8 @@ skills:
     version: 8.1.0
     status: experimental
     description: >-
-      Governance cho Design System (Định nghĩa system rules, tokens, component
-      variants).
+      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).
     complexity: medium
     workflow: feature-delivery
     triggers:
@@ -159,8 +180,8 @@ skills:
     version: 8.1.1
     status: experimental
     description: >-
-      Platform engineering: CI/CD strategy, deployment architecture, environment
-      management, and rollback strategy.
+      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.
     complexity: high
     workflow: feature-delivery
     triggers:
@@ -246,8 +267,8 @@ skills:
     version: 8.1.0
     status: experimental
     description: >-
-      Frontend architecture decision engine (Component strategy, state
-      management, routing).
+      Công cụ quyết định kiến trúc Frontend (Chiến lược component, quản lý
+      state, định tuyến).
     complexity: high
     workflow: feature-delivery
     triggers:
@@ -264,7 +285,7 @@ skills:
     status: deprecated
     description: Hiển thị danh sách skills V8 và hướng dẫn dùng lệnh ./qk-[skill-name].
     complexity: low
-    workflow: internal
+    workflow: documentation
     triggers:
       - help
       - có những skill nào
@@ -320,7 +341,7 @@ skills:
       Chuẩn bị release production với 8-gate checklist bắt buộc — không pass
       gate = không deploy.
     complexity: high
-    workflow: internal
+    workflow: production-release
     triggers:
       - release production
       - deploy production
@@ -330,11 +351,11 @@ skills:
       - release-management
       - production-deployment
   - name: qk-project-bootstrap
-    version: 8.0.0
+    version: 8.2.0
     status: stable
     description: >-
-      Khởi tạo dự án mới với cấu trúc chuẩn, linters, DESIGN.md — không bao giờ
-      thiếu foundation.
+      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.
     complexity: high
     workflow: feature-delivery
     triggers:
@@ -380,6 +401,25 @@ skills:
     intent:
       - context-management
       - knowledge-retrieval
+  - name: qk-refactor
+    version: 8.0.0
+    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.
+    complexity: medium
+    workflow: refactor
+    triggers:
+      - refactor
+      - tái cấu trúc
+      - clean up this code
+      - simplify
+      - reduce complexity
+      - dẫn cấu trúc code
+    intent:
+      - refactoring
+      - code-cleanup
+      - complexity-reduction
   - name: qk-security-audit
     version: 8.1.0
     status: experimental
@@ -419,8 +459,8 @@ skills:
     version: 8.1.0
     status: experimental
     description: >-
-      Testing strategy decision engine (Unit, Integration, E2E, Coverage,
-      Regression, Mock strategy).
+      Công cụ quyết định chiến lược kiểm thử (Unit, Integration, E2E, Coverage,
+      Regression, Mock).
     complexity: high
     workflow: feature-delivery
     triggers:
@@ -430,17 +470,17 @@ skills:
       - test coverage
     intent:
       - testing-strategy
-      - unit-test
-      - integration-test
-      - e2e-test
+      - unit-test-strategy
+      - integration-test-strategy
+      - e2e-test-strategy
       - mock-strategy
-      - test-coverage
+      - test-coverage-planning
   - name: qk-ui-audit
     version: 8.0.0
     status: stable
     description: >-
-      Kiểm toán giao diện (UI) với 57-point Anti-Slop checklist — fail nếu score
-      < 90/100.
+      Kiểm toán giao diện (UI) với 57-check Anti-Slop checklist — fail nếu score
+      < 76/85 base.
     complexity: medium
     workflow: code-review
     triggers:
@@ -452,23 +492,6 @@ skills:
     intent:
       - ui-audit
       - codebase-health
-  - name: qk-ui-builder
-    version: 8.0.0
-    status: stable
-    description: >-
-      Xây dựng, sửa, audit, và học UI — từ Figma/ảnh, map API, fix bug UI, đến
-      redesign cấu trúc.
-    complexity: high
-    workflow: feature-delivery
-    triggers:
-      - build ui
-      - làm giao diện
-      - design ui
-      - css
-      - giao diện
-    intent:
-      - ui-development
-      - frontend-design
   - name: qk-ui-system-builder
     version: 8.0.0
     status: stable
@@ -486,11 +509,11 @@ skills:
       - ui-system-design
       - frontend-development
   - name: qk-validation-gate
-    version: 8.0.0
+    version: 8.2.0
     status: stable
     description: >-
-      Cổng kiểm tra chất lượng bắt buộc với ngưỡng pass/fail cụ thể — chặn đứng
-      mọi mã nguồn lỗi.
+      Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests,
+      và đánh giá scorecard.yaml định lượng cho AI Agent.
     complexity: low
     workflow: code-review
     triggers:

package/.agents/rules/anti-patterns.md

@@ -0,0 +1,45 @@
+---
+name: anti-patterns
+description: "Quy tắc cốt lõi (R-C-09) về các Anti-patterns và AI Slop cần tuyệt đối tránh trong quá trình Code và Design."
+severity: critical
+enforcement: strict
+---
+
+# R-C-09: Khung kiểm soát Anti-patterns và AI Slop
+
+Tài liệu này định nghĩa các mẫu code tồi (Anti-patterns) và thiết kế lười biếng của AI (AI Slop). Mọi skills trong hệ thống (đặc biệt là `qk-code-review`, `qk-project-health`, và `qk-ui-audit`) ĐỀU PHẢI dùng bộ quy tắc này làm thước đo. Vi phạm bất kỳ điều nào dưới đây sẽ dẫn đến FAILED ngay lập tức.
+
+## 1. UI & Design Slop (Tuyệt đối cấm)
+
+AI thường có xu hướng sinh ra giao diện "chung chung", "xám xịt". Đây gọi là AI Slop.
+
+- **Vô hình hóa viền & đổ bóng (Washed-out depth):** Thiết kế thẻ Card mà không có box-shadow rõ ràng hoặc border quá nhạt (`opacity < 0.2`) hòa lẫn vào background.
+- **Trạng thái tĩnh chết (Dead interaction):** Các element tương tác (Button, Link, Card) KHÔNG CÓ `:hover`, `:focus`, `:active` states.
+- **Văn bản mù (Micro-typography):** Font size cho body text nhỏ hơn `14px` hoặc chữ xám nhạt trên nền trắng (Contrast ratio < 4.5:1).
+- **Hardcode Pixel & Màu (Hallucinated Tokens):** Sử dụng các mã hex cứng (vd: `#1a1a1a`) hoặc px cứng thay vì dùng biến CSS từ `DESIGN.md` (vd: `var(--color-primary)`).
+- **Khoảng trắng hỗn loạn:** Margin/Padding không tuân theo spacing scale (4px/8px base).
+
+## 2. Code Architecture Anti-patterns
+
+- **God Files / God Objects:** Một file đảm nhiệm quá nhiều vai trò (vd: Component UI chứa cả lời gọi API, quản lý State phức tạp và tính toán Logic).
+  - *Fix:* Phải tuân thủ kiến trúc phân tầng (UI -> Custom Hooks -> Services/API).
+- **Circular Dependencies (Phụ thuộc chéo):** File A import File B, và File B lại import ngược lại File A. 
+  - *Dấu hiệu:* Lỗi "Cannot read property of undefined" lúc runtime do module resolution thất bại.
+- **Spaghetti State:** Truyền props (Prop-drilling) qua quá 3 tầng component thay vì dùng Context, Zustand, hoặc Composition pattern.
+
+## 3. Code Quality & Type Safety
+
+- **Lạm dụng "Any" (Any-Script):** Sử dụng `any` trong TypeScript. Nếu không biết type rõ ràng, phải dùng `unknown` và tiến hành Type Guard (kiểm tra type) trước khi dùng.
+- **Magic Numbers & Strings:** Hardcode các con số hoặc chuỗi ký tự rải rác trong code thay vì đặt thành hằng số (Constants/Enums) ở đầu file hoặc file riêng.
+- **Bắt lỗi im lặng (Silent Catch):** Block `catch (error) {}` trống trơn hoặc chỉ `console.log(error)` mà không throw tiếp, không hiển thị UI Toast báo lỗi cho user, hoặc không gửi log lên server.
+- **Kế thừa lạm dụng (Deep Inheritance):** Viết Class kế thừa qua hơn 2 cấp độ. *Fix:* Ưu tiên Composition over Inheritance.
+
+## 4. Quản lý Tài nguyên & Performance
+
+- **Memory Leaks trong UI:** Đăng ký sự kiện (addEventListener, setInterval, WebSocket) trong vòng đời khởi tạo (e.g., `useEffect`) nhưng QUÊN dọn dẹp (cleanup function) khi component unmount.
+- **N+1 Query Pattern:** Gọi API hoặc chọc DB trong 1 vòng lặp for/map thay vì dùng batch request hoặc SQL JOIN.
+- **Quá tải Bundle:** Import toàn bộ một thư viện khổng lồ (vd: `import _ from 'lodash'`) thay vì import đích danh hàm cần dùng (`import { debounce } from 'lodash'`).
+
+---
+
+**Nguyên tắc thực thi:** Bất cứ khi nào Agent tự viết code hoặc review code, nếu phát hiện các dấu hiệu trên, phải đánh dấu là lỗi **HIGH/CRITICAL** và yêu cầu refactor ngay lập tức trước khi cho phép merge hoặc pass validation gate.

package/.agents/skills/_template/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-[skill-name]
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "[Một câu — skill này làm gì và dành cho ai]"
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/_template/capability.yaml

@@ -1,20 +1,34 @@
-# capability.yaml — Machine-readable Capability Manifest
-# Schema Version 1 — EDAOS v8.2 Governed Capability Platform
-schema_version: 1
-
-id: qk-template-capability
-version: "8.2.0"
-description: "Brief 1-line objective description of this capability for sub-second registry indexing."
-
-dependencies:
-  - qk-validation-gate
-
-tools:
-  - view_file
-  - replace_file_content
-
-knowledge:
-  - engineering-standard
-
-eval:
-  scorecard: evals/scorecard.yaml
+# capability.yaml — Machine-readable Capability Manifest
+# Schema Version 1 — EDAOS v8.2 Governed Capability Platform
+#
+# This template defines the canonical structure for all skill capability manifests.
+# Every skill MUST have a capability.yaml matching this schema.
+# Auto-generated by tooling/build-registry.js — do not edit manually.
+
+schema_version: 1
+
+id: qk-template-capability
+version: "8.3.1"
+description: "Brief 1-line objective description of this capability for sub-second registry indexing."
+
+dependencies: []
+tools:
+  - filesystem
+  - terminal
+
+knowledge:
+  owns:
+    - "domain-name"
+  references:
+    - "architecture"
+    - "coding-standards"
+
+eval:
+  scorecard: "evals/scorecard.yaml"
+
+decision_boundary:
+  owns:
+    - "domain-name"
+  does_not_own: []
+  conflicts_with: []
+  delegates_to: []

package/.agents/skills/qk-access-policy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-access-policy
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Quản lý RBAC, ABAC — định nghĩa role matrix trước, implement middleware sau."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]