ai-developer-skill-os 7.5.0 → 8.1.4

package/CLAUDE.md

@@ -1,110 +0,0 @@
-[Role]
-You are an elite AI Software Engineer. You must strictly follow the rules in this project.
-Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
-
-[Trigger Mechanism]
-Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng `./qk-[tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/...` (hoặc dùng tool view_file để đọc file đó) trước khi làm bất cứ việc gì. Đừng bao giờ đoán mò.
-
-[Autonomous Execution & Transparency]
-Khi nhận được lệnh kỹ năng, bạn BẮT BUỘC phải:
-1. Thông báo rõ ràng: "[🚀 AI Developer Skin: Đã kích hoạt kỹ năng <tên-skill>]" ngay dòng đầu tiên.
-2. TỰ ĐỘNG THỰC THI (End-to-End): Dùng các tools của bạn (đọc file, sửa code, chạy lệnh) để tự động hoàn thành 100% mục tiêu được giao. KHÔNG ĐƯỢC dừng lại để hỏi ý kiến trừ khi gặp lỗi chí mạng hoặc requirement quá mập mờ.
-3. BÁO CÁO KẾT QUẢ: Sau khi hoàn tất sửa code, LUÔN trả về báo cáo theo đúng format markdown dưới đây:
-
-```markdown
-🔧 <Tên Kỹ Năng> Summary
-─────────────────────────────────────────────────
-Scope:        [Tóm tắt ngắn gọn phạm vi công việc]
-Changes:      [N file modified, N extracted, N removed]
-
-Changes applied:
-  ✅ [Loại hành động 1]: [Chi tiết những gì đã làm, ví dụ: Ngăn chặn lỗi lặp vô hạn...]
-  ✅ [Loại hành động 2]: [Chi tiết những gì đã làm]
-
-📊 Quality improvement:
-  Before: [Mô tả ngắn tình trạng trước khi sửa/làm]
-  After:  [Mô tả sự cải thiện đạt được]
-
-✅ Verification:
-  Tests:     [Trạng thái test (vd: N/A, Pass)]
-  Lint/Types:[Trạng thái kiểm tra lỗi (vd: Clean)]
-  Behavior:  [Kết quả hoạt động (vd: Unchanged, Improved)]
-
-⚠️ Notes:
-  [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
-```
-
-[Command Arguments]
-Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: `./qk-ui-builder --fw=react --css=tailwind`).
-Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.
-]
-Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng `./qk-[tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/...` (hoặc dùng tool view_file để đọc file đó) trước khi làm bất cứ việc gì. Đừng bao giờ đoán mò.
-
-[Autonomous Execution & Transparency]
-Khi nhận được lệnh kỹ năng, bạn BẮT BUỘC phải:
-1. Thông báo rõ ràng: "[🚀 AI Developer Skin: Đã kích hoạt kỹ năng <tên-skill>]" ngay dòng đầu tiên.
-2. TỰ ĐỘNG THỰC THI (End-to-End): Dùng các tools của bạn (đọc file, sửa code, chạy lệnh) để tự động hoàn thành 100% mục tiêu được giao. KHÔNG ĐƯỢC dừng lại để hỏi ý kiến trừ khi gặp lỗi chí mạng hoặc requirement quá mập mờ.
-3. BÁO CÁO KẾT QUẢ: Sau khi hoàn tất sửa code, LUÔN trả về báo cáo theo đúng format markdown dưới đây:
-
-```markdown
-🔧 <Tên Kỹ Năng> Summary
-─────────────────────────────────────────────────
-Scope:        [Tóm tắt ngắn gọn phạm vi công việc]
-Changes:      [N file modified, N extracted, N removed]
-
-Changes applied:
-  ✅ [Loại hành động 1]: [Chi tiết những gì đã làm, ví dụ: Ngăn chặn lỗi lặp vô hạn...]
-  ✅ [Loại hành động 2]: [Chi tiết những gì đã làm]
-
-📊 Quality improvement:
-  Before: [Mô tả ngắn tình trạng trước khi sửa/làm]
-  After:  [Mô tả sự cải thiện đạt được]
-
-✅ Verification:
-  Tests:     [Trạng thái test (vd: N/A, Pass)]
-  Lint/Types:[Trạng thái kiểm tra lỗi (vd: Clean)]
-  Behavior:  [Kết quả hoạt động (vd: Unchanged, Improved)]
-
-⚠️ Notes:
-  [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
-```
-
-[Command Arguments]
-Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: `./qk-ui-builder --fw=react --css=tailwind`).
-Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.
-]
-Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng `./qk-[tên-skill]`, bạn BẮT BUỘC phải đọc file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/...` (hoặc dùng tool view_file để đọc file đó) trước khi làm bất cứ việc gì. Đừng bao giờ đoán mò.
-
-[Autonomous Execution & Transparency]
-Khi nhận được lệnh kỹ năng, bạn BẮT BUỘC phải:
-1. Thông báo rõ ràng: "[🚀 AI Developer Skin: Đã kích hoạt kỹ năng <tên-skill>]" ngay dòng đầu tiên.
-2. TỰ ĐỘNG THỰC THI (End-to-End): Dùng các tools của bạn (đọc file, sửa code, chạy lệnh) để tự động hoàn thành 100% mục tiêu được giao. KHÔNG ĐƯỢC dừng lại để hỏi ý kiến trừ khi gặp lỗi chí mạng hoặc requirement quá mập mờ.
-3. BÁO CÁO KẾT QUẢ: Sau khi hoàn tất sửa code, LUÔN trả về báo cáo theo đúng format markdown dưới đây:
-
-```markdown
-🔧 <Tên Kỹ Năng> Summary
-─────────────────────────────────────────────────
-Scope:        [Tóm tắt ngắn gọn phạm vi công việc]
-Changes:      [N file modified, N extracted, N removed]
-
-Changes applied:
-  ✅ [Loại hành động 1]: [Chi tiết những gì đã làm, ví dụ: Ngăn chặn lỗi lặp vô hạn...]
-  ✅ [Loại hành động 2]: [Chi tiết những gì đã làm]
-
-📊 Quality improvement:
-  Before: [Mô tả ngắn tình trạng trước khi sửa/làm]
-  After:  [Mô tả sự cải thiện đạt được]
-
-✅ Verification:
-  Tests:     [Trạng thái test (vd: N/A, Pass)]
-  Lint/Types:[Trạng thái kiểm tra lỗi (vd: Clean)]
-  Behavior:  [Kết quả hoạt động (vd: Unchanged, Improved)]
-
-⚠️ Notes:
-  [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
-```
-
-[Command Arguments]
-Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: `./qk-ui-builder --fw=react --css=tailwind`).
-Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.
-

package/_template/BEHAVIOR_SPEC.md

@@ -1,96 +0,0 @@
----
-name: qk-[tên-behavior]
-version: 6.0.0
-updated: 2026-07-10
-description: Behavior Specification theo chuẩn BSF v6.0.
----
-
-# 📜 Behavior Specification: [Tên Behavior]
-
-## 1. Behavior (Định danh Hành vi)
-```yaml
-Mission: [Mục tiêu tối thượng của hành vi này]
-Authority: [Thẩm quyền tối đa được phép]
-Responsibility: [Trách nhiệm cốt lõi]
-Limitation: [Giới hạn tuyệt đối không được vượt qua]
-```
-
-## 2. Contracts (Hợp đồng)
-
-### 2.1. Capability Contract
-```yaml
-Can:
-  - [Hành động được phép: VD - read_docs, execute_tests]
-Must:
-  - [Hành động bắt buộc: VD - verify assumptions before coding]
-Cannot:
-  - [Hành động cấm: VD - invent API, drop database]
-```
-
-### 2.2. Output Contract
-```yaml
-Artifacts:
-  - [Artifact 1: VD - plan.md]
-  - [Artifact 2: VD - summary_report]
-Completion: "Artifacts generated & Quality Gates passed."
-```
-
-## 3. Policies (Chính sách)
-
-### 3.1. Context Policy
-```yaml
-Scope: [current_repo | whole_workspace | external_docs]
-Priority:
-  1: Project Docs
-  2: Current Conversation
-  3: Source Code
-Trust: "official docs > code > assumptions"
-Fallback: ask_user
-```
-
-### 3.2. Reasoning Boundary
-```yaml
-May infer: [VD: Variable naming, Local scope logic]
-Must verify: [VD: Business logic, Auth rules]
-Must ask: [VD: Missing edge cases, Vague requirements]
-Must refuse: [VD: Unsafe assumptions, Security risks]
-```
-
-### 3.3. Decision Policy
-```yaml
-Priority:
-  1: correctness
-  2: safety
-  3: maintainability
-  4: performance
-```
-
-### 3.4. Evidence Policy
-```yaml
-Accept: [logs, unit tests, profiling data]
-Prefer: [official vendor docs, architecture repo docs]
-Reject: [guess, outdated internet search, agent memory]
-```
-
-### 3.5. Escalation Policy
-```yaml
-Warning: [Cảnh báo rủi ro (VD: Rename file)]
-Confirmation: [Cần user cho phép (VD: Override config)]
-Stop: [Dừng ngay lập tức (VD: Đụng vào Auth, Permission Denied)]
-```
-
-## 4. Protocol (Tùy chọn)
-*(Chỉ sử dụng nếu behavior này yêu cầu quy trình nhiều bước (State Machine). Xóa phần này nếu không cần thiết).*
-
-```yaml
-States:
-  - collect_context
-  - clarify
-  - execute
-
-Transitions:
-  collect_context:
-    if context_missing: -> clarify
-    else: -> execute
-  # ... (Các rule chuyển trạng thái khác) ...
-```

package/_template/examples/example-en.md

@@ -1,49 +0,0 @@
----
-# AI Developer Skill OS
-# Example usage file (English)
-# Copy this as a starting point for your skill examples
----
-
-# Example: [Skill Name]
-
-## Input
-
-**User request:**
-```
-[Describe what the user said or asked]
-```
-
-**Project context:**
-- Framework: [React 18 / Next.js 14 / Vue 3 / etc.]
-- Relevant files: `[path/to/file.ts]`
-- Current state: [Brief description]
-
----
-
-## Execution
-
-**Skill activated:** `[skill-name]`
-
-**Phase 1 — Analysis:**
-> [What the AI analyzed]
-
-**Phase 2 — Plan:**
-> [What the AI decided to do]
-
-**Phase 3 — Output:**
-
-```typescript
-// [filename.ts]
-// [Generated or modified code]
-```
-
----
-
-## Result
-
-```
-✅ Summary:    [What was done]
-📁 Files:      [List of files]
-⚠️  Warnings:  [Any notes]
-🔗 Next steps: [Follow-up suggestion]
-```

package/_template/examples/example-vi.md

@@ -1,49 +0,0 @@
----
-# AI Developer Skill OS
-# File ví dụ sử dụng (Tiếng Việt)
-# Sao chép file này làm điểm khởi đầu cho ví dụ của bạn
----
-
-# Ví dụ: [Tên Skill]
-
-## Input (Đầu vào)
-
-**Yêu cầu của người dùng:**
-```
-[Mô tả người dùng đã nói hoặc yêu cầu gì]
-```
-
-**Bối cảnh dự án:**
-- Framework: [React 18 / Next.js 14 / Vue 3 / v.v.]
-- File liên quan: `[path/to/file.ts]`
-- Trạng thái hiện tại: [Mô tả ngắn]
-
----
-
-## Thực thi
-
-**Skill được kích hoạt:** `[skill-name]`
-
-**Phase 1 — Phân tích:**
-> [AI đã phân tích gì]
-
-**Phase 2 — Kế hoạch:**
-> [AI quyết định làm gì]
-
-**Phase 3 — Kết quả:**
-
-```typescript
-// [filename.ts]
-// [Code được tạo hoặc chỉnh sửa]
-```
-
----
-
-## Kết quả
-
-```
-✅ Tóm tắt:       [Đã làm gì]
-📁 Files:         [Danh sách file]
-⚠️  Lưu ý:        [Ghi chú quan trọng]
-🔗 Bước tiếp theo: [Gợi ý skill hoặc hành động tiếp theo]
-```

package/add_lang.js

@@ -1,21 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const skillsDir = path.join(__dirname, 'skills');
-const items = fs.readdirSync(skillsDir);
-
-for (const item of items) {
-  if (item === '_template' || item === 'qk-policy-engine') continue;
-  
-  const skillDir = path.join(skillsDir, item);
-  if (fs.statSync(skillDir).isDirectory() && item.startsWith('qk-')) {
-    const skillMdPath = path.join(skillDir, 'SKILL.md');
-    if (fs.existsSync(skillMdPath)) {
-      let content = fs.readFileSync(skillMdPath, 'utf8');
-      if (!content.includes('> **Language rule:**')) {
-        content = content.replace(/^# (.*)/m, '# \n\n> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.');
-        fs.writeFileSync(skillMdPath, content);
-      }
-    }
-  }
-}

package/add_lang.py

@@ -1,25 +0,0 @@
-import os
-
-skills_dir = 'skills'
-
-for item in os.listdir(skills_dir):
-    if item == '_template' or item == 'qk-policy-engine':
-        continue
-    
-    skill_path = os.path.join(skills_dir, item, 'SKILL.md')
-    if os.path.isfile(skill_path):
-        with open(skill_path, 'r', encoding='utf-8') as f:
-            content = f.read()
-            
-        if "> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese." not in content:
-            # Look for "> **Language rule:**"
-            if "> **Language rule:**" in content:
-                import re
-                content = re.sub(r'> \*\*Language rule:\*\*.*', '> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.', content)
-            else:
-                # Add it after the first # header
-                import re
-                content = re.sub(r'(# .*?\n)', r'\1\n> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.\n', content, count=1)
-                
-            with open(skill_path, 'w', encoding='utf-8') as f:
-                f.write(content)

package/add_sections.py

@@ -1,53 +0,0 @@
-import os
-
-skills_dir = 'skills'
-required_sections = [
-  'Goal',
-  'Context',
-  'Inputs',
-  'Chain of Thought',
-  'Constraints',
-  'Policies',
-  'Exit Codes',
-  'Confidence Model',
-  'Severity',
-  'Retry Policy',
-  'Escalation Rules'
-]
-
-for item in os.listdir(skills_dir):
-    if item == '_template' or item == 'qk-policy-engine':
-        continue
-    
-    skill_path = os.path.join(skills_dir, item, 'SKILL.md')
-    if os.path.isfile(skill_path):
-        with open(skill_path, 'r', encoding='utf-8') as f:
-            content = f.read()
-            
-        missing_sections = []
-        for section in required_sections:
-            if f"## {section}" not in content:
-                missing_sections.append(section)
-                
-        if missing_sections:
-            appends = "\n\n" + "\n\n".join([f"## {section}\n[Placeholder for {section}]" for section in missing_sections])
-            
-            # Insert before ## Compliance if it exists
-            if "## Compliance" in content:
-                content = content.replace("## Compliance", appends.lstrip() + "\n\n## Compliance")
-            else:
-                content += appends
-                
-            with open(skill_path, 'w', encoding='utf-8') as f:
-                f.write(content)
-        
-        # Add ## Scope for the vitest if missing
-        if "## Scope" not in content:
-            with open(skill_path, 'r', encoding='utf-8') as f:
-                content = f.read()
-            if "## Compliance" in content:
-                content = content.replace("## Compliance", "## Scope\nAll.\n\n## Compliance")
-            else:
-                content += "\n\n## Scope\nAll."
-            with open(skill_path, 'w', encoding='utf-8') as f:
-                f.write(content)

package/bin/lint.js

@@ -1,122 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import matter from 'gray-matter';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const skillsDir = path.join(__dirname, '..', 'skills');
-
-const REQUIRED_FOR_ALL = [
-  'Preconditions',
-  'Scope',
-  'Non-Goals',
-  'Exit Codes',
-  'Handoff Contract'
-];
-
-const REQUIRED_FOR_ACTION = [
-  'Workflow',
-  'Confidence Model',
-  'Evidence Format',
-  'Escalation Rules'
-];
-
-const REQUIRED_FOR_EXECUTION = [
-  'Priority Order',
-  'Severity',
-  'Retry Policy'
-];
-
-const ACTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-design-to-code', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap'];
-const EXECUTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-design-to-code', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap', 'qk-engineering-standard', 'qk-validation-gate', 'qk-ui-audit', 'qk-project-health'];
-
-const SKIP_LINT = ['qk-help'];
-
-let hasErrors = false;
-
-function lintSkill(skillPath, skillName) {
-  if (SKIP_LINT.includes(skillName)) {
-    console.log(`⏭️  [${skillName}] Skipped (reference skill)`);
-    return;
-  }
-
-  const content = fs.readFileSync(skillPath, 'utf8');
-
-  let parsed;
-  try {
-    parsed = matter(content);
-  } catch (e) {
-    console.error(`❌ [${skillName}] Frontmatter parsing failed: ${e.message}`);
-    hasErrors = true;
-    return;
-  }
-
-  const frontmatter = parsed.data;
-
-  const requiredFrontmatter = ['name', 'category', 'version', 'description', 'platforms', 'execution_mode', 'cost', 'latency', 'risk', 'side_effects', 'produces', 'consumes', 'token_budget', 'exit_codes', 'schema_version', 'runtime_version', 'skill_version'];
-
-  for (const field of requiredFrontmatter) {
-    if (frontmatter[field] === undefined) {
-      console.error(`❌ [${skillName}] Missing frontmatter field: ${field}`);
-      hasErrors = true;
-    }
-  }
-
-  const validPlatforms = ['antigravity', 'claude-code', 'cursor', 'windsurf', 'kilo-code'];
-  if (Array.isArray(frontmatter.platforms)) {
-    for (const p of frontmatter.platforms) {
-      if (!validPlatforms.includes(p)) {
-        console.error(`❌ [${skillName}] Invalid platform: ${p}`);
-        hasErrors = true;
-      }
-    }
-  }
-
-  if (!content.includes('> **Language rule:**')) {
-    console.error(`❌ [${skillName}] Missing Language Rule declaration.`);
-    hasErrors = true;
-  }
-
-  const body = parsed.content;
-  const required = [...REQUIRED_FOR_ALL];
-  if (ACTION_SKILLS.includes(skillName)) {
-    required.push(...REQUIRED_FOR_ACTION);
-  }
-  if (EXECUTION_SKILLS.includes(skillName)) {
-    required.push(...REQUIRED_FOR_EXECUTION);
-  }
-
-  for (const section of required) {
-    const headingRegex = new RegExp(`^##\\s+${section}\\b`, 'm');
-    if (!headingRegex.test(body)) {
-      console.error(`❌ [${skillName}] Missing section: ## ${section}`);
-      hasErrors = true;
-    }
-  }
-}
-
-console.log('🔍 Running V7.5 Skill Schema Linting...');
-
-const items = fs.readdirSync(skillsDir);
-for (const item of items) {
-  if (item === '_template' || item === 'qk-policy-engine') continue;
-
-  const skillDir = path.join(skillsDir, item);
-  if (fs.statSync(skillDir).isDirectory() && item.startsWith('qk-')) {
-    const skillMdPath = path.join(skillDir, 'SKILL.md');
-    if (fs.existsSync(skillMdPath)) {
-      lintSkill(skillMdPath, item);
-    }
-  }
-}
-
-if (hasErrors) {
-  console.error('\n💥 Linting failed. One or more skills do not comply with the V7.5 Runtime Standard.');
-  process.exit(1);
-} else {
-  console.log('\n✅ All skills comply with V7.5 Runtime Standard!');
-  process.exit(0);
-}

package/docs/CHI_TIET_SKILLS.md

@@ -1,125 +0,0 @@
-# Từ Điển Chi Tiết 22 Siêu Kỹ Năng (Master Skills)
-
-Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn bộ 22 Kỹ năng thuộc Kiến trúc AI Developer Skill OS. Các kỹ năng được phân chia khép kín theo 7 lớp kiến trúc tiêu chuẩn cấp doanh nghiệp (Enterprise Architecture).
-
----
-
-## 🏗️ Lớp 0: Foundation Layer (Nền Tảng Cốt Lõi)
-*Lớp này đóng vai trò như "Não bộ trung tâm", chuyên nhận lệnh, cấp quyền, cung cấp luật lệ và chuẩn bị môi trường trước khi bất kỳ dòng code nào được viết ra.*
-
-### 1. `qk-orchestrator` (Trợ Lý Điều Phối)
-- **Mô tả:** Nhận lệnh chung chung từ người dùng, tự động phân tích ý đồ và định hướng luồng công việc (chọn gọi các kỹ năng nào tiếp theo).
-- **Khi nào dùng:** Khi bạn có một yêu cầu lớn và không biết bắt đầu từ đâu.
-
-### 2. `qk-context-loader` (Nạp Ngữ Cảnh)
-- **Mô tả:** Có khả năng đọc lướt dự án để gom chính xác các file liên quan đến task hiện tại (chống tràn bộ nhớ token của AI).
-- **Khi nào dùng:** Khi code dự án quá lớn, cần khoanh vùng các file cần sửa.
-
-### 3. `qk-access-policy` (Kiểm Soát Phân Quyền)
-- **Mô tả:** Xử lý và cung cấp các quy tắc về bảo mật (Security), phân quyền (RBAC), Authentication (JWT/OAuth).
-- **Khi nào dùng:** Khi tính năng liên quan đến việc bảo mật, ai được quyền truy cập vào đâu.
-
-### 4. `qk-project-memory` (Trí Nhớ Dự Án)
-- **Mô tả:** Lưu trữ DNA của dự án, các quyết định kiến trúc, UI pattern và các convention đã được thống nhất từ trước.
-- **Khi nào dùng:** Khi muốn AI làm theo đúng style đã có sẵn trong dự án.
-
-### 5. `qk-engineering-standard` (Bộ Luật Thiết Kế)
-- **Mô tả:** Bơm các "luật thép" (về Frontend, Backend, Database) vào ngữ cảnh để bắt AI tuân thủ cấu trúc thư mục và naming.
-- **Khi nào dùng:** Tự động gọi để ép AI viết code không bị rác.
-
-### 6. `qk-project-bootstrap` (Khởi Tạo Dự Án)
-- **Mô tả:** Setup toàn bộ khung sườn của một dự án mới tinh từ con số 0 (Cấu hình lint, format, folder structure).
-- **Khi nào dùng:** Lúc bắt đầu dự án mới.
-
----
-
-## 🎨 Lớp 1: UI System Layer (Hệ Thống Giao Diện)
-*Nhóm chuyên biệt về vẽ giao diện và quản lý hệ thống thành phần (Components).*
-
-### 7. `qk-ui-system-builder` (Kỹ Sư Hệ Thống UI)
-- **Mô tả:** Quản lý Design Token, tạo ra các Component có thể tái sử dụng (Button, Table, Form) đảm bảo tính nhất quán toàn dự án.
-- **Khi nào dùng:** Xây dựng thư viện giao diện, tránh viết CSS lộn xộn.
-
-### 8. `qk-design-to-code` (Chuyển Đổi Thiết Kế)
-- **Mô tả:** Đọc hiểu hình ảnh/Figma để tự động chuyển thành mã nguồn giao diện (React, Tailwind, v.v.).
-- **Khi nào dùng:** Bóc tách UI từ bản thiết kế.
-
-### 9. `qk-ui-audit` (Kiểm Toán Giao Diện)
-- **Mô tả:** Kiểm tra độ nhất quán UI/UX, hỗ trợ Responsive trên điện thoại và tối ưu khả năng tiếp cận (Accessibility - a11y).
-- **Khi nào dùng:** Kiểm tra lỗi UI sau khi hoàn thiện giao diện.
-
----
-
-## 💻 Lớp 2: Development Layer (Phát Triển E2E)
-*Khối thực thi mạnh mẽ nhất, đi từ A-Z một tính năng cụ thể.*
-
-### 10. `qk-feature-delivery` (Chuyển Giao Tính Năng)
-- **Mô tả:** Kỹ năng toàn năng, tự động phân tích thiết kế Database -> Viết API -> Xây UI -> Viết Unit Test cho một tính năng trọn vẹn.
-- **Khi nào dùng:** Xây dựng tính năng hoàn chỉnh (Ví dụ: Chức năng Thanh Toán).
-
-### 11. `qk-api-lifecycle` (Vòng Đời API)
-- **Mô tả:** Chuyên biệt cho Backend: Viết spec, tạo Service, định nghĩa Type, viết Test và sinh tài liệu cho API.
-- **Khi nào dùng:** Xây dựng các Endpoint API.
-
-### 12. `qk-data-lifecycle` (Vòng Đời Dữ Liệu)
-- **Mô tả:** Quản lý Schema, tạo file Migration, tối ưu câu lệnh truy vấn (SQL, Prisma, v.v.).
-- **Khi nào dùng:** Thay đổi cấu trúc cơ sở dữ liệu.
-
-### 13. `qk-db-optimizer` (Tối Ưu Database)
-- **Mô tả:** Phân tích EXPLAIN plan, tìm N+1 queries, đề xuất index và tối ưu query performance.
-- **Khi nào dùng:** Truy vấn chậm, performance DB issue.
-
-### 14. `qk-fe-api-integration` (Tích Hợp API Frontend)
-- **Mô tả:** Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base dự án.
-- **Khi nào dùng:** Khi cần gọi API từ frontend, map DTO, xử lý Loading/Error states.
-
----
-
-## 🛡️ Lớp 3: Quality Assurance Layer (Đảm Bảo Chất Lượng)
-*Kiểm tra độ sạch của code và diệt bug.*
-
-### 15. `qk-project-health` (Kiểm Toán Dự Án)
-- **Mô tả:** Quét toàn bộ dự án để tìm Code Smell, Nợ kỹ thuật (Tech Debt), và các vi phạm kiến trúc.
-- **Khi nào dùng:** Định kỳ kiểm tra chất lượng mã nguồn hoặc tối ưu hiệu năng.
-
-### 16. `qk-bug-resolution` (Giải Quyết Bug Triệt Để)
-- **Mô tả:** Tái hiện lỗi, đào sâu tìm Root Cause, cung cấp giải pháp an toàn và viết Regression Test để chống lỗi lặp lại.
-- **Khi nào dùng:** Sửa các lỗi đứt gãy hoặc logic nghiêm trọng.
-
-### 17. `qk-validation-gate` (Cổng Kiểm Định)
-- **Mô tả:** Kỹ năng chặn cửa. Bắt buộc chạy Test, Linting và Scan Security. Chỉ khi "PASS" mới cho phép kết thúc task.
-- **Khi nào dùng:** Nằm cuối quy trình code của bất kỳ tính năng nào.
-
----
-
-## 🚀 Lớp 4 & 5: Evolution & Operation (Vận Hành & Tiến Hóa)
-*Triển khai dự án lên Production và nâng cấp phiên bản lớn.*
-
-### 18. `qk-system-evolution` (Tiến Hóa Hệ Thống)
-- **Mô tả:** Nâng cấp dependency (VD: Next 14 lên 15), phân tích rủi ro ảnh hưởng và thực thi nâng cấp an toàn không downtime.
-- **Khi nào dùng:** Update version framework/thư viện.
-
-### 19. `qk-production-release` (Triển Khai Môi Trường)
-- **Mô tả:** Viết Dockerfile, cấu hình CI/CD Pipelines (Github Actions), Deploy lên Cloud (AWS, Vercel).
-- **Khi nào dùng:** Release sản phẩm cho người dùng cuối.
-
----
-
-## 🤖 Lớp 6: AI Builder Layer (Tích hợp AI)
-
-### 20. `qk-ai-builder` (Xây Dựng AI App)
-- **Mô tả:** Chuyên thiết kế và code các ứng dụng AI như RAG (Retrieval-Augmented Generation), Agent logic và Prompt Engineering.
-- **Khi nào dùng:** Tích hợp LLM vào trong phần mềm của bạn.
-
----
-
-## 📚 Lớp 7: Knowledge Layer (Tri Thức & Tài Liệu)
-*Hệ thống tự học và viết tài liệu vĩ đại của OS.*
-
-### 21. `qk-docs` (Kỹ Sư Tài Liệu)
-- **Mô tả:** Tự động sinh hoặc cập nhật tài liệu cho con người đọc: `README.md`, `CHANGELOG.md`, `API Docs`.
-- **Khi nào dùng:** Nằm ở cuối quy trình sau khi hoàn thành tính năng.
-
-### 22. `qk-help` (Tra Cứu Nhanh)
-- **Mô tả:** Cuốn từ điển sống. Cung cấp thông tin và hướng dẫn chi tiết (Pro-tips) về cách sử dụng toàn bộ hệ thống.
-- **Khi nào dùng:** Bất kỳ khi nào người dùng cần hỗ trợ sử dụng hệ điều hành.