add-skill-kit 3.2.3 → 3.2.5

package/lib/agent-cli/scripts/skill_injector.js

@@ -0,0 +1,387 @@
+#!/usr/bin/env node
+/**
+ * Skill Injector - Auto-generate SKILL.md from lessons learned
+ * 
+ * Part of FAANG-Grade Auto-Learn System Phase 5
+ * 
+ * Features:
+ * - Analyze lessons by category
+ * - Generate SKILL.md files from patterns
+ * - Create auto-generated skills folder
+ * - Link skills to lessons
+ * 
+ * Usage:
+ *   node skill_injector.js --analyze
+ *   node skill_injector.js --generate
+ *   node skill_injector.js --list
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Colors
+const c = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m'
+};
+
+// Paths
+function findProjectRoot() {
+    let current = process.cwd();
+    while (current !== path.dirname(current)) {
+        if (fs.existsSync(path.join(current, '.agent'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return process.cwd();
+}
+
+const projectRoot = findProjectRoot();
+const knowledgePath = path.join(projectRoot, '.agent', 'knowledge');
+const skillsPath = path.join(projectRoot, '.agent', 'skills');
+const autoSkillsPath = path.join(skillsPath, 'auto-generated');
+
+// Category mappings for skill generation
+const CATEGORY_CONFIG = {
+    'SAFE': { name: 'safety-rules', description: 'Auto-learned safety rules' },
+    'CODE': { name: 'code-patterns', description: 'Auto-learned code patterns' },
+    'FLOW': { name: 'workflow-rules', description: 'Auto-learned workflow rules' },
+    'INT': { name: 'integration-rules', description: 'Auto-learned integration rules' },
+    'PERF': { name: 'performance-rules', description: 'Auto-learned performance rules' },
+    'TEST': { name: 'testing-rules', description: 'Auto-learned testing rules' },
+    'LEARN': { name: 'general-lessons', description: 'General lessons learned' }
+};
+
+// Load JSON file
+function loadJson(filename) {
+    const filePath = path.join(knowledgePath, filename);
+    try {
+        if (fs.existsSync(filePath)) {
+            return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        }
+    } catch { }
+    return null;
+}
+
+// Ensure directories exist
+function ensureDirectories() {
+    if (!fs.existsSync(autoSkillsPath)) {
+        fs.mkdirSync(autoSkillsPath, { recursive: true });
+    }
+}
+
+// ==================== ANALYSIS ====================
+
+/**
+ * Analyze lessons and group by category
+ */
+function analyzeLessons() {
+    const lessons = loadJson('lessons-learned.json');
+    if (!lessons?.lessons?.length) {
+        return { categories: {}, total: 0 };
+    }
+
+    const categories = {};
+
+    for (const lesson of lessons.lessons) {
+        // Extract category from ID (e.g., SAFE-001 -> SAFE)
+        const category = lesson.id?.split('-')[0] || 'LEARN';
+
+        if (!categories[category]) {
+            categories[category] = [];
+        }
+        categories[category].push(lesson);
+    }
+
+    return { categories, total: lessons.lessons.length };
+}
+
+/**
+ * Check which categories have enough lessons for skill generation
+ */
+function getSkillCandidates() {
+    const { categories } = analyzeLessons();
+    const candidates = [];
+
+    for (const [category, lessons] of Object.entries(categories)) {
+        // Need at least 3 lessons to generate a skill
+        if (lessons.length >= 3) {
+            candidates.push({
+                category,
+                count: lessons.length,
+                config: CATEGORY_CONFIG[category] || {
+                    name: `${category.toLowerCase()}-rules`,
+                    description: `Auto-learned ${category.toLowerCase()} rules`
+                }
+            });
+        }
+    }
+
+    return candidates;
+}
+
+// ==================== SKILL GENERATION ====================
+
+/**
+ * Generate SKILL.md content from lessons
+ */
+function generateSkillContent(category, lessons, config) {
+    const now = new Date().toISOString();
+
+    let content = `---
+name: ${config.name}
+description: >-
+  ${config.description}. Auto-generated from ${lessons.length} lessons learned.
+  This skill was automatically created by skill_injector.js.
+metadata:
+  category: "auto-generated"
+  version: "1.0.0"
+  autoGenerated: true
+  generatedAt: "${now}"
+  lessonCount: ${lessons.length}
+  triggers: "auto-learned patterns from ${category} category"
+---
+
+# ${config.name}
+
+> **Auto-Generated Skill** - Created from lessons learned in category: ${category}
+
+---
+
+## Rules
+
+`;
+
+    // Add each lesson as a rule
+    for (const lesson of lessons) {
+        const severity = lesson.severity || 'MEDIUM';
+        const severityIcon = {
+            'CRITICAL': '🔴',
+            'HIGH': '🟠',
+            'MEDIUM': '🟡',
+            'LOW': '🟢'
+        }[severity] || '⚪';
+
+        content += `### ${lesson.id}: ${lesson.pattern || 'Unnamed Pattern'}
+
+${severityIcon} **Severity:** ${severity}
+
+${lesson.message || 'No message provided.'}
+
+`;
+        if (lesson.example_fix) {
+            content += `**Example Fix:**
+\`\`\`
+${lesson.example_fix}
+\`\`\`
+
+`;
+        }
+    }
+
+    // Add metadata section
+    content += `---
+
+## Metadata
+
+| Property | Value |
+|----------|-------|
+| Total Rules | ${lessons.length} |
+| Generated At | ${now.split('T')[0]} |
+| Category | ${category} |
+| Source | lessons-learned.json |
+
+---
+
+## When to Apply
+
+This skill is automatically invoked when patterns matching the following are detected:
+
+`;
+
+    for (const lesson of lessons.slice(0, 5)) {
+        content += `- ${lesson.pattern || lesson.id}\n`;
+    }
+
+    if (lessons.length > 5) {
+        content += `- ... and ${lessons.length - 5} more patterns\n`;
+    }
+
+    return content;
+}
+
+/**
+ * Generate skills for all eligible categories
+ */
+function generateSkills(dryRun = false) {
+    ensureDirectories();
+
+    const candidates = getSkillCandidates();
+    const { categories } = analyzeLessons();
+    const generated = [];
+
+    for (const candidate of candidates) {
+        const lessons = categories[candidate.category];
+        const content = generateSkillContent(
+            candidate.category,
+            lessons,
+            candidate.config
+        );
+
+        const skillDir = path.join(autoSkillsPath, candidate.config.name);
+        const skillFile = path.join(skillDir, 'SKILL.md');
+
+        if (!dryRun) {
+            if (!fs.existsSync(skillDir)) {
+                fs.mkdirSync(skillDir, { recursive: true });
+            }
+            fs.writeFileSync(skillFile, content);
+        }
+
+        generated.push({
+            category: candidate.category,
+            name: candidate.config.name,
+            path: skillFile,
+            lessonCount: lessons.length
+        });
+    }
+
+    return generated;
+}
+
+// ==================== LIST ====================
+
+/**
+ * List auto-generated skills
+ */
+function listAutoSkills() {
+    if (!fs.existsSync(autoSkillsPath)) {
+        console.log(`${c.gray}No auto-generated skills yet.${c.reset}`);
+        return [];
+    }
+
+    const skills = [];
+    const entries = fs.readdirSync(autoSkillsPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const skillFile = path.join(autoSkillsPath, entry.name, 'SKILL.md');
+            if (fs.existsSync(skillFile)) {
+                skills.push({
+                    name: entry.name,
+                    path: skillFile
+                });
+            }
+        }
+    }
+
+    return skills;
+}
+
+// ==================== MAIN ====================
+
+const args = process.argv.slice(2);
+
+if (args.includes('--analyze') || args.includes('-a')) {
+    console.log(`${c.cyan}╔════════════════════════════════════════╗${c.reset}`);
+    console.log(`${c.cyan}║${c.reset}  🧠 Skill Injector Analysis             ${c.cyan}║${c.reset}`);
+    console.log(`${c.cyan}╚════════════════════════════════════════╝${c.reset}\n`);
+
+    const { categories, total } = analyzeLessons();
+
+    console.log(`${c.bold}Lessons by Category:${c.reset}`);
+    for (const [cat, lessons] of Object.entries(categories)) {
+        const config = CATEGORY_CONFIG[cat];
+        const skillName = config?.name || `${cat.toLowerCase()}-rules`;
+        const canGenerate = lessons.length >= 3;
+        const status = canGenerate ? `${c.green}✓ Can generate${c.reset}` : `${c.gray}(need 3+)${c.reset}`;
+        console.log(`  ${c.blue}${cat}${c.reset}: ${lessons.length} lessons → ${skillName} ${status}`);
+    }
+
+    console.log(`\n${c.gray}Total lessons: ${total}${c.reset}`);
+
+    const candidates = getSkillCandidates();
+    if (candidates.length > 0) {
+        console.log(`${c.green}${c.bold}Ready to generate ${candidates.length} skills${c.reset}`);
+        console.log(`${c.gray}Run: node skill_injector.js --generate${c.reset}`);
+    }
+
+} else if (args.includes('--generate') || args.includes('-g')) {
+    console.log(`${c.cyan}🔧 Generating skills from lessons...${c.reset}\n`);
+
+    const generated = generateSkills();
+
+    if (generated.length === 0) {
+        console.log(`${c.yellow}No skill candidates (need 3+ lessons per category)${c.reset}`);
+    } else {
+        console.log(`${c.green}${c.bold}Generated ${generated.length} skills:${c.reset}`);
+        for (const skill of generated) {
+            console.log(`  ${c.green}✓${c.reset} ${skill.name} (${skill.lessonCount} rules)`);
+            console.log(`    ${c.gray}${skill.path}${c.reset}`);
+        }
+    }
+
+} else if (args.includes('--dry-run')) {
+    console.log(`${c.cyan}🔍 Dry run - what would be generated:${c.reset}\n`);
+
+    const generated = generateSkills(true);
+
+    for (const skill of generated) {
+        console.log(`  ${c.blue}→${c.reset} ${skill.name} (${skill.lessonCount} rules)`);
+    }
+
+} else if (args.includes('--list') || args.includes('-l')) {
+    console.log(`${c.cyan}📂 Auto-Generated Skills:${c.reset}\n`);
+
+    const skills = listAutoSkills();
+
+    if (skills.length === 0) {
+        console.log(`${c.gray}No auto-generated skills yet.${c.reset}`);
+        console.log(`${c.gray}Run: node skill_injector.js --generate${c.reset}`);
+    } else {
+        for (const skill of skills) {
+            console.log(`  ${c.green}●${c.reset} ${skill.name}`);
+            console.log(`    ${c.gray}${skill.path}${c.reset}`);
+        }
+    }
+
+} else {
+    console.log(`${c.cyan}skill_injector - Auto-generate SKILL.md from lessons${c.reset}
+
+${c.bold}Usage:${c.reset}
+  node skill_injector.js --analyze    Analyze lessons and show candidates
+  node skill_injector.js --generate   Generate skills from lessons
+  node skill_injector.js --dry-run    Preview without creating files
+  node skill_injector.js --list       List auto-generated skills
+
+${c.bold}Requirements:${c.reset}
+  - At least 3 lessons in a category to generate a skill
+  - Skills are created in: .agent/skills/auto-generated/
+
+${c.bold}Category Mappings:${c.reset}
+  SAFE  → safety-rules
+  CODE  → code-patterns
+  FLOW  → workflow-rules
+  INT   → integration-rules
+  PERF  → performance-rules
+  TEST  → testing-rules
+  LEARN → general-lessons
+
+${c.bold}Examples:${c.reset}
+  node skill_injector.js --analyze    See what can be generated
+  node skill_injector.js --generate   Create skill files
+`);
+}
+
+export { analyzeLessons, getSkillCandidates, generateSkills, listAutoSkills };