ai-developer-skill-os 1.7.1 → 1.8.1

package/README.md

@@ -57,6 +57,16 @@ Sau khi thư mục kỹ năng đã xuất hiện trong dự án của bạn, hã
 **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)
+#### Cách 1: Cài đặt Native (Khuyên dùng cho Kilo Code)
+Chạy `npx ai-developer-skill-os init` và chọn **(6) Kilo Code**.
+Hệ thống sẽ tự động:
+- Copy toàn bộ skills vào `.kilo/skills/` (Local) hoặc `~/.kilo/skills/` (Global)
+- Cấu hình `kilo.json` hoặc `~/.config/kilo/kilo.json` để Kilo nhận diện
+- Tạo file `CLAUDE.md` như hướng dẫn bổ sung
+
+Sau đó mở Kilo Code, dùng `<leader>t` hoặc `/themes` để kiểm tra skills đã được cài.
+
+#### Cách 2: Thủ công
 Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
 # System Instructions

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) {

package/docs/HUONG_DAN_SU_DUNG.md

@@ -59,6 +59,16 @@ Speak to me in Vietnamese, but write all code in English.
 ```
 
 ### Cho Claude Code / Kilo Code (CLI Agents)
+#### Cách 1: Cài đặt Native (Khuyên dùng cho Kilo Code)
+Chạy `npx ai-developer-skill-os init` và chọn **(6) Kilo Code**.
+Hệ thống sẽ tự động:
+- Copy toàn bộ skills vào `.kilo/skills/` (Local) hoặc `~/.kilo/skills/` (Global)
+- Cấu hình `kilo.json` hoặc `~/.config/kilo/kilo.json` để Kilo nhận diện
+- Tạo file `CLAUDE.md` như hướng dẫn bổ sung
+
+Sau đó mở Kilo Code, dùng `<leader>t` hoặc `/themes` để kiểm tra skills đã được cài.
+
+#### Cách 2: Thủ công
 Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
 ```md
 # System Instructions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "description": "Multi-agent skill package cho AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
   "main": "bin/install.js",
   "bin": {