ai-developer-skill-os 7.0.2 → 7.5.0

package/CLAUDE.md

@@ -0,0 +1,110 @@
+[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/README.md

@@ -21,14 +21,14 @@ Bảo vệ mã nguồn khỏi thói quen "sửa vội" của AI. Lỗi bắt bu
 
 ---
 
-## 🧩 Danh sách 23 Master Skills
+## 🧩 Danh sách 22 Master Skills
 
 Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tra tự động (Vitest) để đảm bảo tính nhất quán của luật lệ:
-- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-policy-engine`, `qk-access-policy`
+- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-access-policy`
 - **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-design-to-code`, `qk-ui-system-builder`
 - **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
 - **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
-- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`
+- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`, `qk-db-optimizer`
 
 ---
 
@@ -38,6 +38,28 @@ Sử dụng npm:
 ```bash
 npm i -g ai-developer-skill-os
 ```
+
+### Antigravity (Global)
+Cài 1 lần, áp dụng cho mọi dự án trên máy:
+```bash
+npm run install:antigravity
+```
+
+### Antigravity (Local — per project)
+Cài riêng cho dự án hiện tại, override global:
+```bash
+npm run install:antigravity:local
+```
+
+### Các IDE khác
+```bash
+npm run install:cursor        # Global Cursor
+npm run install:windsurf      # Global Windsurf
+npm run install:claude        # Global Claude Code
+npm run install:kilo          # Global Kilo Code
+npm run install:multi         # Multi-IDE (CLAUDE.md + .qk-ai-skill-os)
+```
+
 Hoặc khởi tạo thông qua `npx`:
 ```bash
 npx ai-developer-skill-os init

package/add_lang.js

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,53 @@
+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)