ai-developer-skill-os 7.5.0 → 8.1.4

package/migrate.js

@@ -1,147 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const skillsDir = path.join(__dirname, 'skills');
-
-function migrateSkill(skillDir) {
-    const filePath = path.join(skillsDir, skillDir, 'SKILL.md');
-    if (!fs.existsSync(filePath)) return;
-    
-    if (skillDir === 'qk-bug-resolution') return; // Skip already migrated
-
-    let content = fs.readFileSync(filePath, 'utf8');
-    
-    // Parse Frontmatter
-    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!fmMatch) return;
-    let frontmatter = fmMatch[1];
-    
-    // Filter old fields
-    const validFields = [];
-    const lines = frontmatter.split('\n');
-    for (const line of lines) {
-        if (!line.startsWith('behavior:') && !line.startsWith('intent:') && !line.startsWith('priority:') && !line.startsWith('trigger:') && !line.startsWith('inputs:') && !line.startsWith('outputs:') && !line.startsWith('allowed_tools:') && !line.startsWith('pipeline:')) {
-            validFields.push(line.replace(/v5\.0/g, 'v6.0'));
-        }
-    }
-    const newFm = '---\n' + validFields.join('\n') + '\n---';
-
-    // Parse Mission
-    let mission = 'Th?c thi nhi?m v? c?t l�i.';
-    let limitation = 'Kh�ng vi ph?m Invariants c?a h? th?ng.';
-    
-    const missionSection = content.match(/## ?? Mission \(Scope\)[\s\S]*?(?=## |---|$)/);
-    if (missionSection) {
-        const missionLines = missionSection[0].split('\n');
-        const posLines = missionLines.filter(l => l.includes('- ?')).map(l => l.replace('- ?', '').trim());
-        const negLines = missionLines.filter(l => l.includes('- ?')).map(l => l.replace('- ?', '').trim());
-        
-        if (posLines.length > 0) mission = posLines.join(' ');
-        if (negLines.length > 0) limitation = negLines.join(' ');
-    }
-
-    // Parse Biases (Map to Reasoning Boundary - Must refuse)
-    const biasesMatch = content.match(/Biases:[\s\S]*?(?=---|$)/);
-    let refuses = [];
-    if (biasesMatch) {
-        const biasLines = biasesMatch[0].split('\n').filter(l => l.includes('- id:'));
-        refuses = biasLines.map(l => l.replace('- id:', '').trim());
-    }
-
-    // Parse Dials (Map to Context Policy / Reasoning)
-    const dialsMatch = content.match(/Dials:[\s\S]*?(?=---|$)/);
-    let asks = [];
-    if (dialsMatch) {
-        const dialLines = dialsMatch[0].split('\n').filter(l => l.includes('- id:'));
-        asks = dialLines.map(l => l.replace('- id:', '').trim());
-    }
-
-    // Generate BSF content
-    const bsfContent = \\
-
-# ?? Behavior Specification: \
-
-## 1. Behavior (�?nh danh H�nh vi)
-\\\yaml
-Mission: "\"
-Authority: "�u?c quy?n th?c thi c�c t�c v? trong ph?m vi \."
-Responsibility: "B?o d?m ch?t lu?ng d?u ra v� tu�n th? chu?n h? th?ng."
-Limitation: "\"
-\\\
-
-## 2. Contracts (H?p d?ng)
-
-### 2.1. Capability Contract
-\\\yaml
-Can:
-  - read_code
-  - execute_tests
-  - modify_code
-Must:
-  - verify_assumptions_before_coding
-Cannot:
-  - execute_destructive_commands
-  - bypass_validation
-\\\
-
-### 2.2. Output Contract
-\\\yaml
-Artifacts:
-  - summary_report: "Decision Summary gi?i th�ch Context, Quy?t d?nh v� Trade-offs."
-Completion: "Nhi?m v? ho�n th�nh & Quality Gates passed."
-\\\
-
-## 3. Policies (Ch�nh s�ch)
-
-### 3.1. Context Policy
-\\\yaml
-Scope: current_repo
-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: "Bi?n s? c?c b?, logic n?i b? kh�ng ?nh hu?ng h? th?ng."
-Must verify: "T�c d?ng d?n c�c module kh�c."
-Must ask: "\"
-Must refuse: "\"
-\\\
-
-### 3.3. Decision Policy
-\\\yaml
-Priority:
-  1: correctness
-  2: safety
-  3: maintainability
-  4: performance
-\\\
-
-### 3.4. Evidence Policy
-\\\yaml
-Accept: [logs, unit tests, official docs]
-Prefer: [unit tests, CI results]
-Reject: [guesswork, outdated internet search]
-\\\
-
-### 3.5. Escalation Policy
-\\\yaml
-Warning: "Thay d?i c?u tr�c ho?c public API"
-Confirmation: "Override config ho?c x�a file quan tr?ng"
-Stop: "L?i Permission ho?c xung d?t Invariants"
-\\\
-\;
-
-    fs.writeFileSync(filePath, bsfContent);
-    console.log('Migrated ' + skillDir);
-}
-
-const dirs = fs.readdirSync(skillsDir);
-for (const dir of dirs) {
-    if (fs.statSync(path.join(skillsDir, dir)).isDirectory() && !dir.startsWith('_')) {
-        migrateSkill(dir);
-    }
-}

package/migrate.py

@@ -1,133 +0,0 @@
-import os
-import re
-
-skills_dir = os.path.join(os.getcwd(), 'skills')
-
-def migrate_skill(skill_dir):
-    file_path = os.path.join(skills_dir, skill_dir, 'SKILL.md')
-    if not os.path.exists(file_path): return
-    if skill_dir in ['qk-bug-resolution', 'qk-access-policy']: return
-
-    with open(file_path, 'r', encoding='utf-8') as f:
-        content = f.read()
-
-    fm_match = re.search(r'^---\n(.*?)\n---', content, re.DOTALL)
-    if not fm_match: return
-    frontmatter = fm_match.group(1)
-
-    valid_fields = []
-    for line in frontmatter.split('\n'):
-        if not any(line.startswith(prefix) for prefix in ['behavior:', 'intent:', 'priority:', 'trigger:', 'inputs:', 'outputs:', 'allowed_tools:', 'pipeline:']):
-            valid_fields.append(line.replace('v5.0', 'v6.0'))
-
-    new_fm = '---\n' + '\n'.join(valid_fields) + '\n---'
-
-    mission = f'Th?c thi nhi?m v? c?t l�i c?a {skill_dir}'
-    limitation = 'Kh�ng vi ph?m Invariants c?a h? th?ng.'
-    
-    mission_section = re.search(r'## .*?Mission \(Scope\)(.*?)(?=## |---|$)', content, re.DOTALL)
-    if mission_section:
-        lines = mission_section.group(1).split('\n')
-        pos = [l.split('- ?')[-1].strip() for l in lines if '- ?' in l]
-        neg = [l.split('- ?')[-1].strip() for l in lines if '- ?' in l]
-        if pos: mission = ' '.join(pos)
-        if neg: limitation = ' '.join(neg)
-
-    biases_match = re.search(r'Biases:(.*?)(?=---|$)', content, re.DOTALL)
-    refuses = []
-    if biases_match:
-        refuses = [l.replace('- id:', '').strip() for l in biases_match.group(1).split('\n') if '- id:' in l]
-
-    dials_match = re.search(r'Dials:(.*?)(?=---|$)', content, re.DOTALL)
-    asks = []
-    if dials_match:
-        asks = [l.replace('- id:', '').strip() for l in dials_match.group(1).split('\n') if '- id:' in l]
-
-    must_ask = ', '.join(asks) if asks else 'Y�u c?u m?p m?, thi?u th�ng tin.'
-    must_refuse = ', '.join(refuses) if refuses else 'R?i ro b?o m?t, ph� v? ki?n tr�c.'
-
-    bsf_content = f'''{new_fm}
-
-# ?? Behavior Specification: {skill_dir}
-
-## 1. Behavior (�?nh danh H�nh vi)
-`yaml
-Mission: "{mission.replace('"', "'")}"
-Authority: "�u?c quy?n th?c thi c�c t�c v? trong ph?m vi {skill_dir}."
-Responsibility: "B?o d?m ch?t lu?ng d?u ra v� tu�n th? chu?n h? th?ng."
-Limitation: "{limitation.replace('"', "'")}"
-`
-
-## 2. Contracts (H?p d?ng)
-
-### 2.1. Capability Contract
-`yaml
-Can:
-  - read_code
-  - execute_tests
-  - modify_code
-Must:
-  - verify_assumptions_before_coding
-Cannot:
-  - execute_destructive_commands
-  - bypass_validation
-`
-
-### 2.2. Output Contract
-`yaml
-Artifacts:
-  - summary_report: "Decision Summary gi?i th�ch Context, Quy?t d?nh v� Trade-offs."
-Completion: "Nhi?m v? ho�n th�nh & Quality Gates passed."
-`
-
-## 3. Policies (Ch�nh s�ch)
-
-### 3.1. Context Policy
-`yaml
-Scope: current_repo
-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: "Bi?n s? c?c b?, logic n?i b? kh�ng ?nh hu?ng h? th?ng."
-Must verify: "T�c d?ng d?n c�c module kh�c."
-Must ask: "{must_ask.replace('"', "'")}"
-Must refuse: "{must_refuse.replace('"', "'")}"
-`
-
-### 3.3. Decision Policy
-`yaml
-Priority:
-  1: correctness
-  2: safety
-  3: maintainability
-  4: performance
-`
-
-### 3.4. Evidence Policy
-`yaml
-Accept: [logs, unit tests, official docs]
-Prefer: [unit tests, CI results]
-Reject: [guesswork, outdated internet search]
-`
-
-### 3.5. Escalation Policy
-`yaml
-Warning: "Thay d?i c?u tr�c ho?c public API"
-Confirmation: "Override config ho?c x�a file quan tr?ng"
-Stop: "L?i Permission ho?c xung d?t Invariants"
-`
-'''
-    with open(file_path, 'w', encoding='utf-8') as f:
-        f.write(bsf_content)
-    print(f'Migrated {skill_dir}')
-
-for d in os.listdir(skills_dir):
-    if os.path.isdir(os.path.join(skills_dir, d)) and not d.startswith('_'):
-        migrate_skill(d)

package/migrate_all.cjs

@@ -1,96 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const skillsDir = path.join(__dirname, 'skills');
-
-const template = `---
-name: {NAME}
-version: 6.0.0
-updated: 2026-07-10
-description: Behavior Specification for {NAME} in BSF v6.0 format.
-category: orchestration
-tags: [bsf, v6]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
----
-
-# Behavior Specification: {NAME}
-
-## 1. Behavior
-\`\`\`yaml
-Mission: "Execute core tasks for {NAME}."
-Authority: "Full authority within the scope of {NAME}."
-Responsibility: "Ensure the system complies with v6 standards."
-Limitation: "Do not violate System Invariants."
-\`\`\`
-
-## 2. Contracts
-
-### 2.1. Capability Contract
-\`\`\`yaml
-Can:
-  - read_code
-  - modify_code
-Must:
-  - verify_assumptions_before_coding
-Cannot:
-  - bypass_validation
-\`\`\`
-
-### 2.2. Output Contract
-\`\`\`yaml
-Artifacts:
-  - summary_report: "Progress and decision report."
-Completion: "Feature works & Quality Gates passed."
-\`\`\`
-
-## 3. Policies
-
-### 3.1. Context Policy
-\`\`\`yaml
-Scope: whole_workspace
-Priority:
-  1: Project Guidelines
-  2: Current Code
-Trust: "official docs > code > user assumptions"
-Fallback: ask_user
-\`\`\`
-
-### 3.2. Reasoning Boundary
-\`\`\`yaml
-May infer: "Local variables and obvious logic."
-Must verify: "Cross-module impacts."
-Must ask: "Vague requirements, missing context."
-Must refuse: "Security risks, baseless guesses."
-\`\`\`
-
-### 3.3. Decision Policy
-\`\`\`yaml
-Priority:
-  1: correctness
-  2: safety
-  3: maintainability
-\`\`\`
-
-### 3.4. Evidence Policy
-\`\`\`yaml
-Accept: [unit tests, CI logs]
-Prefer: [end-to-end tests]
-Reject: [guesswork]
-\`\`\`
-
-### 3.5. Escalation Policy
-\`\`\`yaml
-Warning: "Changing task scope."
-Confirmation: "Overriding config or deleting files."
-Stop: "Critical security error."
-\`\`\`
-`;
-
-const dirs = fs.readdirSync(skillsDir);
-for (const dir of dirs) {
-    if (dir.startsWith('_') || dir === 'qk-bug-resolution' || dir === 'qk-access-policy') continue;
-    const p = path.join(skillsDir, dir, 'SKILL.md');
-    if (fs.existsSync(p)) {
-        fs.writeFileSync(p, template.replace(/{NAME}/g, dir), 'utf8');
-        console.log('Updated ' + dir);
-    }
-}

package/patch.js

@@ -1,15 +0,0 @@
-const fs = require('fs');
-let content = fs.readFileSync('bin/install.js', 'utf8');
-
-// Fix kiloConfig bug
-content = content.replace(
-    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
-    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
-);
-
-// Replace interactive prompt
-const startMarker = "rl.question(questionIde, (answerIde) => {";
-const endMarker = "} catch (error) {\\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\\n    } finally {\\n      rl.close();\\n    }\\n  });\\n});";
-
-const startIdx = content.indexOf(startMarker);
-// Actually simpler regex

package/patch.py

@@ -1,89 +0,0 @@
-import sys
-with open('bin/install.js', 'r', encoding='utf-8') as f:
-    content = f.read()
-
-# Fix kiloConfig bug
-content = content.replace(
-    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
-    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
-)
-
-# Replace the interactive part with CLI parsing
-start_marker = "rl.question(questionIde, (ideChoice) => {"
-end_marker = "    } catch (error) {\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\n    } finally {\n      rl.close();\n    }\n  });\n});"
-
-start_idx = content.find(start_marker)
-end_idx = content.find(end_marker) + len(end_marker)
-
-if start_idx != -1 and end_idx != -1:
-    replacement = """// Parse command line arguments for CI/CD automation
-const args = process.argv.slice(2);
-let autoIde = null;
-let autoScope = null;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i].startsWith('--ide=')) {
-    autoIde = args[i].split('=')[1];
-  }
-  if (args[i].startsWith('--scope=')) {
-    autoScope = args[i].split('=')[1];
-  }
-}
-
-function runInstallation(ideChoice, scopeChoice) {
-    const isGlobal = scopeChoice === '1';
-"""
-
-    old_body = content[start_idx:end_idx]
-    
-    # Extract the body inside rl.question(questionScope...)
-    scope_start = "const isGlobal = scopeChoice === '1';"
-    scope_start_idx = old_body.find(scope_start)
-    scope_end = "    } catch (error) {"
-    scope_end_idx = old_body.find(scope_end)
-    
-    inner_body = old_body[scope_start_idx + len(scope_start):scope_end_idx]
-    
-    replacement += inner_body
-    replacement += """
-    } catch (error) {
-      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);
-    } finally {
-      rl.close();
-    }
-}
-
-if (autoIde && autoScope) {
-  console.log('\\n?? Running in non-interactive mode with IDE=' + autoIde + ', Scope=' + autoScope);
-  runInstallation(autoIde, autoScope);
-} else {
-  rl.question(questionIde, (ideChoice) => {
-    if (ideChoice === '0') {
-      console.log('? �� b? qua c?u h�nh t? d?ng. Skill OS v?n du?c t?i v?, b?n c� th? t? c?u h�nh file c?a IDE theo thu m?c hi?n t?i.');
-      rl.close();
-      return;
-    }
-
-    if (!['1', '2', '3', '4', '5', '6', '7'].includes(ideChoice)) {
-      console.log('? L?a ch?n kh�ng h?p l?. Vui l�ng ch?y l?i script.');
-      rl.close();
-      return;
-    }
-
-    rl.question(questionScope, (scopeChoice) => {
-      if (!['1', '2'].includes(scopeChoice)) {
-        console.log('? L?a ch?n kh�ng h?p l?. M?c d?nh s? c�i Global.');
-        scopeChoice = '1';
-      }
-      runInstallation(ideChoice, scopeChoice);
-    });
-  });
-}
-"""
-    content = content[:start_idx] + replacement + content[end_idx:]
-    
-    with open('bin/install.js', 'w', encoding='utf-8') as f:
-        f.write(content)
-    print("Python patch applied.")
-else:
-    print("Could not find markers.")

package/patch2.py

@@ -1,83 +0,0 @@
-import sys
-with open('bin/install.js', 'r', encoding='utf-8') as f:
-    content = f.read()
-
-# Fix kiloConfig bug
-content = content.replace(
-    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
-    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
-)
-
-# Replace the interactive part with CLI parsing
-start_marker = "rl.question(questionIde, (answerIde) => {"
-end_marker = "    } catch (error) {\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\n    } finally {\n      rl.close();\n    }\n  });\n});"
-
-start_idx = content.find(start_marker)
-end_idx = content.find(end_marker) + len(end_marker)
-
-if start_idx != -1 and end_idx != -1:
-    replacement = """// Parse command line arguments for CI/CD automation
-const args = process.argv.slice(2);
-let autoIde = null;
-let autoScope = null;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i].startsWith('--ide=')) {
-    autoIde = args[i].split('=')[1];
-  }
-  if (args[i].startsWith('--scope=')) {
-    autoScope = args[i].split('=')[1];
-  }
-}
-
-function runInstallation(answerIde, answerScope) {
-"""
-
-    old_body = content[start_idx:end_idx]
-    
-    # Extract the body inside rl.question(questionScope...)
-    scope_start = "rl.question(questionScope, (answerScope) => {"
-    scope_start_idx = old_body.find(scope_start) + len(scope_start)
-    scope_end = "    } catch (error) {"
-    scope_end_idx = old_body.find(scope_end)
-    
-    # Extract the ide logic before scope question
-    ide_logic_start_idx = old_body.find("  let isGemini = false;")
-    ide_logic_end_idx = old_body.find(scope_start)
-    ide_logic = old_body[ide_logic_start_idx:ide_logic_end_idx]
-    
-    inner_body = old_body[scope_start_idx:scope_end_idx]
-    
-    replacement += ide_logic
-    replacement += inner_body
-    replacement += """
-    } catch (error) {
-      console.error('? Error during installation:', error.message);
-    } finally {
-      if (rl) rl.close();
-    }
-}
-
-if (autoIde && autoScope) {
-  console.log('\\n?? Running in non-interactive mode with IDE=' + autoIde + ', Scope=' + autoScope);
-  runInstallation(autoIde, autoScope);
-} else {
-  rl.question(questionIde, (answerIde) => {
-    if (answerIde.trim() === '0') {
-      console.log('? B? qua c�i d?t t? d?ng.');
-      rl.close();
-      return;
-    }
-    rl.question(questionScope, (answerScope) => {
-      runInstallation(answerIde, answerScope);
-    });
-  });
-}
-"""
-    content = content[:start_idx] + replacement + content[end_idx:]
-    
-    with open('bin/install.js', 'w', encoding='utf-8') as f:
-        f.write(content)
-    print("Python patch applied.")
-else:
-    print("Could not find markers.")

package/rename.js

@@ -1,64 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { execSync } from 'child_process';
-
-const skillsDir = 'skills';
-const categories = fs.readdirSync(skillsDir).filter(f => fs.statSync(path.join(skillsDir, f)).isDirectory());
-
-categories.forEach(category => {
-  const catPath = path.join(skillsDir, category);
-  const skills = fs.readdirSync(catPath).filter(f => fs.statSync(path.join(catPath, f)).isDirectory());
-  skills.forEach(skill => {
-    if (!skill.startsWith('qk-')) {
-      const oldPath = path.join(catPath, skill).replace(/\\/g, '/');
-      const newPath = path.join(catPath, 'qk-' + skill).replace(/\\/g, '/');
-      try {
-        console.log(`Đang đổi tên: ${oldPath} -> ${newPath}`);
-        execSync(`git mv "${oldPath}" "${newPath}"`);
-      } catch(e) {
-        console.error('LỖI (Hãy chắc chắn bạn đã tắt hoàn toàn IDE/Cursor đang mở folder này):', e.message);
-      }
-    }
-  });
-});
-
-// Update skills.json
-const skillsJsonPath = 'skills.json';
-let skillsData = JSON.parse(fs.readFileSync(skillsJsonPath, 'utf8'));
-
-// Fix entries and modify their paths
-if(skillsData.skills) {
-    skillsData.skills = skillsData.skills.map(s => {
-        if(!s.name.startsWith('qk-')) {
-            s.name = 'qk-' + s.name;
-            const parts = s.path.split('/');
-            const skillFolder = parts[2];
-            if(!skillFolder.startsWith('qk-')) {
-                parts[2] = 'qk-' + skillFolder;
-            }
-            s.path = parts.join('/');
-        }
-        return s;
-    });
-}
-fs.writeFileSync(skillsJsonPath, JSON.stringify(skillsData, null, 2));
-
-// Update SKILL.md names
-categories.forEach(category => {
-  const catPath = path.join(skillsDir, category);
-  const skills = fs.readdirSync(catPath).filter(f => fs.statSync(path.join(catPath, f)).isDirectory());
-  skills.forEach(skill => {
-    if (skill.startsWith('qk-')) {
-      const skillMdPath = path.join(catPath, skill, 'SKILL.md');
-      if (fs.existsSync(skillMdPath)) {
-        let content = fs.readFileSync(skillMdPath, 'utf8');
-        content = content.replace(/^name:\s*([a-zA-Z0-9-]+)\s*$/m, (match, p1) => {
-          if (!p1.startsWith('qk-')) return 'name: qk-' + p1;
-          return match;
-        });
-        fs.writeFileSync(skillMdPath, content);
-      }
-    }
-  });
-});
-console.log('✅ Đã đổi tên thành công toàn bộ sang hệ qk-* !');