ai-developer-skill-os 7.5.1 → 8.1.4

package/.github/workflows/ci.yml

@@ -1,56 +0,0 @@
-name: CI / Spec Compliance & Registry Validation
-
-on:
-  pull_request:
-    paths:
-      - 'skills/**'
-      - 'skills.json'
-      - 'docs/SPEC.md'
-      - 'bin/install.js'
-  push:
-    branches: [ main ]
-    paths:
-      - 'skills/**'
-      - 'skills.json'
-      - 'docs/SPEC.md'
-      - 'bin/install.js'
-
-jobs:
-  lint-and-validate:
-    runs-on: windows-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Validate Skills Registry vs Filesystem
-        run: npm run test:registry
-
-      - name: Validate SKILL.md Spec Compliance
-        run: npm run lint
-
-  snapshot:
-    runs-on: windows-latest
-    needs: lint-and-validate
-    if: github.ref == 'refs/heads/main'
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Generate Registry Snapshot
-        run: node bin/install.js --ide=7 --scope=2

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,123 +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-ui-builder', '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-ui-builder', '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);
-}
-