skill-os 0.1.2 → 0.1.5

package/lib/sync.js

@@ -0,0 +1,190 @@
+/**
+ * 本地索引同步命令
+ *
+ * 扫描 skills/ 目录下所有包含 SKILL.md 的技能目录，
+ * 解析 frontmatter 元数据，生成 SKILL_INDEX.json。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+const {
+    getRepoRoot,
+    parseSkillMdFrontmatter,
+    skillSchema,
+    validateDirectoryStructure,
+    Validator,
+} = require('./utils');
+
+/**
+ * 递归扫描目录，找到所有包含 SKILL.md 的叶子目录
+ * @param {string} dir - 当前扫描的目录
+ * @returns {string[]} - 包含 SKILL.md 的目录绝对路径列表
+ */
+function findSkillDirs(dir) {
+    const results = [];
+    if (!fs.existsSync(dir)) return results;
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+    // 如果当前目录包含 SKILL.md，则视为技能目录
+    const hasSkillMd = entries.some(e => e.isFile() && e.name === 'SKILL.md');
+    if (hasSkillMd) {
+        results.push(dir);
+        return results; // 不再深入子目录
+    }
+
+    // 递归扫描子目录
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            results.push(...findSkillDirs(path.join(dir, entry.name)));
+        }
+    }
+
+    return results;
+}
+
+/**
+ * 从目录路径提取相对于 skills/ 的技能路径
+ * 例如：/repo/skills/system/security/selinux-manager → system/security/selinux-manager
+ */
+function extractSkillPath(skillDir, skillsRoot) {
+    return path.relative(skillsRoot, skillDir).split(path.sep).join('/');
+}
+
+/**
+ * skill-os sync 命令实现
+ */
+function cmdSync() {
+    const repoRoot = getRepoRoot();
+    const skillsDir = path.join(repoRoot, 'skills');
+    const indexPath = path.join(repoRoot, 'SKILL_INDEX.json');
+
+    console.log(`\n${chalk.bold('🔄 Syncing skills index...')}`);
+    console.log(`${chalk.dim(`Repository: ${repoRoot}`)}`);
+    console.log(`${chalk.dim(`Skills dir: ${skillsDir}`)}`);
+    console.log(`${chalk.dim('─'.repeat(50))}\n`);
+
+    if (!fs.existsSync(skillsDir)) {
+        console.error(chalk.red('Error: skills/ directory not found'));
+        process.exit(1);
+    }
+
+    // 1. 加载旧索引（用于对比）
+    let oldSkills = {};
+    if (fs.existsSync(indexPath)) {
+        try {
+            const old = JSON.parse(fs.readFileSync(indexPath, 'utf-8'));
+            oldSkills = old.skills || {};
+        } catch (e) {
+            // 忽略解析错误
+        }
+    }
+
+    // 2. 扫描所有技能目录
+    const skillDirs = findSkillDirs(skillsDir);
+    const newSkills = {};
+    const errors = [];
+    let validCount = 0;
+    let skippedCount = 0;
+
+    for (const skillDir of skillDirs) {
+        const skillPath = extractSkillPath(skillDir, skillsDir);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+
+        // 解析 frontmatter
+        const fm = parseSkillMdFrontmatter(skillMdPath);
+
+        if (!fm || !fm.name) {
+            errors.push({ path: skillPath, error: 'Missing or invalid frontmatter (no "name" field)' });
+            skippedCount++;
+            continue;
+        }
+
+        // 基础校验
+        const v = new Validator();
+        const result = v.validate(fm, skillSchema);
+
+        if (!result.valid) {
+            const msgs = result.errors.map(e => e.stack.replace('instance.', '')).join('; ');
+            errors.push({ path: skillPath, error: msgs });
+            skippedCount++;
+            continue;
+        }
+
+        // 构建索引条目
+        newSkills[skillPath] = {
+            name: fm.name,
+            version: String(fm.version || '0.1.0'),
+            description: fm.description || '',
+            status: fm.status || 'stable',
+            layer: fm.layer || skillPath.split('/')[0],
+            lifecycle: fm.lifecycle || 'usage',
+            category: fm.category || (skillPath.split('/').length >= 2 ? skillPath.split('/')[1] : ''),
+            tags: fm.tags || [],
+            dependencies: fm.dependencies || [],
+        };
+
+        if (fm.author) {
+            newSkills[skillPath].author = fm.author;
+        }
+
+        validCount++;
+    }
+
+    // 3. 计算变更统计
+    const oldKeys = new Set(Object.keys(oldSkills));
+    const newKeys = new Set(Object.keys(newSkills));
+
+    const added = [...newKeys].filter(k => !oldKeys.has(k));
+    const removed = [...oldKeys].filter(k => !newKeys.has(k));
+    const updated = [...newKeys].filter(k => oldKeys.has(k) &&
+        JSON.stringify(newSkills[k]) !== JSON.stringify(oldSkills[k]));
+
+    // 4. 写入索引
+    const indexData = {
+        version: '3.0',
+        repository: 'https://code.alibaba-inc.com/os-copilot/skill-os',
+        skills: newSkills,
+        generated_at: new Date().toISOString(),
+    };
+
+    fs.writeFileSync(indexPath, JSON.stringify(indexData, null, 2) + '\n', 'utf-8');
+
+    // 5. 输出结果
+    if (added.length > 0) {
+        console.log(chalk.green(`  + ${added.length} new skill(s):`));
+        added.forEach(p => console.log(chalk.green(`    + ${p}`)));
+    }
+
+    if (updated.length > 0) {
+        console.log(chalk.yellow(`  ~ ${updated.length} updated skill(s):`));
+        updated.forEach(p => console.log(chalk.yellow(`    ~ ${p}`)));
+    }
+
+    if (removed.length > 0) {
+        console.log(chalk.red(`  - ${removed.length} removed skill(s):`));
+        removed.forEach(p => console.log(chalk.red(`    - ${p}`)));
+    }
+
+    if (added.length === 0 && updated.length === 0 && removed.length === 0) {
+        console.log(chalk.dim('  No changes detected.'));
+    }
+
+    if (errors.length > 0) {
+        console.log(`\n${chalk.yellow(`⚠ ${errors.length} skill(s) skipped due to errors:`)}`);
+        errors.forEach(({ path: p, error }) => {
+            console.log(chalk.yellow(`  ✗ ${p}: ${error}`));
+        });
+    }
+
+    console.log(`\n${chalk.bold('📊 Summary:')}`);
+    console.log(`  Total scanned: ${chalk.cyan(skillDirs.length)}`);
+    console.log(`  Valid:         ${chalk.green(validCount)}`);
+    console.log(`  Skipped:       ${skippedCount > 0 ? chalk.yellow(skippedCount) : chalk.dim(skippedCount)}`);
+    console.log(`  Index written:  ${chalk.cyan(indexPath)}`);
+    console.log(`\n${chalk.green('✅ Sync complete!')}\n`);
+}
+
+module.exports = { cmdSync };

package/lib/utils.js

@@ -0,0 +1,139 @@
+/**
+ * 共享工具函数
+ *
+ * 提供 CLI 全局使用的辅助函数：图标映射、颜色格式化、仓库定位、
+ * SKILL.md 解析、Schema 校验等。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const yaml = require('js-yaml');
+const { Validator } = require('jsonschema');
+
+// ── 图标映射 ────────────────────────────────────────────────────────────
+
+const layerIcons = {
+    core: "🧠",
+    system: "🔧",
+    runtime: "📦",
+    application: "🚀",
+    cloud: "☁️",
+    package: "📦",
+    network: "🌐",
+    storage: "💾",
+    user: "👤",
+    meta: "🛠️",
+};
+
+function formatLayerIcon(skillPath) {
+    const layer = skillPath.split("/")[0];
+    return layerIcons[layer] || "📄";
+}
+
+function formatStatus(status) {
+    switch (status?.toLowerCase()) {
+        case 'stable': return chalk.green('git');
+        case 'upload': return chalk.cyan('upload');
+        default: return status || 'git';
+    }
+}
+
+// ── 仓库定位 ────────────────────────────────────────────────────────────
+
+function getRepoRoot() {
+    let current = path.resolve(path.dirname(__dirname)); // cli/ 所在的父目录
+    if (fs.existsSync(path.join(current, 'SKILL_INDEX.json'))) {
+        return current;
+    }
+
+    if (fs.existsSync(path.join(process.cwd(), 'SKILL_INDEX.json'))) {
+        return process.cwd();
+    }
+    return current;
+}
+
+function loadIndex() {
+    const repoRoot = getRepoRoot();
+    const indexPath = path.join(repoRoot, 'SKILL_INDEX.json');
+
+    if (!fs.existsSync(indexPath)) {
+        console.error(chalk.red('Error: SKILL_INDEX.json not found'));
+        process.exit(1);
+    }
+
+    const raw = fs.readFileSync(indexPath, 'utf-8');
+    return JSON.parse(raw);
+}
+
+// ── SKILL.md 解析 ───────────────────────────────────────────────────────
+
+function parseSkillMdFrontmatter(skillMdPath) {
+    if (!fs.existsSync(skillMdPath)) return {};
+    const content = fs.readFileSync(skillMdPath, 'utf8');
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match) return {};
+
+    try {
+        return yaml.load(match[1]) || {};
+    } catch (e) {
+        return {};
+    }
+}
+
+// ── Schema & 校验 ───────────────────────────────────────────────────────
+
+const skillSchema = {
+    id: "/SkillMetadata",
+    type: "object",
+    properties: {
+        name: { type: "string", minLength: 1 },
+        version: { type: ["string", "number"] },
+        description: { type: "string" },
+        layer: { enum: ["core", "system", "runtime", "application"] },
+        lifecycle: { enum: ["production", "maintenance", "operations", "usage", "meta"] },
+        category: { type: ["string", "null"] },
+        tags: { type: "array", items: { type: "string" } },
+        status: { enum: ["stable", "beta", "placeholder", "upload"] },
+        dependencies: { type: "array", items: { type: "string" } },
+        permissions: {
+            type: "object",
+            properties: {
+                requires_root: { type: "boolean" },
+                dangerous_operations: { type: "array", items: { type: "string" } }
+            }
+        }
+    },
+    required: ["name", "version", "layer", "lifecycle"]
+};
+
+function validateDirectoryStructure(skillDir) {
+    const errors = [];
+    if (!fs.existsSync(skillDir)) {
+        return { isValid: false, errors: ["Directory does not exist"] };
+    }
+
+    const skillMd = path.join(skillDir, 'SKILL.md');
+    if (!fs.existsSync(skillMd)) {
+        errors.push("Missing SKILL.md file");
+    } else {
+        const content = fs.readFileSync(skillMd, 'utf8');
+        if (!content.includes('---')) {
+            errors.push("SKILL.md missing frontmatter");
+        }
+    }
+
+    return { isValid: errors.length === 0, errors };
+}
+
+module.exports = {
+    layerIcons,
+    formatLayerIcon,
+    formatStatus,
+    getRepoRoot,
+    loadIndex,
+    parseSkillMdFrontmatter,
+    skillSchema,
+    validateDirectoryStructure,
+    Validator,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-os",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Skill-OS CLI for managing OS skills",
   "main": "skill-os.js",
   "bin": {
@@ -18,7 +18,7 @@
   "license": "MIT",
   "dependencies": {
     "chalk": "^4.1.2",
-    "commander": "^13.1.0",
+    "commander": "^11.1.0",
     "form-data": "^4.0.5",
     "js-yaml": "^4.1.0",
     "jsonschema": "^1.4.1",