skill-os 0.1.3 → 0.1.6

package/skill-os.js

@@ -1,667 +1,216 @@
 #!/usr/bin/env node
 
-const { program } = require('commander');
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-const chalk = require('chalk');
-const { execSync } = require('child_process');
-
-// Define specific layer icons matching original python CLI
-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(status);
-        case 'beta': return chalk.yellow(status);
-        case 'placeholder': return chalk.dim(status);
-        default: return status || 'unknown';
-    }
-}
-
-function getRepoRoot() {
-    let current = path.dirname(__dirname); // Usually cli is in the repo root
-    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);
-}
-
-// ----------------------------------------------------------------------
-// API Configuration
-// ----------------------------------------------------------------------
-
-const DEFAULT_API_BASE = "https://oscopilot.alibaba-inc.com/skills/api/v1";
-
-function getApiBase(options) {
-    let url = options?.url || process.env.SKILL_OS_REGISTRY || DEFAULT_API_BASE;
-    return url.replace(/\/$/, "");
-}
-
-async function fetchFromApi(endpoint, options = {}) {
-    // Only require node-fetch dynamically when needed
-    let fetchFn = require('node-fetch');
-    if (typeof fetchFn !== 'function' && fetchFn.default) {
-        fetchFn = fetchFn.default;
-    }
-
-    let baseUrl;
-    // Extract url option if passed inside options object
-    if (options && options.url) {
-        baseUrl = getApiBase({ url: options.url });
-        delete options.url;
-    } else {
-        baseUrl = getApiBase({});
-    }
-
-    const url = `${baseUrl}${endpoint}`;
+/**
+ * Skill-OS CLI — 入口文件
+ *
+ * 负责 commander 命令注册，业务逻辑拆分在 lib/ 下：
+ *   lib/utils.js   — 共享工具
+ *   lib/config.js  — API 配置 & 凭据
+ *   lib/local.js   — 本地命令 (create, validate)
+ *   lib/remote.js  — 远程命令 (list, search, info, download, upload)
+ *   lib/auth.js    — 认证命令 (login, logout)
+ */
 
-    try {
-        const response = await fetchFn(url, options);
-        if (!response.ok) {
-            throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
-        }
-        return await response.json();
-    } catch (error) {
-        console.error(chalk.red(`\n✗ Error connecting to remote registry at ${url}`));
-        console.error(chalk.dim(error.message));
-        process.exit(1);
-    }
-}
-
-// ----------------------------------------------------------------------
-// Commmands Implementations
-// ----------------------------------------------------------------------
-
-async function cmdList(options) {
-    console.log(`\n${chalk.dim('Fetching skills from external registry...')}`);
-    const index = await fetchFromApi('/skills', options);
-
-    // API returns an array of skills, or an object with a data/skills array property
-    let skillsList = [];
-    if (Array.isArray(index)) {
-        skillsList = index;
-    } else if (Array.isArray(index.data)) {
-        skillsList = index.data;
-    } else if (Array.isArray(index.skills)) {
-        skillsList = index.skills;
-    } else if (typeof index === 'object') {
-        // Fallback if it is an object map
-        skillsList = Object.entries(index.skills || index).map(([k, v]) => ({ path: k, ...v }));
-    }
-
-    console.log(`\n${chalk.bold('📚 Skill-OS Available Skills')}`);
-    console.log(`${chalk.dim('─'.repeat(60))}\n`);
-
-    const layers = {};
-    for (const info of skillsList) {
-        // Fallback path resolution. If the API returns 'path', use it. Otherwise, construct it or use name.
-        const skillPath = info.path || (info.layer ? `${info.layer}/${info.category || 'misc'}/${info.name}` : info.name || 'unknown');
-        const layer = info.layer || (skillPath.includes('/') ? skillPath.split('/')[0] : 'misc');
-
-        if (!layers[layer]) layers[layer] = [];
-        layers[layer].push({ path: skillPath, info });
-    }
-
-    for (const layer of Object.keys(layers).sort()) {
-        const icon = layerIcons[layer] || "📄";
-        console.log(`${chalk.bold(icon + ' ' + layer.toUpperCase())}`);
-
-        const sortedSkills = layers[layer].sort((a, b) => a.path.localeCompare(b.path));
-
-        for (const { path: skillPath, info } of sortedSkills) {
-            const status = formatStatus(info.status);
-            const name = info.name || skillPath;
-            const version = info.version || '?';
-            const desc = (info.description || '').substring(0, 50);
-
-            console.log(`  ${chalk.cyan(skillPath)}`);
-            console.log(`    ${name} (${version}) [${status}]`);
-            console.log(`    ${chalk.dim(desc + '...')}`);
-        }
-        console.log();
-    }
-}
-
-async function cmdSearch(query, options) {
-    console.log(`\n${chalk.dim(`Searching remote registry for '${query}'...`)}`);
-
-    // API Endpoint: /api/v1/search?q={{skill.name}}
-    const encodedQuery = encodeURIComponent(query);
-    const response = await fetchFromApi(`/search?q=${encodedQuery}`, options);
+const { program } = require('commander');
 
-    // The API likely returns an array or an object map. Normalize to an array of objects.
-    let matches = [];
-    const rawResults = response.data || response.results || response.skills || response || [];
+const { DEFAULT_API_BASE, DEFAULT_DAILY_API_BASE } = require('./lib/config');
+const { cmdCreate, cmdValidate } = require('./lib/local');
+const { cmdSync } = require('./lib/sync');
+const { cmdList, cmdSearch, cmdInfo, cmdDownload, cmdUpload } = require('./lib/remote');
+const { cmdLogin, cmdLogout } = require('./lib/auth');
 
-    if (Array.isArray(rawResults)) {
-        matches = rawResults;
-    } else if (typeof rawResults === 'object') {
-        for (const [skillPath, info] of Object.entries(rawResults)) {
-            matches.push({ path: skillPath, ...info });
-        }
-    }
+// ── 版本 & 描述 ──────────────────────────────────────────────────────────
 
-    if (matches.length === 0) {
-        console.log(chalk.yellow(`No skills found matching '${query}'`));
-        return;
-    }
+program
+    .name('skill-os')
+    .description('Skill-OS CLI — AI-Native OS 技能管理平台')
+    .version('0.1.4');
 
-    console.log(`\n${chalk.bold(`🔍 Search Results for '${query}'`)}`);
-    console.log(`${chalk.dim(`Found ${matches.length} skill(s)`)}\n`);
+// ══════════════════════════════════════════════════════════════════════════
+//  认证命令
+// ══════════════════════════════════════════════════════════════════════════
 
-    for (const info of matches) {
-        const skillPath = info.path || info.name; // Fallback to name if path isn't provided separately
-        const icon = formatLayerIcon(skillPath);
-        const status = formatStatus(info.status);
-        const version = info.version || '?';
-        const desc = info.description || '';
+program.command('login')
+    .description('登录 Skill-OS 注册中心（通过浏览器 BUC SSO 认证）')
+    .option('--url <url>', '指定服务端地址', DEFAULT_DAILY_API_BASE)
+    .action(cmdLogin);
 
-        console.log(`${icon} ${chalk.cyan(skillPath)}`);
-        console.log(`   ${chalk.bold(info.name)} (${version}) [${status}]`);
-        console.log(`   ${desc}\n`);
-    }
-}
+program.command('logout')
+    .description('注销登录，清除本地凭据')
+    .option('--url <url>', '指定服务端地址', DEFAULT_DAILY_API_BASE)
+    .action(cmdLogout);
 
-async function cmdInfo(skillPath, options) {
-    console.log(`\n${chalk.dim(`Fetching details from remote registry...`)}`);
+// ══════════════════════════════════════════════════════════════════════════
+//  远程注册中心命令 (Remote)
+// ══════════════════════════════════════════════════════════════════════════
 
-    // API Endpoint: /api/v1/skills/{{skill.path}}/content
-    const info = await fetchFromApi(`/skills/${skillPath}/content`, options);
+program.command('list')
+    .alias('ls')
+    .description('列出注册中心中所有可用的技能')
+    .addOption(
+        new (require('commander').Option)('--url <url>', '指定注册中心地址')
+            .default(DEFAULT_DAILY_API_BASE).hideHelp()
+    )
+    .action(cmdList);
 
-    const icon = formatLayerIcon(skillPath);
-    const status = formatStatus(info.status || info.metadata?.status);
-    const metadata = info.metadata || info || {}; // Handle if nested or flat
+program.command('search')
+    .alias('s')
+    .description('在注册中心中搜索技能')
+    .argument('<关键词>', '搜索关键词，如 firewall、rpm')
+    .addOption(
+        new (require('commander').Option)('--url <url>', '指定注册中心地址')
+            .default(DEFAULT_API_BASE).hideHelp()
+    )
+    .action(cmdSearch);
 
-    console.log(`\n${icon} ${chalk.bold(metadata.name || skillPath)}`);
-    console.log(chalk.dim('─'.repeat(40)));
-    console.log(`  Path:         ${chalk.cyan(skillPath)}`);
-    console.log(`  Version:      ${metadata.version || 'unknown'}`);
-    console.log(`  Status:       ${status}`);
-    console.log(`  Description:  ${metadata.description || 'No description'}`);
+program.command('info')
+    .alias('i')
+    .description('查看远程技能的详细信息')
+    .argument('<技能路径>', '技能路径，如 system/network/firewall')
+    .addOption(
+        new (require('commander').Option)('--url <url>', '指定注册中心地址')
+            .default(DEFAULT_API_BASE).hideHelp()
+    )
+    .action(cmdInfo);
 
-    if (metadata.dependencies && metadata.dependencies.length > 0) {
-        console.log(`  Dependencies: ${metadata.dependencies.join(', ')}`);
-    } else {
-        console.log(`  Dependencies: ${chalk.dim('None')}`);
-    }
+program.command('download')
+    .alias('dl')
+    .description('从注册中心下载技能包并解压')
+    .argument('<技能路径>', '要下载的技能路径，如 core/kernel/kernel-info')
+    .option('-t, --target <目录>', '指定解压目录（默认为当前目录）')
+    .option('--platform <平台>', '指定平台，自动下载到 .<平台>/skills/ 目录，如 --platform qoder')
+    .addOption(
+        new (require('commander').Option)('--url <url>', '指定注册中心地址')
+            .default(DEFAULT_API_BASE).hideHelp()
+    )
+    .action(cmdDownload);
 
-    // If the API returns the actual markdown content, display a snippet or note
-    if (info.content || info.markdown) {
-        console.log(`\n  ${chalk.dim('[Remote Document Content Available]')}`);
-    }
-    console.log();
-}
+program.command('upload')
+    .alias('publish')
+    .description('将本地技能发布到注册中心')
+    .argument('<技能目录>', '要上传的技能目录路径，如 skills/system/network/firewall')
+    .option('-u, --update', '更新已有技能（同名覆盖），需先更新 SKILL.md 中的版本号')
+    .option('--token <token>', '手动指定认证 Token（覆盖已保存的凭据）')
+    .addOption(
+        new (require('commander').Option)('--url <url>', '指定注册中心地址')
+            .default(DEFAULT_DAILY_API_BASE).hideHelp()
+    )
+    .action(cmdUpload);
 
+// ══════════════════════════════════════════════════════════════════════════
+//  本地开发命令 (Local)
+// ══════════════════════════════════════════════════════════════════════════
 
+program.command('create')
+    .alias('new')
+    .description('创建技能脚手架（生成 SKILL.md 模板）')
+    .argument('<技能路径>', '技能路径，格式：<层级>/<分类>/<名称>，如 system/security/cve-repair')
+    .option('-f, --force', '如果目录已存在则强制覆盖')
+    .action(cmdCreate);
 
-function cmdCreate(skillPath, options) {
-    const targetDir = path.resolve(skillPath);
+program.command('validate')
+    .alias('check')
+    .description('校验技能是否符合 Skill-OS 规范')
+    .argument('<技能目录>', '要校验的技能目录路径，如 skills/system/security/cve-repair')
+    .action(cmdValidate);
 
-    if (fs.existsSync(targetDir)) {
-        if (!options.force) {
-            console.error(chalk.red(`Error: Directory already exists: ${targetDir}`));
-            console.log(chalk.dim("Use --force to overwrite"));
-            process.exit(1);
+program.command('sync')
+    .description('扫描 skills/ 目录，自动生成 SKILL_INDEX.json')
+    .action(cmdSync);
+
+// ══════════════════════════════════════════════════════════════════════════
+//  Shell 命令补全
+// ══════════════════════════════════════════════════════════════════════════
+
+program.command('completion')
+    .description('输出 Shell 命令补全脚本（支持 bash/zsh/fish）')
+    .option('--shell <shell>', '指定 Shell 类型：bash、zsh、fish（默认自动检测）')
+    .action((options) => {
+        const shell = options.shell || detectShell();
+
+        if (shell === 'fish') {
+            console.log(generateFishCompletion());
+        } else if (shell === 'zsh') {
+            console.log(generateZshCompletion());
+        } else {
+            console.log(generateBashCompletion());
         }
-        fs.rmSync(targetDir, { recursive: true, force: true });
-    }
-
-    fs.mkdirSync(targetDir, { recursive: true });
 
-    const parts = skillPath.split('/');
-    if (parts.length < 3) {
-        console.error(chalk.red("Error: Invalid path format"));
-        console.log(chalk.dim("Expected: <layer>/<category>/<skill>"));
-        console.log(chalk.dim("Example: system/security/cve-repair"));
-        process.exit(1);
-    }
+        const installHint = {
+            bash: "eval \"$(skill-os completion --shell bash)\"   # 添加到 ~/.bashrc",
+            zsh: "eval \"$(skill-os completion --shell zsh)\"    # 添加到 ~/.zshrc",
+            fish: "skill-os completion --shell fish | source     # 或保存到 ~/.config/fish/completions/skill-os.fish",
+        };
 
-    const layer = parts[0];
-    const category = parts[1];
-    const skillName = parts[parts.length - 1];
-
-    const validLayers = ["core", "system", "runtime", "application"];
-    if (!validLayers.includes(layer)) {
-        console.log(chalk.yellow(`Warning: Layer '${layer}' not in spec`));
-        console.log(chalk.dim(`Valid layers: ${validLayers.join(', ')}`));
-    }
-
-    const titleCaseName = skillName.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
-
-    const skillMdContent = `---
-name: ${skillName}
-version: 0.1.0
-description: TODO: Add skill description here
-author: Your Name
-
-layer: ${layer}
-category: ${category}
-lifecycle: usage  # production | maintenance | operations | usage | meta
-
-# Tags: first tag MUST be the category name
-tags:
-  - ${category}
-  - TODO
-
-status: placeholder
-dependencies: []
-
-# Optional: Permissions (for security classification)
-# permissions:
-#   requires_root: false
-#   dangerous_operations: []
----
-
-# ${titleCaseName}
-
-TODO: Add skill documentation here.
-
-## 能力概览
-
-- TODO: List capabilities
-
-## 使用示例
-
-\`\`\`bash
-# TODO: Add usage examples
-\`\`\`
-
-## TODO
-
-- [ ] Implement core functionality
-- [ ] Add scripts if needed
-- [ ] Run: skill-os validate ${skillPath}
-- [ ] Run: skill-os sync ${skillPath}
-`;
-
-    const skillMdPath = path.join(targetDir, "SKILL.md");
-    fs.writeFileSync(skillMdPath, skillMdContent, 'utf-8');
+        process.stderr.write(`\n# 安装提示 (添加到 shell 配置文件):\n#   ${installHint[shell] || installHint.bash}\n`);
+    });
 
-    console.log(`\n${chalk.green('✓ Created skill scaffold:')}`);
-    console.log(`  ${chalk.cyan(targetDir)}`);
-    console.log("  └── SKILL.md");
+// ── 补全脚本生成 ────────────────────────────────────────────────────────
 
-    console.log(`\n${chalk.bold('📋 Next Steps:')}`);
-    console.log(`  1. Edit ${chalk.cyan(skillMdPath)}`);
-    console.log(`  2. Validate: ${chalk.dim(`skill-os validate ${skillPath}`)}`);
-    console.log(`  3. Sync: ${chalk.dim(`skill-os sync ${skillPath}`)}`);
+function detectShell() {
+    const shellEnv = process.env.SHELL || '';
+    if (shellEnv.includes('fish')) return 'fish';
+    if (shellEnv.includes('zsh')) return 'zsh';
+    return 'bash';
 }
 
-function cmdDownload(skillPath, options) {
-    // 1. Determine target directory
-    const homeDir = require('os').homedir();
-    let rawTarget = process.cwd();
-
-    if (options.target) {
-        rawTarget = options.target.startsWith('~/') ?
-            path.join(homeDir, options.target.slice(2)) :
-            path.resolve(options.target);
-    } else if (options.platform) {
-        rawTarget = path.join(process.cwd(), `.${options.platform}`, "skills");
-    }
-
-    const targetDir = path.resolve(rawTarget);
-    fs.mkdirSync(targetDir, { recursive: true });
-
-    // 2. Determine API source
-    const serverUrl = getApiBase(options);
-    const downloadUrl = `${serverUrl}/skills/${skillPath}/download`;
-
-    console.log(`\n${chalk.bold(`📥 Downloading and extracting ${skillPath}...`)}`);
-    console.log(`  Source: ${chalk.cyan(downloadUrl)}`);
-    console.log(`  Target: ${chalk.cyan(targetDir)}\n`);
-
-    try {
-        const tmpZip = path.join(require('os').tmpdir(), `skill-${Date.now()}.zip`);
-
-        // Download the zip file to OS tmp dir
-        execSync(`curl -s -L -o "${tmpZip}" "${downloadUrl}"`);
-
-        // Extract the zip to target directory
-        // -q: quiet, -o: overwrite
-        execSync(`unzip -q -o "${tmpZip}" -d "${targetDir}"`);
-
-        // Cleanup temp file
-        if (fs.existsSync(tmpZip)) {
-            fs.unlinkSync(tmpZip);
-        }
-
-        console.log(`\n${chalk.green(`✓ Successfully downloaded and extracted to: ${targetDir}`)}`);
-    } catch (e) {
-        console.error(`\n${chalk.red(`✗ Failed to download. The API may have returned an error, or 'unzip' is not installed.`)}`);
-        process.exit(1);
-    }
+const COMMANDS = [
+    { name: 'login', desc: '登录注册中心' },
+    { name: 'logout', desc: '注销登录' },
+    { name: 'list', desc: '列出所有技能' },
+    { name: 'search', desc: '搜索技能' },
+    { name: 'info', desc: '查看技能详情' },
+    { name: 'download', desc: '下载技能包' },
+    { name: 'upload', desc: '发布技能到注册中心' },
+    { name: 'create', desc: '创建技能脚手架' },
+    { name: 'validate', desc: '校验技能规范' },
+    { name: 'sync', desc: '同步技能索引' },
+    { name: 'completion', desc: '输出命令补全脚本' },
+    // 别名
+    { name: 'ls', desc: 'list 的别名' },
+    { name: 's', desc: 'search 的别名' },
+    { name: 'i', desc: 'info 的别名' },
+    { name: 'dl', desc: 'download 的别名' },
+    { name: 'publish', desc: 'upload 的别名' },
+    { name: 'new', desc: 'create 的别名' },
+    { name: 'check', desc: 'validate 的别名' },
+];
+
+function generateBashCompletion() {
+    const cmds = COMMANDS.map(c => c.name).join(' ');
+    return `
+# skill-os bash completion
+_skill_os_completions() {
+    local cur="\${COMP_WORDS[COMP_CWORD]}"
+    if [ "\${#COMP_WORDS[@]}" -eq 2 ]; then
+        COMPREPLY=($(compgen -W "${cmds}" -- "\${cur}"))
+    fi
 }
-
-// ----------------------------------------------------------------------
-// Publishing / Uploading
-// ----------------------------------------------------------------------
-
-const FormData = require('form-data');
-
-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 {};
-    }
+complete -F _skill_os_completions skill-os
+`.trim();
 }
 
-async function cmdUpload(skillPath, options) {
-    const skillDir = path.resolve(skillPath);
-    const skillMdPath = path.join(skillDir, 'SKILL.md');
-
-    console.log(`\n${chalk.bold(`🚀 Publishing Skill: ${skillPath}`)}`);
-    console.log(`${chalk.dim('─'.repeat(50))}\n`);
-
-    // 1. Validation (Requires hoisted functions)
-    const { isValid: isDirValid, errors: dirErrors } = validateDirectoryStructure(skillDir);
-    if (!isDirValid) {
-        console.error(chalk.red('✗ Validation failed: Directory structure errors:'));
-        dirErrors.forEach(err => console.error(`  - ${err}`));
-        process.exit(1);
-    }
-
-    if (!fs.existsSync(skillMdPath)) {
-        console.log(`${chalk.red('✗ Fatal: SKILL.md not found')}`);
-        process.exit(1);
-    }
-
-    const fm = parseSkillMdFrontmatter(skillMdPath);
-    if (!fm || Object.keys(fm).length === 0) {
-        console.log(`${chalk.red('✗ SKILL.md missing or invalid frontmatter')}`);
-        process.exit(1);
-    }
-
-    const v = new Validator();
-    const result = v.validate(fm, skillSchema);
-    if (fm.category && fm.tags && fm.tags.length > 0 && fm.tags[0] !== fm.category) {
-        result.errors.push({ stack: `tags[0] must equal category name '${fm.category}'` });
-    }
-
-    if (!result.valid || result.errors.length > 0) {
-        console.error(chalk.red('✗ Validation failed: SKILL.md has errors:'));
-        result.errors.forEach(err => console.error(`  - ${err.stack.replace('instance.', '')}`));
-        process.exit(1);
-    }
-
-    console.log(chalk.green('✓ Local validation passed.'));
-
-    // 2. Prepare tarball
-    const tarFilename = `${fm.name}-${fm.version}.tar.gz`;
-    const tmpDir = require('os').tmpdir();
-    const tarPath = path.join(tmpDir, tarFilename);
-
-    console.log(chalk.dim(`📦 Creating package archive...`));
-    try {
-        // -C changes to directory, . archives contents
-        // COPYFILE_DISABLE=1 prevents macOS tar from including ._* extended attribute files
-        execSync(`tar -czf "${tarPath}" -C "${skillDir}" .`, {
-            env: { ...process.env, COPYFILE_DISABLE: '1' }
-        });
-    } catch (e) {
-        console.error(chalk.red('✗ Failed to create tar archive.'));
-        process.exit(1);
-    }
-
-    // 3. Prepare Form Data
-    const form = new FormData();
-    form.append('package', fs.createReadStream(tarPath), {
-        filename: tarFilename,
-        contentType: 'application/gzip'
-    });
-    form.append('metadata', JSON.stringify(fm));
-
-    if (options.update) {
-        form.append('is_update', 'true');
-        console.log(chalk.yellow(`⚠ Uploading as an UPDATE (Version: ${fm.version}). Ensure the version number has been bumped!`));
-    } else {
-        console.log(chalk.cyan(`✨ Uploading as a NEW skill (Version: ${fm.version}).`));
-    }
-
-    const serverUrl = getApiBase(options);
-    const uploadUrl = `${serverUrl}/skills/upload`;
-
-    const fetchOptions = {
-        method: 'POST',
-        body: form,
-        headers: form.getHeaders()
-    };
-
-    if (options.token) {
-        fetchOptions.headers['Authorization'] = `Bearer ${options.token}`;
-    }
-
-    console.log(chalk.dim(`\n📡 Uploading to ${uploadUrl}...`));
-
-    let fetchFn = require('node-fetch');
-    if (typeof fetchFn !== 'function' && fetchFn.default) {
-        fetchFn = fetchFn.default;
-    }
-
-    try {
-        const response = await fetchFn(uploadUrl, fetchOptions);
-        if (!response.ok) {
-            let errorMsg = response.statusText;
-            try {
-                const errBody = await response.json();
-                if (errBody.error || errBody.message) errorMsg = errBody.error || errBody.message;
-            } catch (e) { }
-            throw new Error(`HTTP ${response.status}: ${errorMsg}`);
-        }
-        console.log(`\n${chalk.green('✅ Publish successful!')}`);
-    } catch (error) {
-        console.error(chalk.red(`\n✗ Publish failed.`));
-        console.error(chalk.red(`  ${error.message}`));
-        if (!options.update && error.message.includes('already exists')) {
-            console.log(chalk.yellow(`\n💡 If you intended to update an existing skill, use the --update flag.`));
-        }
-        process.exit(1);
-    } finally {
-        if (fs.existsSync(tarPath)) {
-            fs.unlinkSync(tarPath);
-        }
-    }
+function generateZshCompletion() {
+    const pairs = COMMANDS.map(c => `'${c.name}:${c.desc}'`).join('\n            ');
+    return `
+# skill-os zsh completion
+_skill_os() {
+    local -a commands
+    commands=(
+            ${pairs}
+    )
+    _describe 'skill-os commands' commands
 }
-
-// ----------------------------------------------------------------------
-// Validation Helpers
-// ----------------------------------------------------------------------
-
-const { Validator } = require('jsonschema');
-
-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"] },
-        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", "status"]
-};
-
-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 };
+compdef _skill_os skill-os
+`.trim();
 }
 
-function cmdValidate(skillPath) {
-    const skillDir = path.resolve(skillPath);
-    const skillMdPath = path.join(skillDir, 'SKILL.md');
-
-    console.log(`\n${chalk.bold(`🔍 Validating Skill: ${skillPath}`)}`);
-    console.log(`${chalk.dim('─'.repeat(50))}\n`);
-
-    const { isValid: isDirValid, errors: dirErrors } = validateDirectoryStructure(skillDir);
-    if (isDirValid) {
-        console.log(`${chalk.green('✓ Directory structure valid')}`);
-    } else {
-        console.log(`${chalk.red('✗ Directory structure errors:')}`);
-        dirErrors.forEach(err => console.log(`  - ${err}`));
-    }
-
-    if (!fs.existsSync(skillMdPath)) {
-        console.log(`${chalk.red('✗ Fatal: SKILL.md not found')}`);
-        process.exit(1);
-    }
-
-    const fm = parseSkillMdFrontmatter(skillMdPath);
-
-    // Check if empty frontmatter
-    if (!fm || Object.keys(fm).length === 0) {
-        console.log(`${chalk.red('✗ SKILL.md missing or invalid frontmatter')}`);
-        process.exit(1);
-    }
-
-    const v = new Validator();
-    const result = v.validate(fm, skillSchema);
-
-    // Custom tag validation: first tag MUST be category
-    if (fm.category && fm.tags && fm.tags.length > 0) {
-        if (fm.tags[0] !== fm.category) {
-            result.errors.push({ stack: `tags[0] must equal category name '${fm.category}'` });
-        }
-    }
-
-    if (result.valid && result.errors.length === 0) {
-        console.log(`${chalk.green('✓ SKILL.md is spec compliant')}`);
-        console.log(`\n${chalk.bold('📋 Parsed Metadata:')}`);
-        console.log(`  name:      ${fm.name}`);
-        console.log(`  version:   ${fm.version}`);
-        console.log(`  layer:     ${fm.layer}`);
-        console.log(`  lifecycle: ${fm.lifecycle}`);
-        console.log(`  category:  ${fm.category || '(missing)'}`);
-        console.log(`  tags:      ${JSON.stringify(fm.tags || [])}`);
-        if (fm.permissions) {
-            console.log(`  requires_root: ${fm.permissions.requires_root}`);
-        }
-    } else {
-        console.log(`${chalk.red('✗ SKILL.md validation errors:')}`);
-        result.errors.forEach(err => console.log(`  - ${err.stack.replace('instance.', '')}`));
-        process.exit(1);
-    }
-
-    console.log(`\n${chalk.green('✅ Validation passed!')}\n`);
+function generateFishCompletion() {
+    return COMMANDS.map(c =>
+        `complete -c skill-os -n "__fish_use_subcommand" -a "${c.name}" -d "${c.desc}"`
+    ).join('\n');
 }
 
-// ----------------------------------------------------------------------
-// CLI Setup
-// ----------------------------------------------------------------------
-
-program
-    .name('skill-os')
-    .description('Skill-OS CLI');
-
-program.command('list')
-    .description('List all available skills from the remote registry')
-    .option('--url <url>', 'Override the base URL for the registry', DEFAULT_API_BASE)
-    .action(cmdList);
-
-program.command('search')
-    .description('Search for skills in the remote registry')
-    .argument('<query>', 'Search query')
-    .option('--url <url>', 'Override the base URL for the registry', DEFAULT_API_BASE)
-    .action(cmdSearch);
-
-program.command('info')
-    .description('Show skill details from the remote registry')
-    .argument('<path>', 'Skill path (e.g., package/rpm_search)')
-    .option('--url <url>', 'Override the base URL for the registry', DEFAULT_API_BASE)
-    .action(cmdInfo);
-
-program.command('create')
-    .description('Create a new skill scaffold locally')
-    .argument('<path>', 'Skill path to create (e.g., system/migration)')
-    .option('-f, --force', 'Force overwrite if exists', false)
-    .action(cmdCreate);
-
-program.command('download')
-    .description('Download and extract a skill package from the remote registry')
-    .argument('<skill_path>', 'Path of the skill to download (e.g., core/kernel/kernel-info)')
-    .option('-t, --target <dir>', 'Target directory to extract into (defaults to current dir)')
-    .option('--platform <platform>', 'Specify the platform (e.g., qoder will download to .qoder/skills/)')
-    .option('--url <url>', 'Override the base URL for the registry', DEFAULT_API_BASE)
-    .action(cmdDownload);
-
-program.command('upload')
-    .alias('publish')
-    .description('Upload a local skill to the remote registry')
-    .argument('<path>', 'Skill path to upload (e.g., system/migration)')
-    .option('-u, --update', 'Publish as an update to an existing skill', false)
-    .option('--token <token>', 'Authentication token for the remote registry')
-    .option('--url <url>', 'Override the base URL for the registry', DEFAULT_API_BASE)
-    .action(cmdUpload);
-
-program.command('validate')
-    .description('Validate a skill against spec')
-    .argument('<path>', 'Skill path to validate (e.g., system/security/cve-repair)')
-    .action(cmdValidate);
+// ── 启动 ─────────────────────────────────────────────────────────────────
 
 program.parse(process.argv);