@hongmaple0820/med-scale-research-os 0.43.0

package/dist/skills/SkillRegistry.js

@@ -0,0 +1,161 @@
+// SCALE Engine — Skill Registry (v0.7.0)
+// 技能注册表：存储、查询、推荐技能
+import { logger } from '../core/logger.js';
+// ============================================================================
+// SkillRegistry Implementation
+// ============================================================================
+export class SkillRegistry {
+    constructor(eventBus) {
+        this.skills = new Map();
+        this.eventBus = eventBus;
+    }
+    register(skill) {
+        if (!skill.id || !skill.name || !skill.execution) {
+            throw new Error('Invalid skill definition: missing required fields');
+        }
+        if (this.skills.has(skill.id) && !skill.installed) {
+            logger.warn({ skillId: skill.id }, 'Skill already registered, skipping');
+            return;
+        }
+        this.skills.set(skill.id, skill);
+        this.eventBus.emit('skill.registered', { skillId: skill.id, domain: skill.domain, installed: skill.installed });
+        logger.info({ skillId: skill.id, domain: skill.domain }, 'Skill registered');
+    }
+    unregister(skillId) {
+        const skill = this.skills.get(skillId);
+        if (!skill)
+            return;
+        this.skills.delete(skillId);
+        this.eventBus.emit('skill.unregistered', { skillId });
+        logger.info({ skillId }, 'Skill unregistered');
+    }
+    get(skillId) {
+        return this.skills.get(skillId);
+    }
+    listAll(domain) {
+        const all = [...this.skills.values()];
+        if (domain)
+            return all.filter(s => s.domain === domain);
+        return all.sort((a, b) => b.priority - a.priority);
+    }
+    listInstalled() {
+        return [...this.skills.values()].filter(s => s.installed).sort((a, b) => b.priority - a.priority);
+    }
+    recommend(context) {
+        const candidates = [];
+        for (const skill of this.skills.values()) {
+            if (!skill.installed)
+                continue;
+            const { matched, score } = this.evaluateTriggers(skill, context);
+            if (matched.length > 0 && score > 0.3) {
+                const priority = this.calculatePriority(skill, score, context);
+                candidates.push({
+                    skillId: skill.id, priority, reason: this.generateReason(skill, matched),
+                    triggeredBy: matched, executionType: skill.execution.type,
+                });
+            }
+        }
+        return candidates.sort((a, b) => b.priority - a.priority).slice(0, 5);
+    }
+    evaluateTriggers(skill, context) {
+        const matched = [];
+        let totalWeight = 0, matchedWeight = 0;
+        for (const trigger of skill.triggers) {
+            totalWeight += trigger.weight;
+            if (this.matchesTrigger(trigger, context)) {
+                matched.push(trigger);
+                matchedWeight += trigger.weight;
+            }
+        }
+        return { matched, score: totalWeight > 0 ? matchedWeight / totalWeight : 0 };
+    }
+    setInstalled(skillId, installed) {
+        const skill = this.skills.get(skillId);
+        if (!skill)
+            return;
+        skill.installed = installed;
+        skill.installedAt = installed ? Date.now() : undefined;
+        this.eventBus.emit('skill.installation_changed', { skillId, installed });
+    }
+    getDependencies(skillId) {
+        const skill = this.skills.get(skillId);
+        if (!skill?.prerequisites)
+            return [];
+        return skill.prerequisites.map(id => this.skills.get(id)).filter(Boolean);
+    }
+    checkConflicts(skillId) {
+        const skill = this.skills.get(skillId);
+        if (!skill?.conflicts)
+            return [];
+        return skill.conflicts.filter(id => this.skills.get(id)?.installed);
+    }
+    matchesTrigger(trigger, context) {
+        switch (trigger.type) {
+            case 'taskType':
+                return context.taskType === trigger.value || (Array.isArray(trigger.value) && trigger.value.includes(context.taskType ?? ''));
+            case 'phase': return context.phase === trigger.value;
+            case 'detectorTriggered':
+                return context.detectorTriggered === trigger.value || (Array.isArray(trigger.value) && trigger.value.includes(context.detectorTriggered ?? ''));
+            case 'complexity': return context.complexity === trigger.value;
+            case 'keyword':
+                if (!context.keywords)
+                    return false;
+                const triggerKeywords = Array.isArray(trigger.value) ? trigger.value : [trigger.value];
+                return triggerKeywords.some(k => context.keywords.some(ck => ck.toLowerCase().includes(k.toLowerCase())));
+            case 'manual': return false;
+            default: return false;
+        }
+    }
+    calculatePriority(skill, triggerScore, context) {
+        let priority = skill.priority + triggerScore * 30;
+        if (context.complexity === 'complex' && skill.domain === 'planning')
+            priority += 10;
+        if (context.phase === 'verify' && skill.domain === 'verification')
+            priority += 15;
+        if (context.phase === 'implement' && skill.domain === 'execution')
+            priority += 15;
+        if (context.detectorTriggered && skill.domain === 'verification')
+            priority += 20;
+        return Math.min(100, Math.max(0, priority));
+    }
+    generateReason(skill, matched) {
+        const triggerNames = matched.map(t => t.type).join(', ');
+        return matched.length === 1 ? `${skill.name} 触发条件匹配: ${triggerNames}` : `${skill.name} 多条件匹配: ${triggerNames} (${matched.length} 个触发器)`;
+    }
+    registerBatch(skills) { for (const skill of skills)
+        this.register(skill); }
+    /** Register a domain-specific skill (site-level selectors/flows) */
+    registerDomainSkill(domain, skill) {
+        const hash = Buffer.from(domain).toString('hex').slice(0, 16);
+        this.skills.set(`domain:${hash}`, {
+            id: `domain:${hash}`,
+            name: `Site skill for ${domain}`,
+            description: `Domain-specific selectors and flows for ${domain}`,
+            domain: 'domain',
+            triggers: [],
+            execution: {
+                type: 'builtin-function',
+                config: {
+                    functionName: 'applyDomainSkill',
+                    parameters: skill,
+                },
+            },
+            priority: 60,
+            installed: true,
+        });
+    }
+    clear() { this.skills.clear(); this.eventBus.emit('skills.cleared', { clearedAt: Date.now() }); }
+    async loadFromFrontmatter(dir) {
+        const { scanFrontmatterSkills } = await import('./SkillFrontmatter.js');
+        const scanned = scanFrontmatterSkills(dir);
+        let count = 0;
+        for (const { definition } of scanned) {
+            if (!this.skills.has(definition.id)) {
+                this.register(definition);
+                count++;
+            }
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=SkillRegistry.js.map

package/dist/skills/SkillRegistry.js.map

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

package/dist/skills/SkillRepository.d.ts

@@ -0,0 +1,71 @@
+export type SkillRepositoryCategory = 'planning' | 'memory' | 'ui' | 'browser' | 'desktop' | 'testing' | 'review' | 'docs' | 'agent-cli' | 'role-library' | 'discovery';
+export type SkillRepositoryTrust = 'official' | 'ecosystem' | 'community';
+export type SkillSafetyRisk = 'low' | 'medium' | 'high' | 'blocked';
+export interface SkillRepositoryEntry {
+    id: string;
+    name: string;
+    category: SkillRepositoryCategory;
+    description: string;
+    sourceUrl: string;
+    installCommand: string;
+    trust: SkillRepositoryTrust;
+    progressiveDisclosure: {
+        startup: string;
+        activation: string;
+        lazyResources: string[];
+    };
+    orchestration: {
+        primaryUse: string;
+        combineWith: string[];
+        requiredEvidence: string[];
+    };
+    safety: {
+        requiresReview: boolean;
+        requiredChecks: string[];
+    };
+    attribution: {
+        license: string;
+        copyright: string;
+        notice: string;
+        usage: 'external-reference' | 'optional-install' | 'adapted-concept' | 'vendored';
+        sourceRevision?: string;
+        modifiedFromUpstream: boolean;
+    };
+}
+export interface SkillWorkflowRecommendationInput {
+    description: string;
+    phase?: string;
+}
+export interface SkillWorkflowRecommendation {
+    primarySkills: string[];
+    supportingSkills: string[];
+    safetyRequired: boolean;
+    requiredEvidence: string[];
+    rationale: string[];
+}
+export interface SkillInstallSafetyInput {
+    sourceUrl?: string;
+    installCommand?: string;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export interface SkillSafetyFinding {
+    rule: string;
+    severity: 'warn' | 'block';
+    message: string;
+}
+export interface SkillInstallSafetyReport {
+    blocked: boolean;
+    risk: SkillSafetyRisk;
+    findings: SkillSafetyFinding[];
+    requiredChecks: string[];
+}
+export declare const SKILL_REPOSITORY: SkillRepositoryEntry[];
+export declare function listSkillRepositoryEntries(filter?: {
+    category?: SkillRepositoryCategory;
+}): SkillRepositoryEntry[];
+export declare function recommendSkillWorkflow(input: SkillWorkflowRecommendationInput): SkillWorkflowRecommendation;
+export declare function evaluateSkillInstallSafety(input: SkillInstallSafetyInput): SkillInstallSafetyReport;
+export declare function renderSkillRepositoryMarkdown(): string;