ai-developer-skill-os 1.7.1 → 1.9.1

package/README.md

@@ -1,161 +1,130 @@
-# 🚀 AI Developer Skill OS
+# 🚀 AI Developer Skill OS (rules-skill-ai)
 
-[![npm version](https://badge.fury.io/js/ai-developer-skill-os.svg)](https://badge.fury.io/js/ai-developer-skill-os)
-[![Author](https://img.shields.io/badge/Author-Quang%20Kh%C3%A1nh-blue.svg)](https://github.com/phamquangkhanh2999)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+> Một hệ điều hành (AI-OS) và Nền tảng Kiến trúc Kỹ thuật (Engineering Platform) tối thượng dành cho AI Coding Agents (Cursor, Windsurf, Cline, v.v.).
 
-> **"Biến mọi AI Code Editor (Cursor, Windsurf, Cline) thành một Senior Engineer thực thụ với 23 kỹ năng được lập trình sẵn."**
+Thay vì cung cấp các "công cụ rời rạc" (Toolbox), dự án này xây dựng một hệ thống **22 Siêu Kỹ Năng (Master Skills)**, biến Agent của bạn thành một **Senior Engineer / Chief Architect** thực thụ với khả năng tự học, tự kiểm toán và tự viết tài liệu.
 
 ---
 
-## 🌟 Tại sao bạn cần Skill OS?
+## 🏗️ Kiến Trúc Khối (The 7-Layer Architecture)
 
-Các AI Editor hiện tại rất thông minh, nhưng nếu không có quy trình rõ ràng, chúng thường **lan man, tự ý sửa code lung tung, hoặc viết code không theo chuẩn kiến trúc**. 
+Hệ thống được thiết kế hoàn hảo với 7 phân lớp, hoạt động khép kín theo chuỗi End-to-End:
 
-**AI Developer Skill OS (by Quang Khánh)** giải quyết triệt để vấn đề này bằng cách:
-- 🧠 **Ép AI tư duy theo Workflow (Chain-of-Thought):** Phân tích trước, code sau.
-- 🛡️ **Scope & Non-goals rõ ràng:** Khoá chặt giới hạn, tuyệt đối không cho AI sửa hỏng các file không liên quan.
-- 🎨 **Output chuyên nghiệp:** Mọi câu trả lời của AI đều được định dạng thành bảng biểu, báo cáo y hệt một hệ thống thật.
+### 0. Foundation Layer (Nền Tảng Cốt Lõi)
+- `qk-orchestrator`: Bộ điều hướng yêu cầu người dùng, chọn Workflow.
+- `qk-context-loader`: Bộ nạp ngữ cảnh, tìm file liên quan, chống tràn token.
+- `qk-policy-engine`: Động cơ kiểm tra tính hợp lệ của Request trước khi chạy.
+- `qk-access-policy`: Ranh giới bảo mật, phân quyền và RBAC.
+- `qk-project-memory`: Bộ nhớ cấu trúc dự án (Architecture, UI Patterns, Conventions).
+- `qk-engineering-standard`: Bộ luật thiết kế (Frontend, Backend, Security, Testing rules).
+- `qk-project-bootstrap`: Trình khởi tạo dự án từ con số 0.
 
-### Hệ thống 23 Kỹ năng (Skillset)
-- 🛠️ **Engineering Core (8 skills):** Agent Orchestrator (Lên kế hoạch), Context Manager, Project Audit, Bug Fix, Refactor, API Integration, Migration, Git Engineer.
-- 🎨 **Frontend (11 skills):** Frontend Architecture, Design System, UI Builder, Component Generator, State Management, Form Builder, Table CRUD, Debug, Testing, Performance, A11Y Audit.
-- ⚙️ **Backend (4 skills):** Backend Architecture, Database Engineer, Auth & Security, Deployment (DevOps).
+### 1. UI System Layer (Hệ Thống Giao Diện)
+- `qk-ui-system-builder`: Quản lý Design System, Component Library.
+- `qk-design-to-code`: Chuyển đổi Figma/Screenshot sang mã nguồn.
+- `qk-ui-audit`: Kiểm toán tính nhất quán, Responsive, Accessibility.
 
-👉 [Xem chi tiết chức năng của toàn bộ 23 Skills tại đây](docs/CHI_TIET_SKILLS.md)
+### 2. Development Layer (Phát Triển E2E)
+- `qk-feature-delivery`: Phân tích, code, test hoàn thiện một tính năng từ A-Z.
+- `qk-api-lifecycle`: Vòng đời API (Spec, Service, Type, Test, Docs).
+- `qk-data-lifecycle`: Vòng đời dữ liệu (Schema, Migration, Query Tuning).
 
----
-
-## 📦 Cài đặt (Installation)
+### 3. Quality Assurance Layer (Đảm Bảo Chất Lượng)
+- `qk-project-health`: Audit tình trạng dự án, Tech Debt, Code Smell.
+- `qk-bug-resolution`: Tái hiện lỗi, tìm Root Cause, Fix và chống Regression.
+- `qk-validation-gate`: Cổng chặn an toàn (Lint, Test, Security) trước khi hoàn tất.
 
-Bạn có thể cài đặt bộ Skill này vào bất kỳ dự án nào cực kỳ nhanh chóng qua NPM hoặc Git.
+### 4. Evolution Layer (Tiến Hóa Hệ Thống)
+- `qk-system-evolution`: Nâng cấp phiên bản, Impact Analysis, Dry-run.
 
-### Cách 1: Sử dụng NPM (Khuyên dùng)
-Mở terminal tại thư mục gốc dự án của bạn và chạy:
-```bash
-npx ai-developer-skill-os init
-```
-Hệ thống sẽ cung cấp cho bạn 2 tuỳ chọn cực kỳ linh hoạt:
-- **(1) Local:** Cài vào thư mục ẩn `.qk-ai-skill-os/` ngay trong dự án. (Phù hợp khi làm việc nhóm, commit lên Git để ai cũng xài được).
-- **(2) Global:** Cài thẳng vào ổ đĩa máy tính (Home Directory). Từ đó trở đi, bạn mở **BẤT KỲ DỰ ÁN NÀO** cũng sẽ tự động gọi được 23 kỹ năng mà không cần tải lại file! (Rất tuyệt vời cho cá nhân sử dụng).
+### 5. Operation Layer (Vận Hành)
+- `qk-production-release`: CI/CD, Build, Deploy, Observability.
 
-> 💡 **Tính năng Tự động Dọn dẹp (Auto-Cleanup):** Mỗi khi cài đặt lại, hệ thống sẽ tự động quét và xóa sạch các kỹ năng phiên bản cũ để tối ưu dung lượng và tránh xung đột cho máy tính của bạn. Mọi thứ hoàn toàn tự động!
+### 6. AI Builder Layer
+- `qk-ai-builder`: Thiết kế các hệ thống AI App, Agent, RAG.
 
-### Cách 2: Sử dụng Git Submodule
-Nếu bạn không dùng Node.js, bạn có thể nhúng trực tiếp qua Git (Chỉ hỗ trợ dạng Local):
-```bash
-git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git .qk-ai-skill-os
-```
+### 7. Knowledge Layer (Tri Thức & Tài Liệu)
+- `qk-docs`: Viết tài liệu cho con người (README, Changelog, Developer Guide).
+- `qk-documentation-system`: Máy học nội bộ (Chuyển đổi Pattern thành luật nạp vào Memory).
+- `qk-help`: Trợ lý tra cứu hướng dẫn kỹ năng.
 
 ---
 
-## 🛠️ Cấu hình cho IDE / AI Agent
-
-Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hãy cấu hình để AI biết cách sử dụng nó.
-
-### Cho Antigravity / Gemini IDE
-**Không cần cấu hình gì thêm!** Nếu bạn đã cài đặt bằng cờ `--gemini` (thư mục `.agents/skills/`), hệ thống sẽ tự động quét và load toàn bộ 23 kỹ năng này. Bạn có thể sử dụng ngay lập tức!
-
-### Cho Claude Code / Kilo Code (CLI Agents)
-Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
-```md
-# System Instructions
-Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
-
-Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
-ĐẶC BIỆT LƯU Ý: 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 gọi và đọc nội dung file `SKILL.md` tương ứng trong thư mục `./.qk-ai-skill-os/skills/` trước khi phân tích hoặc viết code.
-Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
-```
-
-### Cho Cline / Roo Code (VS Code Extensions)
-Tạo file `.clinerules` hoặc `.roorules` ở gốc dự án và dán nội dung:
-```md
-Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
-Vui lòng tìm đọc danh sách kỹ năng tại file `./.qk-ai-skill-os/skills.json`.
-Bất cứ khi nào người dùng gõ lệnh `./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/skills/`.
-Luôn giao tiếp bằng tiếng Việt nhưng viết code bằng tiếng Anh.
+## 🔄 Luồng Vận Hành Khép Kín (Workflow)
+
+Khi bạn ra lệnh: `"Thêm tính năng đăng nhập"`:
+```text
+User Request 
+   ↓
+qk-orchestrator (Phân tích, chọn qk-feature-delivery)
+   ↓
+qk-context-loader (Load code liên quan Auth)
+   ↓
+qk-policy-engine & qk-access-policy (Check quyền)
+   ↓
+qk-engineering-standard (Rút luật Backend/Security)
+   ↓
+[THỰC THI BỞI qk-feature-delivery]
+   ↓
+qk-validation-gate (Test, Lint)
+   ↓
+qk-docs (Cập nhật API doc, Changelog)
+   ↓
+qk-documentation-system (Lưu các Pattern mới vào Memory)
 ```
 
-### Cho GitHub Copilot
-Tạo file `.github/copilot-instructions.md` và dán đoạn prompt tương tự như trên vào file này để Copilot học được các kỹ năng.
-
----
-
-## 🎯 Cách kiểm tra cài đặt thành công
-
-Để biết AI của bạn đã thực sự "nhập môn" bộ Skill OS này chưa, hãy mở khung chat AI trong dự án và gõ cú pháp lệnh chuyên nghiệp sau:
-> **`./qk project-audit`** Hãy cho tôi biết bạn sẽ làm những gì.
-
-✅ **Thành công:** Nếu AI trả lời bằng tiếng Việt, liệt kê đúng các bước khám bệnh (Phase 1, Phase 2, Phase 3...) theo đúng như trong file `SKILL.md` của `project-audit`.
-❌ **Thất bại:** Nếu AI trả lời chung chung hoặc bảo không biết skill này là gì, bạn cần kiểm tra lại đường dẫn file cấu hình ở bước trên.
-
 ---
 
-## 🚀 Cách gọi lệnh Skill chuyên nghiệp (Usage)
+## 💡 Ví Dụ Thực Tế (Common Examples)
 
-AI sẽ tự động nhận diện skill qua ngữ cảnh, nhưng để chắc chắn 100% và tiết kiệm thời gian gõ prompt, bạn hãy dùng cú pháp lệnh độc quyền: **`./qk-[tên-skill]`**
+Dưới đây là một số ví dụ sử dụng các kỹ năng phổ biến và mạnh mẽ nhất trong quá trình code hàng ngày của bạn:
 
-Dưới đây là các ví dụ cụ thể để bạn copy - paste và trải nghiệm ngay:
-
-### 1. Nhờ AI lên kế hoạch (Planning) & Kiến trúc
-> **`./qk-agent-orchestrator`** Hãy lên kế hoạch làm tính năng Giỏ Hàng cho tôi. Nhớ gọi thêm **`./qk-context-manager`** để đọc cấu trúc dự án trước nhé.
-
-### 2. Xây dựng Giao diện (Frontend/UI)
-> **`./qk-ui-builder`** & **`./qk-design-system`** Hãy tạo cho tôi một màn hình Đăng Nhập (Login) xịn xò. Đảm bảo Responsive và dùng đúng chuẩn Component.
-
-### 3. Thiết kế Database (Backend)
-> **`./qk-database-engineer`** Hãy viết cho tôi schema Prisma cho bảng Product và User có quan hệ 1-N. Tối ưu index cho truy vấn nhanh.
-
-### 4. Tìm và Diệt Bug (Debugging)
-> **`./qk-frontend-debug`** & **`./qk-bug-fix`** Code đang bị crash với lỗi `Hydration error`. Hãy tìm nguyên nhân gốc rễ và sửa dứt điểm giúp tôi.
-
----
-
-## 💡 Mẹo & Workflow Thực Chiến (Best Practices)
+### 1. `qk-orchestrator` (Trợ lý điều phối trung tâm)
+Nếu bạn không biết nên dùng skill nào, hãy gọi Orchestrator. Nó sẽ tự động phân tích và kích hoạt đúng các skill bên dưới.
+```bash
+./qk-orchestrator "Tôi muốn tạo một trang Dashboard hiển thị doanh thu bằng React"
+```
 
-Để khai thác tối đa sức mạnh của 23 kỹ năng, bí quyết là **kết hợp (chaining) nhiều skill** lại với nhau trong cùng một luồng công việc. Dưới đây là các Workflow kinh điển:
+### 2. `qk-feature-delivery` (Phát triển tính năng E2E)
+Dùng khi bạn muốn xây dựng trọn vẹn một tính năng từ DB, API đến UI và Test.
+```bash
+./qk-feature-delivery "Tạo luồng thanh toán giỏ hàng (Cart Checkout), lưu vào bảng orders và gọi API thanh toán Stripe"
+```
 
-### 🌟 1. Workflow Bắt đầu một New Chat (Bắt buộc)
-Khi mở một New Chat, AI hoàn toàn chưa biết gì về dự án. Đừng bắt nó code ngay!
-* **Bước 1:** `> Dùng ./qk-context-manager để đọc cấu trúc toàn bộ dự án này.`
-* **Bước 2:** `> Dùng ./qk-agent-orchestrator để phân tích yêu cầu sau đây và lên kế hoạch: [Yêu cầu của bạn]`
+### 3. `qk-bug-resolution` (Chẩn đoán và diệt Bug triệt để)
+Tuyệt đối không dùng prompt thường để sửa lỗi. Dùng kỹ năng này để ép AI tìm Root Cause và viết Regression Test.
+```bash
+./qk-bug-resolution "API /users/profile đang trả về 500 khi user chưa có avatar, stack trace như sau..."
+```
 
-### 🌟 2. Workflow Làm tính năng mới (VD: Tích hợp API)
-Muốn tạo một màn hình hiển thị danh sách từ API trả về? Hãy gõ:
-* `> Hãy dùng ./qk-api-integration để tạo file gọi API fetch danh sách Users.`
-* `> Tiếp theo dùng ./qk-state-management để lưu data này vào Zustand/Redux.`
-* `> Cuối cùng dùng ./qk-ui-builder để vẽ màn hình Table hiển thị data đó.`
+### 4. `qk-ui-system-builder` (Chuẩn hóa giao diện)
+Dùng khi thiết kế các component dùng chung (Button, Card, Form) để đảm bảo không bị rác CSS.
+```bash
+./qk-ui-system-builder "Tạo một Data Table Component có hỗ trợ phân trang và filter, sử dụng Design Token hiện tại"
+```
 
-### 🌟 3. Workflow Chống "Phá Code" (Safe Refactor)
-Trước khi đổi một cấu trúc lớn, hãy bắt AI dò mìn:
-* `> Hãy chạy ./qk-project-audit để dò xem việc đổi tên biến X có ảnh hưởng đến các component khác không.`
-* `> OK, giờ hãy dùng ./qk-refactor để sửa lại một cách an toàn.`
+### 5. `qk-api-lifecycle` (Thiết kế và Code API)
+Dành cho Backend Engineer, đi từ spec đến code, type và test.
+```bash
+./qk-api-lifecycle "Thiết kế API cập nhật mật khẩu, yêu cầu validate JWT token và mã hóa bcrypt"
+```
 
 ---
 
-## 💎 **Danh sách đầy đủ các Kỹ năng đang có trong Skill OS:**
-*(Bạn có thể gọi trực tiếp trên Terminal hoặc Chat)*
-
-> 💡 **Mẹo (Pro-Tip):** Bất cứ khi nào bạn quên mất danh sách kỹ năng hoặc cách dùng, chỉ cần gõ lệnh `./qk-help` (hoặc `@qk-help`), hệ thống sẽ xuất ra toàn bộ cẩm nang sử dụng và bí kíp kết hợp Kỹ năng (Skill Chaining) ngay lập tức!
+## 💻 Cách Cài Đặt (Installation)
 
-| Kỹ năng (Skill) | Nhiệm vụ chuyên môn |
-|-----------------|---------------------|
-| 🧠 **`qk-help`** | **[MỚI] Sách hướng dẫn tra cứu nhanh danh sách Skill và Bí kíp kết hợp** |
-| 🧑‍💻 **`qk-ui-builder`** | Xây dựng UI, vẽ Màn hình, chia Layout, tạo Modal cực đẹp |
-| 🏗️ **Engineering** | `qk-project-audit`, `qk-agent-orchestrator` | Kiểm toán dự án, lập kế hoạch, quản lý Git, Refactor code. |
-| 🎨 **Frontend** | `qk-ui-builder`, `qk-frontend-performance` | Dựng UI, tối ưu tốc độ, test component, quản lý State. |
-| ⚙️ **Backend** | `qk-database-engineer`, `qk-auth-security` | Thiết kế DB Schema, bảo mật JWT/OAuth, cấu hình CI/CD. |
-
-👉 [Xem danh sách toàn bộ Kỹ năng tại đây](docs/CHI_TIET_SKILLS.md)
-
----
-
-<div align="center">
-  <b>Được thiết kế và phát triển bởi Quang Khánh (QK)</b><br>
-  <i>Empowering Vietnamese Developers with World-Class AI Workflows.</i>
-</div>
+Sử dụng npm:
+```bash
+npm i -g rules-skill-ai
+```
+Hoặc sử dụng qua `npx`:
+```bash
+npx rules-skill-ai init
+```
 
----
+## 🚀 Tra Cứu (Help)
 
-## 📄 License
-Được phát hành dưới giấy phép [MIT](LICENSE). Tự do sử dụng, chỉnh sửa và chia sẻ.
+Để tra cứu danh sách toàn bộ 22 Kỹ năng và các mẹo sử dụng, hãy gọi:
+```bash
+./qk-help "Hiển thị tất cả các skill liên quan đến Frontend"
+```

package/bin/install.js

@@ -28,19 +28,56 @@ function cleanOldSkills(targetSkillsDir, isGeminiGlobal) {
   if (fs.existsSync(targetSkillsDir)) {
     console.log('🧹 Đang dọn dẹp phiên bản cũ để tối ưu hệ thống...');
     if (isGeminiGlobal) {
-      // Chỉ xoá các thư mục qk-* để không ảnh hưởng các skill khác của người dùng
       fs.readdirSync(targetSkillsDir).forEach(item => {
         if (item.startsWith('qk-')) {
           fs.rmSync(path.join(targetSkillsDir, item), { recursive: true, force: true });
         }
       });
     } else {
-      // Xoá sạch toàn bộ thư mục kỹ năng của bộ công cụ này
       fs.rmSync(targetSkillsDir, { recursive: true, force: true });
     }
   }
 }
 
+function ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir) {
+  if (!fs.existsSync(kiloSkillsDir)) {
+    fs.mkdirSync(kiloSkillsDir, { recursive: true });
+  }
+  if (!fs.existsSync(kiloThemesDir)) {
+    fs.mkdirSync(kiloThemesDir, { recursive: true });
+  }
+  if (!fs.existsSync(kiloCommandsDir)) {
+    fs.mkdirSync(kiloCommandsDir, { recursive: true });
+  }
+
+  const srcSkills = path.join(sourceDir, 'skills');
+  if (fs.existsSync(srcSkills)) {
+    copyRecursiveSync(srcSkills, kiloSkillsDir);
+  }
+
+  let kiloConfig = {};
+  if (fs.existsSync(kiloJsonPath)) {
+    try {
+      kiloConfig = JSON.parse(fs.readFileSync(kiloJsonPath, 'utf8'));
+    } catch (e) {
+      kiloConfig = {};
+    }
+  }
+
+  const skillPaths = [kiloSkillsDir];
+  if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {
+    kiloConfig.skills = { paths: skillPaths };
+  } else {
+    const exists = kiloConfig.skills.paths.some(p => path.resolve(p) === path.resolve(kiloSkillsDir));
+    if (!exists) {
+      kiloConfig.skills.paths = [...kiloConfig.skills.paths, ...skillPaths];
+    }
+  }
+
+  fs.writeFileSync(kiloJsonPath, JSON.stringify(kiloConfig, null, 2) + '\n');
+  return kiloJsonPath;
+}
+
 const rl = readline.createInterface({
   input: process.stdin,
   output: process.stdout
@@ -55,9 +92,10 @@ const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
 (4) Antigravity / Gemini
 (5) Codex
 (6) Kilo Code
+(7) Tất cả các IDE (Multi-IDE)
 (0) Bỏ qua (Không tạo config tự động)
 
-Nhập số (0-6): `;
+Nhập số (0-7): `;
 
 const questionScope = `
 Bạn muốn cài đặt bộ kỹ năng ở đâu?
@@ -68,6 +106,8 @@ Nhập số (1-2): `;
 
 rl.question(questionIde, (answerIde) => {
   let isGemini = false;
+  let isKilo = false;
+  let isMultiIde = false;
   let ruleFileName = null;
   const ideCode = answerIde.trim();
 
@@ -77,20 +117,35 @@ rl.question(questionIde, (answerIde) => {
     case '3': ruleFileName = '.clinerules'; break;
     case '4': isGemini = true; break;
     case '5': ruleFileName = '.codexrules'; break;
-    case '6': ruleFileName = '.kilorules'; break;
+    case '6': ruleFileName = '.kilorules'; isKilo = true; break;
+    case '7': isMultiIde = true; ruleFileName = null; break;
     case '0': default: break;
   }
 
   rl.question(questionScope, (answerScope) => {
     const isGlobal = answerScope.trim() === '2';
     
+    const homeDir = os.homedir();
+    const cwd = process.cwd();
     let targetDir = '';
     let ruleFilePath = null;
     let baseFolderForPrompt = '';
-    const homeDir = os.homedir();
-    const cwd = process.cwd();
+    let kiloJsonPath = null;
+    let kiloSkillsDir = null;
+    let kiloThemesDir = null;
+    let kiloCommandsDir = null;
 
-    if (isGemini) {
+    if (isMultiIde) {
+      targetDir = path.join(cwd, '.qk-ai-skill-os');
+      baseFolderForPrompt = './.qk-ai-skill-os';
+      ruleFilePath = path.join(cwd, 'CLAUDE.md');
+      if (!isGlobal) {
+        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+        kiloJsonPath = path.join(cwd, 'kilo.json');
+      }
+    } else if (isGemini) {
       if (isGlobal) {
         targetDir = path.join(homeDir, '.gemini', 'config');
         ruleFilePath = path.join(targetDir, 'AGENTS.md');
@@ -100,6 +155,23 @@ rl.question(questionIde, (answerIde) => {
         ruleFilePath = path.join(cwd, '.agents', 'AGENTS.md');
         baseFolderForPrompt = '.agents/skills';
       }
+    } else if (isKilo) {
+      if (isGlobal) {
+        targetDir = path.join(homeDir, '.qk-ai-skill-os');
+        baseFolderForPrompt = targetDir.replace(/\\/g, '/');
+        kiloSkillsDir = path.join(homeDir, '.kilo', 'skills');
+        kiloThemesDir = path.join(homeDir, '.config', 'kilo', 'themes');
+        kiloCommandsDir = path.join(homeDir, '.config', 'kilo', 'command');
+        kiloJsonPath = path.join(homeDir, '.config', 'kilo', 'kilo.json');
+      } else {
+        targetDir = path.join(cwd, '.qk-ai-skill-os');
+        baseFolderForPrompt = './.qk-ai-skill-os';
+        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+        kiloJsonPath = path.join(cwd, 'kilo.json');
+      }
+      ruleFilePath = path.join(cwd, 'CLAUDE.md');
     } else {
       if (isGlobal) {
         targetDir = path.join(homeDir, '.qk-ai-skill-os');
@@ -136,49 +208,78 @@ Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải
         'skills', '_template', 'docs', 'skills.json', 'README.md', 'CHANGELOG.md', 'LICENSE'
       ];
 
-      // Nếu là Gemini Global, chỉ cần copy skills và skills.json để tránh rác
       if (isGemini && isGlobal) {
         if (fs.existsSync(path.join(sourceDir, 'skills'))) {
-            copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
+          copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
         }
         if (fs.existsSync(path.join(sourceDir, 'skills.json'))) {
-            fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
+          fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
         }
       } else {
         filesAndFolders.forEach(item => {
-            const src = path.join(sourceDir, item);
-            let dest = path.join(targetDir, item);
-            if (fs.existsSync(src)) {
-                copyRecursiveSync(src, dest);
-            }
+          const src = path.join(sourceDir, item);
+          let dest = path.join(targetDir, item);
+          if (fs.existsSync(src)) {
+            copyRecursiveSync(src, dest);
+          }
         });
       }
 
       if (ruleFilePath) {
-          const ruleDir = path.dirname(ruleFilePath);
-          if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
-              fs.mkdirSync(ruleDir, { recursive: true });
-          }
-          
-          let writeContent = systemPrompt;
-          if (isGemini) {
-              writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
-          }
+        const ruleDir = path.dirname(ruleFilePath);
+        if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
+          fs.mkdirSync(ruleDir, { recursive: true });
+        }
 
-          if (fs.existsSync(ruleFilePath)) {
-              fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
-              console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
-          } else {
-              fs.writeFileSync(ruleFilePath, writeContent);
-              console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
-          }
+        let writeContent = systemPrompt;
+        if (isGemini) {
+          writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
+        }
+
+        if (fs.existsSync(ruleFilePath)) {
+          fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
+          console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
+        } else {
+          fs.writeFileSync(ruleFilePath, writeContent);
+          console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
+        }
+      }
+
+      if (isKilo) {
+        ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
+        console.log(`✅ Đã cấu hình Kilo Code tại: ${kiloJsonPath}`);
+        console.log(`   → Skills: ${kiloSkillsDir}`);
+        console.log(`   → Themes: ${kiloThemesDir}`);
+        console.log(`   → Commands: ${kiloCommandsDir}`);
+      }
+
+      if (isMultiIde) {
+        if (kiloJsonPath && kiloSkillsDir) {
+          ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
+          console.log(`✅ Đã cấu hình Kilo Code (Multi-IDE) tại: ${kiloJsonPath}`);
+          console.log(`   → Skills: ${kiloSkillsDir}`);
+          console.log(`   → Themes: ${kiloThemesDir}`);
+          console.log(`   → Commands: ${kiloCommandsDir}`);
+        } else if (ruleFilePath) {
+          console.log(`✅ Đã tạo file cấu hình Multi-IDE: ${ruleFilePath}`);
+        }
       }
 
       console.log(`\n🎉 HOÀN TẤT! Dữ liệu kỹ năng đã được lưu tại: ${targetDir}`);
       if (isGlobal && !isGemini) {
-        console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${ruleFileName}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
+        const name = ruleFilePath ? path.basename(ruleFilePath) : 'CLAUDE.md';
+        console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${name}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
       } else if (isGlobal && isGemini) {
         console.log(`💡 Lưu ý: Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO trên máy tính này, Antigravity cũng sẽ tự động có đủ 23 kỹ năng mà không cần cài lại!`);
+      } else if (isKilo) {
+        console.log(`💡 Lưu ý: Kilo Code đã sẵn sàng. Dùng \`<leader>t\` hoặc \`/themes\` để xem, và \`/skills\` để xem danh sách skill đã cài.`);
+      }
+
+      if (!isGemini && !isKilo && !isMultiIde) {
+        if (fs.existsSync(path.join(cwd, '.kilorules'))) {
+          fs.unlinkSync(path.join(cwd, '.kilorules'));
+          console.log(`🧹 Đã xoá file .kilorules cũ (không còn cần thiết).`);
+        }
       }
 
     } catch (error) {