@hongmaple0820/scale-engine 0.7.2 → 0.8.0

package/dist/skills/GrillingSessionSkill.js

@@ -0,0 +1,113 @@
+// SCALE Engine - Grilling Session Skill (mattpocock/skills style)
+// 递归决策树探索，一次一个问题
+import { getGrillingTemplate } from "./GrillingTemplates.js";
+import { logger } from "../core/logger.js";
+export class GrillingSessionManager {
+    constructor(eventBus) {
+        this.sessions = new Map();
+        this.eventBus = eventBus ?? null;
+        this.templates = getGrillingTemplate;
+    }
+    startSession(topic) {
+        const template = this.templates[topic] ?? getGrillingTemplate(topic);
+        const id = "GRILL-" + Date.now() + "-" + Math.random().toString(36).slice(2, 6);
+        const session = { id, topic, currentNodeId: template[0]?.id ?? "Q1", history: [], concluded: false };
+        this.sessions.set(id, session);
+        logger.info({ sessionId: id, topic }, "Grilling session started");
+        this.eventBus?.emit("grilling.session_started", { sessionId: id, topic });
+        return session;
+    }
+    handleAnswer(sessionId, selectedOption) {
+        const session = this.sessions.get(sessionId);
+        if (!session || session.concluded)
+            return { type: "conclusion", conclusion: session?.conclusion };
+        session.history.push({ questionId: session.currentNodeId, selectedOption, timestamp: Date.now() });
+        const currentQuestion = this.getCurrentQuestion(session);
+        if (!currentQuestion)
+            return this.concludeSession(session);
+        const nextNodeId = currentQuestion.branchMap[selectedOption];
+        if (nextNodeId === "CONCLUSION" || !nextNodeId)
+            return this.concludeSession(session);
+        session.currentNodeId = nextNodeId;
+        const nextQuestion = this.getCurrentQuestion(session);
+        return { type: "question", question: nextQuestion };
+    }
+    getSession(sessionId) { return this.sessions.get(sessionId); }
+    endSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return undefined;
+        if (!session.concluded)
+            this.concludeSession(session);
+        this.sessions.delete(sessionId);
+        this.eventBus?.emit("grilling.session_ended", { sessionId });
+        return session.conclusion;
+    }
+    getCurrentQuestion(session) {
+        const template = this.templates[session.topic];
+        return template?.find(q => q.id === session.currentNodeId);
+    }
+    concludeSession(session) {
+        session.concluded = true;
+        const decisions = this.extractDecisions(session.history);
+        const risks = this.extractRisks(session.history);
+        session.conclusion = {
+            summary: this.generateSummary(decisions),
+            decisions,
+            risks,
+            nextSteps: this.generateNextSteps(decisions),
+            artifactsToUpdate: this.suggestArtifactUpdates(decisions),
+        };
+        logger.info({ sessionId: session.id, decisions: decisions.length }, "Grilling concluded");
+        this.eventBus?.emit("grilling.concluded", { sessionId: session.id, conclusion: session.conclusion });
+        return { type: "conclusion", conclusion: session.conclusion };
+    }
+    extractDecisions(history) {
+        return history.map(h => h.selectedOption);
+    }
+    extractRisks(history) {
+        const risks = [];
+        for (const h of history) {
+            const question = this.findQuestion(h.questionId);
+            const option = question?.options.find(o => o.id === h.selectedOption);
+            if (option?.risk)
+                risks.push(option.risk);
+        }
+        return risks;
+    }
+    findQuestion(id) {
+        for (const template of Object.values(this.templates)) {
+            const q = template.find(t => t.id === id);
+            if (q)
+                return q;
+        }
+        return undefined;
+    }
+    generateSummary(decisions) {
+        return "Decisions made: " + decisions.join(" -> ");
+    }
+    generateNextSteps(decisions) {
+        const steps = [];
+        if (decisions.includes("internal"))
+            steps.push("Review internal user workflow");
+        if (decisions.includes("external"))
+            steps.push("Design public UX");
+        if (decisions.includes("deep"))
+            steps.push("Define interface contract");
+        if (decisions.includes("shallow"))
+            steps.push("Plan module composition");
+        return steps;
+    }
+    suggestArtifactUpdates(decisions) {
+        const artifacts = [];
+        if (decisions.length > 3)
+            artifacts.push("CONTEXT.md");
+        if (decisions.includes("enterprise") || decisions.includes("k8s"))
+            artifacts.push("ADR");
+        return artifacts;
+    }
+}
+export function createGrillingSessionManager(eventBus) {
+    return new GrillingSessionManager(eventBus);
+}
+//# sourceMappingURL=GrillingSessionSkill.js.map

package/dist/skills/GrillingSessionSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrillingSessionSkill.js","sourceRoot":"","sources":["../../src/skills/GrillingSessionSkill.ts"],"names":[],"mappings":"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"}

package/dist/skills/GrillingTemplates.d.ts

@@ -0,0 +1,7 @@
+import type { GrillingQuestion } from "./GrillingSessionSkill.js";
+export declare const REQUIREMENT_CLARITY_TREE: GrillingQuestion[];
+export declare const DESIGN_DEPTH_TREE: GrillingQuestion[];
+export declare const TECH_SELECTION_TREE: GrillingQuestion[];
+export type GrillingTopic = "requirement-clarity" | "design-depth" | "tech-selection";
+export declare const GRILLING_TEMPLATES: Record<GrillingTopic, GrillingQuestion[]>;
+export declare function getGrillingTemplate(topic: GrillingTopic): GrillingQuestion[];

package/dist/skills/GrillingTemplates.js

@@ -0,0 +1,38 @@
+// SCALE Engine - Grilling Templates (mattpocock/skills style)
+// 预定义决策树模板
+// ========== Requirement Clarity 决策树 ==========
+export const REQUIREMENT_CLARITY_TREE = [
+    { id: "Q1", question: "Target users?", options: [{ id: "internal", label: "Internal users", explanation: "Team/company internal" }, { id: "external", label: "External users", explanation: "Public users" }, { id: "both", label: "Mixed", explanation: "Both types" }], branchMap: { internal: "Q2", external: "Q3", both: "Q4" } },
+    { id: "Q2", question: "Internal complexity level?", options: [{ id: "simple", label: "Simple", explanation: "Basic workflow" }, { id: "moderate", label: "Moderate", explanation: "Multiple steps" }, { id: "complex", label: "Complex", explanation: "Enterprise-grade" }], branchMap: { simple: "CONCLUSION", moderate: "CONCLUSION", complex: "Q5" } },
+    { id: "Q3", question: "External user scale?", options: [{ id: "small", label: "Small (<100)", explanation: "Limited user base" }, { id: "medium", label: "Medium (100-10k)", explanation: "Growing user base" }, { id: "large", label: "Large (>10k)", explanation: "High scale, need optimization" }], branchMap: { small: "CONCLUSION", medium: "Q6", large: "Q7" } },
+    { id: "Q4", question: "Primary user focus?", options: [{ id: "internal", label: "Internal priority", explanation: "Internal needs first" }, { id: "external", label: "External priority", explanation: "Public users first" }, { id: "balanced", label: "Balanced", explanation: "Equal consideration" }], branchMap: { internal: "Q2", external: "Q3", balanced: "Q8" } },
+    { id: "Q5", question: "Security requirements?", options: [{ id: "basic", label: "Basic auth", explanation: "Simple authentication" }, { id: "advanced", label: "Role-based", explanation: "RBAC permissions" }, { id: "enterprise", label: "Enterprise SSO", explanation: "SSO integration required" }], branchMap: { basic: "CONCLUSION", advanced: "CONCLUSION", enterprise: "CONCLUSION" } },
+    { id: "Q6", question: "User registration needed?", options: [{ id: "optional", label: "Optional", explanation: "Guest access available" }, { id: "required", label: "Required", explanation: "Must register to use" }, { id: "social", label: "Social login", explanation: "OAuth/Social auth" }], branchMap: { optional: "CONCLUSION", required: "CONCLUSION", social: "CONCLUSION" } },
+    { id: "Q7", question: "Performance critical?", options: [{ id: "yes", label: "Yes - high traffic", explanation: "Need high performance" }, { id: "no", label: "No - normal traffic", explanation: "Standard performance OK" }], branchMap: { yes: "CONCLUSION", no: "CONCLUSION" } },
+    { id: "Q8", question: "UX consistency priority?", options: [{ id: "high", label: "High - unified UX", explanation: "Consistent across all" }, { id: "medium", label: "Medium", explanation: "Some variation OK" }, { id: "low", label: "Low - separate UX", explanation: "Different UX per segment" }], branchMap: { high: "CONCLUSION", medium: "CONCLUSION", low: "CONCLUSION" } },
+];
+// ========== Design Depth 决策树 ==========
+export const DESIGN_DEPTH_TREE = [
+    { id: "Q1", question: "Interface depth preference?", options: [{ id: "shallow", label: "Shallow (single responsibility)", explanation: "Simple interfaces, compose multiple calls" }, { id: "deep", label: "Deep (rich functionality)", explanation: "Rich interfaces, one call does more" }], branchMap: { shallow: "Q2", deep: "Q3" }, contextHint: "Deep Modules: interface depth = caller leverage + maintainer locality" },
+    { id: "Q2", question: "Composition approach?", options: [{ id: "chain", label: "Chain pattern", explanation: "Sequential composition" }, { id: "pipeline", label: "Pipeline", explanation: "Data flow pipeline" }, { id: "orchestrator", label: "Orchestrator", explanation: "Central coordinator" }], branchMap: { chain: "CONCLUSION", pipeline: "CONCLUSION", orchestrator: "CONCLUSION" } },
+    { id: "Q3", question: "Parameter count tolerance?", options: [{ id: "low", label: "Low (<=3 params)", explanation: "Minimal parameters" }, { id: "medium", label: "Medium (3-7)", explanation: "Moderate parameters" }, { id: "high", label: "High (>=7)", explanation: "Many parameters acceptable" }], branchMap: { low: "Q4", medium: "CONCLUSION", high: "Q5" } },
+    { id: "Q4", question: "Object pattern acceptable?", options: [{ id: "yes", label: "Yes - options object", explanation: "Use options object pattern" }, { id: "no", label: "No - explicit params", explanation: "Prefer explicit parameters" }], branchMap: { yes: "CONCLUSION", no: "CONCLUSION" } },
+    { id: "Q5", question: "Builder pattern needed?", options: [{ id: "yes", label: "Yes - fluent API", explanation: "Builder pattern for complex construction" }, { id: "no", label: "No - direct call", explanation: "Direct constructor call" }], branchMap: { yes: "CONCLUSION", no: "CONCLUSION" } },
+];
+// ========== Tech Selection 决策树 ==========
+export const TECH_SELECTION_TREE = [
+    { id: "Q1", question: "Technology domain?", options: [{ id: "frontend", label: "Frontend", explanation: "UI/UX, client-side" }, { id: "backend", label: "Backend", explanation: "Server-side, APIs" }, { id: "testing", label: "Testing", explanation: "Test frameworks" }, { id: "infra", label: "Infrastructure", explanation: "Deployment, DevOps" }], branchMap: { frontend: "Q2", backend: "Q3", testing: "Q4", infra: "Q5" } },
+    { id: "Q2", question: "Framework preference?", options: [{ id: "react", label: "React", explanation: "Component-based, Facebook" }, { id: "vue", label: "Vue", explanation: "Progressive, easy learning" }, { id: "svelte", label: "Svelte", explanation: "Compile-time, no runtime" }, { id: "vanilla", label: "Vanilla JS", explanation: "No framework, pure JS" }], branchMap: { react: "CONCLUSION", vue: "CONCLUSION", svelte: "CONCLUSION", vanilla: "CONCLUSION" } },
+    { id: "Q3", question: "Runtime preference?", options: [{ id: "nodejs", label: "Node.js", explanation: "Established, large ecosystem" }, { id: "deno", label: "Deno", explanation: "Modern, TypeScript-first" }, { id: "bun", label: "Bun", explanation: "Fast, native bundler" }], branchMap: { nodejs: "CONCLUSION", deno: "CONCLUSION", bun: "CONCLUSION" } },
+    { id: "Q4", question: "Test framework?", options: [{ id: "vitest", label: "Vitest", explanation: "Fast, Vite-native" }, { id: "jest", label: "Jest", explanation: "Established, feature-rich" }, { id: "playwright", label: "Playwright", explanation: "E2E, cross-browser" }], branchMap: { vitest: "CONCLUSION", jest: "CONCLUSION", playwright: "CONCLUSION" } },
+    { id: "Q5", question: "Deployment target?", options: [{ id: "vercel", label: "Vercel", explanation: "Edge, serverless" }, { id: "docker", label: "Docker", explanation: "Containerized" }, { id: "k8s", label: "Kubernetes", explanation: "Orchestrated containers" }, { id: "bare", label: "Bare metal", explanation: "Direct server deploy" }], branchMap: { vercel: "CONCLUSION", docker: "CONCLUSION", k8s: "CONCLUSION", bare: "CONCLUSION" } },
+];
+export const GRILLING_TEMPLATES = {
+    "requirement-clarity": REQUIREMENT_CLARITY_TREE,
+    "design-depth": DESIGN_DEPTH_TREE,
+    "tech-selection": TECH_SELECTION_TREE,
+};
+export function getGrillingTemplate(topic) {
+    return GRILLING_TEMPLATES[topic] ?? REQUIREMENT_CLARITY_TREE;
+}
+//# sourceMappingURL=GrillingTemplates.js.map

package/dist/skills/GrillingTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrillingTemplates.js","sourceRoot":"","sources":["../../src/skills/GrillingTemplates.ts"],"names":[],"mappings":"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"}

package/dist/skills/SkillDiscovery.d.ts

@@ -1,28 +1,53 @@
+import type { IEventBus } from '../core/eventBus.js';
+import type { SkillRegistry } from './SkillRegistry.js';
+import type { SkillInstallConfig, ISkillInstaller } from './SkillInstaller.js';
 import type { AgentPlatform, SkillRef, SkillScanResult } from '../artifact/types.js';
-export declare class SkillDiscovery {
+/** 发现上下文 - Agent 执行任务时的场景 */
+export interface DiscoveryContext {
+    taskType: string;
+    missingCapabilities: string[];
+    phase: 'explore' | 'plan' | 'execute' | 'verify' | 'deliver';
+    keywords: string[];
+}
+/** 发现结果 */
+export interface DiscoveryResult {
+    skillId: string;
+    sourceUrl: string;
+    quality: number;
+    relevance: number;
+    description: string;
+    alreadyInstalled: boolean;
+    installConfig?: SkillInstallConfig;
+}
+/** Agent 主动技能发现接口 */
+export interface ISkillDiscovery {
+    discover(context: DiscoveryContext): Promise<DiscoveryResult[]>;
+    recommendInstall(context: DiscoveryContext): Promise<SkillInstallConfig[]>;
+    periodicScan(): Promise<DiscoveryResult[]>;
+    checkDuringExecution(taskType: string, capabilities: string[]): Promise<DiscoveryResult[]>;
+    scanSkills(platform: AgentPlatform): SkillScanResult;
+    detectPlatform(): AgentPlatform | null;
+}
+export declare class SkillDiscovery implements ISkillDiscovery {
+    private registry;
+    private installer;
+    private eventBus;
     private projectDir;
-    constructor(projectDir?: string);
     /**
-     * Detect the active agent platform based on config files present in the project.
-     * Returns the most likely platform, or null if indeterminate.
+     * 构造函数支持两种模式：
+     * 1. 独立模式（仅 projectDir）：用于平台检测和技能扫描
+     * 2. 增强模式（完整参数）：用于 Agent 主动发现和推荐安装
      */
+    constructor(registryOrProjectDir: SkillRegistry | string, installer?: ISkillInstaller, eventBus?: IEventBus, projectDir?: string);
+    discover(context: DiscoveryContext): Promise<DiscoveryResult[]>;
+    recommendInstall(context: DiscoveryContext): Promise<SkillInstallConfig[]>;
+    periodicScan(): Promise<DiscoveryResult[]>;
+    checkDuringExecution(taskType: string, capabilities: string[]): Promise<DiscoveryResult[]>;
     detectPlatform(): AgentPlatform | null;
-    /**
-     * Scan the skills directory for a given platform.
-     * Returns structured skill references.
-     */
     scanSkills(platform: AgentPlatform): SkillScanResult;
-    /**
-     * Generate a skills.md document from discovered skills.
-     * Useful for injecting into agent knowledge docs.
-     */
     generateSkillsMd(skills: SkillRef[]): string;
-    /**
-     * Full discovery pipeline: detect platform → scan → generate doc.
-     */
-    discover(): {
-        platform: AgentPlatform | null;
-        skills: SkillRef[];
-        skillsMd: string;
-    };
+    private matchCategory;
+    private calculateRelevance;
+    private detectMissingCapabilities;
+    private createInstallConfig;
 }

package/dist/skills/SkillDiscovery.js

@@ -1,37 +1,146 @@
-// SCALE Engine — Skill Discovery
-// 检测平台 → 扫描技能目录 → 生成 skills.md
-// 设计参考：SCALE v10.0 技能生态系统
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+// SCALE Engine - Agent Proactive Skill Discovery + Platform Scanner
+// 让 Agent 在执行任务时主动发现缺失能力，推荐安装优秀技能
+// 同时支持扫描平台已有技能目录
+import { existsSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 // ============================================================================
+// 技能来源知识库 - Agent 知道去哪里找优秀技能
+// ============================================================================
+const KNOWN_SKILL_SOURCES = {
+    browserAutomation: [
+        { id: 'web-access', source: 'https://github.com/anthropics/claude-code/tree/main/skills/web-access', quality: 95, description: 'CDP browser automation' },
+        { id: 'playwright', source: 'https://github.com/microsoft/playwright', quality: 92, description: 'CLI browser automation' },
+        { id: 'cua', source: 'https://github.com/trycua/cua', quality: 90, description: 'Computer use agent' },
+    ],
+    uiDesign: [
+        { id: 'awesome-design-md', source: 'https://github.com/anthropics/anthropic-cookbook/tree/main/skills/awesome-design-md', quality: 88, description: 'Brand design specs' },
+        { id: 'ui-ux-pro-max', source: 'https://github.com/anthropics/claude-code/tree/main/skills/ui-ux-pro-max', quality: 85, description: 'UX guidelines database' },
+    ],
+    diagrams: [
+        { id: 'fireworks-tech-graph', source: 'https://github.com/yizhiyanhua-ai/fireworks-tech-graph', quality: 82, description: 'Tech flow diagrams' },
+        { id: 'architecture-diagram-generator', source: 'https://github.com/Cocoon-AI/architecture-diagram-generator', quality: 85, description: 'System architecture diagrams' },
+    ],
+    videoGeneration: [
+        { id: 'hyperframes', source: 'https://github.com/heygen-com/hyperframes', quality: 75, description: 'HeyGen video generation' },
+    ],
+    pptGeneration: [
+        { id: 'guizang-ppt-skill', source: 'https://github.com/op7418/guizang-ppt-skill', quality: 70, description: 'PPT auto generation' },
+    ],
+    knowledgeGraph: [
+        { id: 'graphify', source: 'https://github.com/anthropics/claude-code/tree/main/skills/graphify', quality: 90, description: 'Knowledge graph generator' },
+    ],
+    testing: [
+        { id: 'playwright-interactive', source: 'https://github.com/anthropics/claude-code/tree/main/skills/playwright-interactive', quality: 80, description: 'Persistent session UI debug' },
+    ],
+};
+// ============================================================================
 // Platform Skills Directory Map
 // ============================================================================
 const PLATFORM_SKILLS_DIRS = {
-    'claude-code': null, // Claude Code uses .claude/commands/, no dedicated skills dir
-    'codex': null, // Codex uses .codex/commands/
+    'claude-code': join(homedir(), '.claude', 'skills'),
+    'codex': join(homedir(), '.omx', 'skills'),
     'opencode': join(homedir(), '.config', 'opencode', 'skills'),
     'cursor': join('.cursor', 'skills'),
-    'gemini': null, // Gemini has no skills directory concept
-    'openclaw': null, // OpenClaw has no skills directory concept
-    'hermes': null, // Hermes has no skills directory concept
-    'trae': null, // Trae has no skills directory concept
-    'workbuddy': null, // WorkBuddy has no skills directory concept
-    'vsc': null, // VSC has no skills directory concept
-    'qcoder': null, // QCoder has no skills directory concept
+    'gemini': null,
+    'openclaw': null,
+    'hermes': null,
+    'trae': null,
+    'workbuddy': null,
+    'vsc': null,
+    'qcoder': null,
 };
-// ============================================================================
-// SkillDiscovery
-// ============================================================================
 export class SkillDiscovery {
-    projectDir;
-    constructor(projectDir = '.') {
-        this.projectDir = projectDir;
-    }
     /**
-     * Detect the active agent platform based on config files present in the project.
-     * Returns the most likely platform, or null if indeterminate.
+     * 构造函数支持两种模式：
+     * 1. 独立模式（仅 projectDir）：用于平台检测和技能扫描
+     * 2. 增强模式（完整参数）：用于 Agent 主动发现和推荐安装
      */
+    constructor(registryOrProjectDir, installer, eventBus, projectDir) {
+        // 判断是独立模式还是增强模式
+        if (typeof registryOrProjectDir === 'string') {
+            // 独立模式
+            this.registry = null;
+            this.installer = null;
+            this.eventBus = null;
+            this.projectDir = registryOrProjectDir;
+        }
+        else {
+            // 增强模式
+            this.registry = registryOrProjectDir;
+            this.installer = installer ?? null;
+            this.eventBus = eventBus ?? null;
+            this.projectDir = projectDir ?? '.';
+        }
+    }
+    // ========== 主动发现功能 ==========
+    async discover(context) {
+        // 独立模式下无法执行发现功能
+        if (!this.registry) {
+            console.warn('SkillDiscovery: registry not initialized, discover disabled');
+            return [];
+        }
+        const results = [];
+        const category = this.matchCategory(context.taskType, context.keywords);
+        if (!category)
+            return [];
+        const candidates = KNOWN_SKILL_SOURCES[category] || [];
+        for (const candidate of candidates) {
+            const registered = this.registry.get(candidate.id);
+            const relevance = this.calculateRelevance(context, candidate);
+            results.push({
+                skillId: candidate.id,
+                sourceUrl: candidate.source,
+                quality: candidate.quality,
+                relevance,
+                description: candidate.description,
+                alreadyInstalled: registered?.installed ?? false,
+                installConfig: !registered?.installed ? this.createInstallConfig(candidate) : undefined,
+            });
+        }
+        results.sort((a, b) => (b.quality * b.relevance) - (a.quality * a.relevance));
+        if (this.eventBus) {
+            this.eventBus.emit('skill.recommended', { context, recommendations: results.filter(r => !r.alreadyInstalled) });
+        }
+        return results;
+    }
+    async recommendInstall(context) {
+        if (!this.registry)
+            return [];
+        const discoveries = await this.discover(context);
+        return discoveries.filter(r => !r.alreadyInstalled && r.quality >= 80 && r.relevance >= 0.7 && r.installConfig)
+            .map(r => r.installConfig);
+    }
+    async periodicScan() {
+        if (!this.registry)
+            return [];
+        const allResults = [];
+        for (const category of Object.keys(KNOWN_SKILL_SOURCES)) {
+            for (const candidate of KNOWN_SKILL_SOURCES[category]) {
+                if (!this.registry.get(candidate.id)) {
+                    allResults.push({
+                        skillId: candidate.id,
+                        sourceUrl: candidate.source,
+                        quality: candidate.quality,
+                        relevance: 1.0,
+                        description: candidate.description,
+                        alreadyInstalled: false,
+                        installConfig: this.createInstallConfig(candidate),
+                    });
+                }
+            }
+        }
+        return allResults;
+    }
+    async checkDuringExecution(taskType, capabilities) {
+        if (!this.registry)
+            return [];
+        const missing = this.detectMissingCapabilities(capabilities);
+        if (missing.length === 0)
+            return [];
+        return this.discover({ taskType, missingCapabilities: missing, phase: 'execute', keywords: missing });
+    }
+    // ========== 原有平台扫描功能 ==========
     detectPlatform() {
         const checks = [
             { platform: 'claude-code', paths: [join(this.projectDir, '.claude', 'settings.json')] },
@@ -47,102 +156,34 @@ export class SkillDiscovery {
             { platform: 'qcoder', paths: [join(this.projectDir, '.qwen', 'settings.json')] },
         ];
         for (const check of checks) {
-            if (check.paths.some((p) => existsSync(p))) {
+            if (check.paths.some(p => existsSync(p)))
                 return check.platform;
-            }
         }
         return null;
     }
-    /**
-     * Scan the skills directory for a given platform.
-     * Returns structured skill references.
-     */
     scanSkills(platform) {
         const skillsDir = PLATFORM_SKILLS_DIRS[platform];
-        if (!skillsDir) {
-            return {
-                platform,
-                skillsDir: '',
-                skills: [],
-                exists: false,
-            };
-        }
-        const resolvedDir = platform === 'opencode'
-            ? skillsDir
-            : join(this.projectDir, skillsDir);
-        if (!existsSync(resolvedDir)) {
-            return {
-                platform,
-                skillsDir: resolvedDir,
-                skills: [],
-                exists: false,
-            };
-        }
+        if (!skillsDir)
+            return { platform, skillsDir: '', skills: [], exists: false };
+        const resolvedDir = platform === 'opencode' ? skillsDir : join(this.projectDir, skillsDir);
+        if (!existsSync(resolvedDir))
+            return { platform, skillsDir: resolvedDir, skills: [], exists: false };
         const skills = [];
         try {
-            const entries = readdirSync(resolvedDir);
-            for (const entry of entries) {
+            for (const entry of readdirSync(resolvedDir)) {
                 const entryPath = join(resolvedDir, entry);
                 const stat = statSync(entryPath);
-                if (stat.isFile() && (entry.endsWith('.md') || entry.endsWith('.json') || entry.endsWith('.yaml') || entry.endsWith('.yml'))) {
-                    const name = entry.replace(/\.(md|json|ya?ml)$/, '');
-                    let description = '';
-                    // Try to extract description from file content
-                    try {
-                        const content = readFileSync(entryPath, 'utf-8');
-                        // Extract first line as description for .md files
-                        if (entry.endsWith('.md')) {
-                            const firstLine = content.split('\n').find((l) => l.trim().length > 0) ?? '';
-                            description = firstLine.replace(/^#+\s*/, '').trim();
-                        }
-                        else if (entry.endsWith('.json')) {
-                            const parsed = JSON.parse(content);
-                            description = parsed.description ?? parsed.name ?? '';
-                        }
-                    }
-                    catch {
-                        description = '';
-                    }
-                    skills.push({
-                        id: `${platform}-${name}`,
-                        name,
-                        description,
-                        platform,
-                        path: entryPath,
-                        enabled: true,
-                    });
-                }
-                else if (stat.isDirectory()) {
-                    // Directory-based skills
-                    skills.push({
-                        id: `${platform}-${entry}`,
-                        name: entry,
-                        description: '',
-                        platform,
-                        path: entryPath,
-                        enabled: true,
-                    });
+                if (stat.isDirectory()) {
+                    skills.push({ id: `${platform}-${entry}`, name: entry, description: '', platform, path: entryPath, enabled: true });
                 }
             }
         }
-        catch {
-            // Permission or read error
-        }
-        return {
-            platform,
-            skillsDir: resolvedDir,
-            skills,
-            exists: true,
-        };
+        catch { /* Permission error */ }
+        return { platform, skillsDir: resolvedDir, skills, exists: true };
     }
-    /**
-     * Generate a skills.md document from discovered skills.
-     * Useful for injecting into agent knowledge docs.
-     */
     generateSkillsMd(skills) {
-        if (skills.length === 0) {
+        if (skills.length === 0)
             return '## Available Skills\n\nNo skills discovered.\n';
-        }
         const grouped = new Map();
         for (const skill of skills) {
             const group = grouped.get(skill.platform) ?? [];
@@ -151,29 +192,72 @@ export class SkillDiscovery {
         }
         const sections = ['## Available Skills\n'];
         for (const [platform, platformSkills] of grouped) {
-            sections.push(`### ${platform}`);
-            sections.push('');
+            sections.push(`### ${platform}\n`);
             for (const skill of platformSkills) {
                 const desc = skill.description ? ` — ${skill.description}` : '';
-                const status = skill.enabled ? '✅' : '❌';
-                sections.push(`- ${status} **${skill.name}**${desc}`);
+                sections.push(`- ✅ **${skill.name}**${desc}`);
             }
             sections.push('');
         }
         return sections.join('\n');
     }
-    /**
-     * Full discovery pipeline: detect platform → scan → generate doc.
-     */
-    discover() {
-        const platform = this.detectPlatform();
-        let skills = [];
-        if (platform) {
-            const result = this.scanSkills(platform);
-            skills = result.skills;
+    // ========== Private Methods ==========
+    matchCategory(taskType, keywords) {
+        const typeToCategory = {
+            'web-scraping': 'browserAutomation', 'e2e-testing': 'testing', 'ui-design': 'uiDesign',
+            'diagram': 'diagrams', 'video-generation': 'videoGeneration', 'ppt-generation': 'pptGeneration',
+            'knowledge-graph': 'knowledgeGraph',
+        };
+        if (typeToCategory[taskType])
+            return typeToCategory[taskType];
+        for (const kw of keywords) {
+            if (kw.includes('browser'))
+                return 'browserAutomation';
+            if (kw.includes('design'))
+                return 'uiDesign';
+            if (kw.includes('diagram'))
+                return 'diagrams';
+            if (kw.includes('test'))
+                return 'testing';
         }
-        const skillsMd = this.generateSkillsMd(skills);
-        return { platform, skills, skillsMd };
+        return null;
+    }
+    calculateRelevance(ctx, candidate) {
+        const descLower = candidate.description.toLowerCase();
+        let matchCount = 0;
+        for (const kw of ctx.keywords)
+            if (descLower.includes(kw.toLowerCase()))
+                matchCount++;
+        for (const cap of ctx.missingCapabilities)
+            if (descLower.includes(cap.toLowerCase()))
+                matchCount++;
+        const total = ctx.keywords.length + ctx.missingCapabilities.length;
+        return total > 0 ? matchCount / total : 0.5;
+    }
+    detectMissingCapabilities(capabilities) {
+        if (!this.registry)
+            return capabilities; // 无 registry 时返回全部
+        const missing = [];
+        const allSkills = this.registry.listAll();
+        for (const cap of capabilities) {
+            const hasIt = allSkills.some(s => s.installed && (s.id.includes(cap) || s.description.toLowerCase().includes(cap)));
+            if (!hasIt)
+                missing.push(cap);
+        }
+        return missing;
+    }
+    createInstallConfig(candidate) {
+        const method = candidate.source.includes('github') ? 'git-clone' : 'manual';
+        const command = method === 'git-clone'
+            ? `git clone ${candidate.source} ~/.claude/skills/${candidate.id}`
+            : `create ~/.claude/skills/${candidate.id}/SKILL.md`;
+        return {
+            skillId: candidate.id,
+            method,
+            sourceUrl: candidate.source,
+            command,
+            verification: `test -f ~/.claude/skills/${candidate.id}/SKILL.md`,
+        };
     }
 }
 //# sourceMappingURL=SkillDiscovery.js.map