sumulige-claude 1.0.6 → 1.0.8

package/scripts/sync-external.mjs

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+/**
+ * Sync External Skills
+ *
+ * This script reads sources.yaml and syncs skills from external repositories.
+ * It clones external repos, copies specified files, and generates source metadata.
+ *
+ * Usage: node scripts/sync-external.mjs
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import yaml from 'yaml';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.join(__dirname, '..');
+const SOURCES_FILE = path.join(ROOT_DIR, 'sources.yaml');
+
+// ============================================================================
+// Logging Utilities
+// ============================================================================
+
+const COLORS = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  gray: '\x1b[90m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${COLORS[color]}${message}${COLORS.reset}`);
+}
+
+function logStep(num, total, message) {
+  log(`[${num}/${total}] ${message}`, 'blue');
+}
+
+// ============================================================================
+// File System Utilities
+// ============================================================================
+
+/**
+ * Ensure a directory exists, create if not
+ */
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+/**
+ * Recursively copy directory contents
+ */
+function copyRecursive(src, dest, include = [], exclude = []) {
+  let count = 0;
+
+  if (!fs.existsSync(src)) {
+    return count;
+  }
+
+  const stat = fs.statSync(src);
+
+  if (stat.isDirectory()) {
+    ensureDir(dest);
+
+    const entries = fs.readdirSync(src);
+
+    for (const entry of entries) {
+      // Check exclude patterns
+      const excluded = exclude.some(pattern => {
+        const regex = new RegExp(pattern.replace('*', '.*'));
+        return regex.test(entry);
+      });
+
+      if (excluded) {
+        continue;
+      }
+
+      // Check include patterns (if specified)
+      if (include.length > 0) {
+        const included = include.some(pattern => {
+          const regex = new RegExp(pattern.replace('*', '.*'));
+          return regex.test(entry);
+        });
+        if (!included) {
+          continue;
+        }
+      }
+
+      const srcPath = path.join(src, entry);
+      const destPath = path.join(dest, entry);
+      count += copyRecursive(srcPath, destPath, [], exclude);
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+    count = 1;
+  }
+
+  return count;
+}
+
+/**
+ * Remove directory recursively
+ */
+function removeDir(dirPath) {
+  if (fs.existsSync(dirPath)) {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+  }
+}
+
+// ============================================================================
+// Git Utilities
+// ============================================================================
+
+/**
+ * Clone a Git repository to a temporary directory
+ */
+function cloneRepo(repo, ref, targetDir) {
+  const url = `https://github.com/${repo}.git`;
+  const command = `git clone --depth 1 --branch ${ref} ${url} ${targetDir}`;
+
+  try {
+    execSync(command, { stdio: 'pipe' });
+    return true;
+  } catch (error) {
+    log(`Failed to clone ${repo}: ${error.message}`, 'red');
+    return false;
+  }
+}
+
+// ============================================================================
+// Source Metadata
+// ============================================================================
+
+/**
+ * Write .source.json file for a synced skill
+ */
+function writeSourceJson(skill, targetPath) {
+  const sourceJson = {
+    name: skill.name,
+    description: skill.description,
+    source: {
+      repo: skill.source?.repo,
+      path: skill.source?.path,
+      ref: skill.source?.ref || 'main',
+      synced_at: new Date().toISOString()
+    },
+    author: skill.author,
+    license: skill.license,
+    homepage: skill.homepage,
+    verified: skill.verified || false
+  };
+
+  const sourceJsonPath = path.join(targetPath, '.source.json');
+  fs.writeFileSync(sourceJsonPath, JSON.stringify(sourceJson, null, 2));
+}
+
+// ============================================================================
+// Main Sync Logic
+// ============================================================================
+
+/**
+ * Parse sources.yaml file
+ */
+function parseSources() {
+  if (!fs.existsSync(SOURCES_FILE)) {
+    log('sources.yaml not found!', 'red');
+    return null;
+  }
+
+  const content = fs.readFileSync(SOURCES_FILE, 'utf8');
+  return yaml.parse(content);
+}
+
+/**
+ * Sync a single external skill
+ */
+function syncSkill(skill, index, total) {
+  logStep(index, total, `Syncing: ${skill.name}`);
+
+  // Skip native skills (maintained directly in repo)
+  if (skill.native) {
+    log(`  → Skipped (native skill)`, 'gray');
+    return { success: true, skipped: true };
+  }
+
+  // Validate required fields
+  if (!skill.source?.repo) {
+    log(`  → Skipped (no source.repo)`, 'yellow');
+    return { success: false, error: 'Missing source.repo' };
+  }
+
+  const targetPath = path.join(ROOT_DIR, skill.target.path);
+  const tmpDir = path.join(ROOT_DIR, '.tmp', skill.name);
+
+  try {
+    // Clone repository
+    log(`  → Cloning ${skill.source.repo}...`, 'gray');
+    if (!cloneRepo(skill.source.repo, skill.source.ref || 'main', tmpDir)) {
+      return { success: false, error: 'Clone failed' };
+    }
+
+    // Determine source path
+    const sourcePath = path.join(tmpDir, skill.source.path || '');
+
+    if (!fs.existsSync(sourcePath)) {
+      log(`  → Source path not found: ${skill.source.path}`, 'yellow');
+      removeDir(tmpDir);
+      return { success: false, error: 'Source path not found' };
+    }
+
+    // Clear target directory
+    removeDir(targetPath);
+    ensureDir(targetPath);
+
+    // Copy files
+    const include = skill.sync?.include || [];
+    const exclude = skill.sync?.exclude || ['node_modules', '*.lock'];
+
+    log(`  → Copying files...`, 'gray');
+    const count = copyRecursive(sourcePath, targetPath, include, exclude);
+
+    // Write source metadata
+    writeSourceJson(skill, targetPath);
+
+    // Cleanup
+    removeDir(tmpDir);
+
+    log(`  → Synced ${count} files`, 'green');
+    return { success: true, fileCount: count };
+
+  } catch (error) {
+    removeDir(tmpDir);
+    log(`  → Error: ${error.message}`, 'red');
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * Main sync function
+ */
+function syncAll() {
+  log('🔄 Syncing External Skills', 'blue');
+  log('=====================================', 'gray');
+  log('');
+
+  const sources = parseSources();
+  if (!sources || !sources.skills) {
+    log('No skills found in sources.yaml', 'yellow');
+    return;
+  }
+
+  const skills = sources.skills;
+  const total = skills.length;
+
+  log(`Found ${total} skill(s) in sources.yaml`, 'gray');
+  log('');
+
+  let synced = 0;
+  let skipped = 0;
+  let failed = 0;
+
+  for (let i = 0; i < total; i++) {
+    const result = syncSkill(skills[i], i + 1, total);
+
+    if (result.success) {
+      if (result.skipped) {
+        skipped++;
+      } else {
+        synced++;
+      }
+    } else {
+      failed++;
+    }
+
+    log('');
+  }
+
+  // Summary
+  log('=====================================', 'gray');
+  log(`✅ Synced: ${synced}`, 'green');
+  log(`⏭️  Skipped: ${skipped}`, 'yellow');
+  if (failed > 0) {
+    log(`❌ Failed: ${failed}`, 'red');
+  }
+  log('=====================================', 'gray');
+}
+
+// ============================================================================
+// Run
+// ============================================================================
+
+syncAll();

package/scripts/update-registry.mjs

@@ -0,0 +1,325 @@
+#!/usr/bin/env node
+/**
+ * Update Marketplace Registry
+ *
+ * This script scans the skills directory and generates the marketplace.json
+ * registry file for Claude Code's native plugin system.
+ *
+ * Usage: node scripts/update-registry.mjs
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.join(__dirname, '..');
+const MARKETPLACE_FILE = path.join(ROOT_DIR, '.claude-plugin', 'marketplace.json');
+const SKILLS_DIR = path.join(ROOT_DIR, 'template', '.claude', 'skills');
+const CATEGORIES_FILE = path.join(ROOT_DIR, 'config', 'skill-categories.json');
+
+// ============================================================================
+// Logging Utilities
+// ============================================================================
+
+const COLORS = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  yellow: '\x1b[33m',
+  gray: '\x1b[90m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${COLORS[color]}${message}${COLORS.reset}`);
+}
+
+// ============================================================================
+// File System Utilities
+// ============================================================================
+
+/**
+ * Recursively find all skill directories
+ */
+function findSkillDirs(dir, basePath = dir) {
+  if (!fs.existsSync(dir)) {
+    return [];
+  }
+
+  const skills = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const fullPath = path.join(dir, entry.name);
+
+      // Skip template and examples directories
+      if (['template', 'examples', '__tests__'].includes(entry.name)) {
+        continue;
+      }
+
+      // Check if this is a skill directory (contains SKILL.md or metadata.yaml)
+      const hasSkillFile = fs.existsSync(path.join(fullPath, 'SKILL.md'));
+      const hasMetadata = fs.existsSync(path.join(fullPath, 'metadata.yaml'));
+      const hasSourceJson = fs.existsSync(path.join(fullPath, '.source.json'));
+
+      if (hasSkillFile || hasMetadata || hasSourceJson) {
+        const relativePath = path.relative(basePath, fullPath);
+        skills.push({
+          name: entry.name,
+          path: fullPath,
+          relativePath: relativePath,
+          hasSourceJson
+        });
+      } else {
+        // Recurse into subdirectories
+        skills.push(...findSkillDirs(fullPath, basePath));
+      }
+    }
+  }
+
+  return skills;
+}
+
+/**
+ * Parse YAML metadata file
+ */
+function parseMetadata(skillDir) {
+  const metadataPath = path.join(skillDir, 'metadata.yaml');
+
+  if (!fs.existsSync(metadataPath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(metadataPath, 'utf8');
+    // Simple YAML parser for basic key: value format
+    const result = {};
+    let currentKey = null;
+
+    content.split('\n').forEach(line => {
+      const trimmed = line.trim();
+
+      // Skip comments and empty lines
+      if (!trimmed || trimmed.startsWith('#')) {
+        return;
+      }
+
+      // Key: Value pair
+      const match = trimmed.match(/^([^:]+):\s*(.*)$/);
+      if (match) {
+        currentKey = match[1];
+        let value = match[2];
+
+        // Handle array values
+        if (value.startsWith('[')) {
+          try {
+            value = JSON.parse(value.replace(/'/g, '"'));
+          } catch (e) {
+            value = [];
+          }
+        } else if (value === '[]') {
+          value = [];
+        } else if (value === 'true') {
+          value = true;
+        } else if (value === 'false') {
+          value = false;
+        }
+
+        result[currentKey] = value;
+      } else if (currentKey && trimmed.startsWith('-')) {
+        // Array item continuation
+        if (!Array.isArray(result[currentKey])) {
+          result[currentKey] = [];
+        }
+        result[currentKey].push(trimmed.slice(1).trim());
+      }
+    });
+
+    return result;
+  } catch (error) {
+    log(`Warning: Failed to parse ${metadataPath}`, 'yellow');
+    return null;
+  }
+}
+
+/**
+ * Parse .source.json file
+ */
+function parseSourceJson(skillDir) {
+  const sourcePath = path.join(skillDir, '.source.json');
+
+  if (!fs.existsSync(sourcePath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(sourcePath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Get skill description from SKILL.md
+ */
+function getSkillDescription(skillDir) {
+  const skillPath = path.join(skillDir, 'SKILL.md');
+
+  if (!fs.existsSync(skillPath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(skillPath, 'utf-8');
+    // Extract first heading or first paragraph
+    const lines = content.split('\n');
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      // Skip title
+      if (trimmed.startsWith('#')) {
+        continue;
+      }
+      // Return first non-empty, non-comment line
+      if (trimmed && !trimmed.startsWith('>') && !trimmed.startsWith('<!--')) {
+        return trimmed.replace(/^>/, '').trim();
+      }
+    }
+
+    return null;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Determine skill category
+ */
+function getSkillCategory(skillPath, categories) {
+  // Check if path contains a category
+  const pathParts = skillPath.split(path.sep);
+
+  for (const part of pathParts) {
+    if (categories[part]) {
+      return part;
+    }
+  }
+
+  return 'tools'; // Default category
+}
+
+// ============================================================================
+// Registry Generation
+// ============================================================================
+
+/**
+ * Generate the marketplace.json registry
+ */
+function generateRegistry() {
+  log('📋 Generating Marketplace Registry', 'blue');
+  log('=====================================', 'gray');
+  log('');
+
+  // Load categories
+  let categories = {};
+  if (fs.existsSync(CATEGORIES_FILE)) {
+    categories = JSON.parse(fs.readFileSync(CATEGORIES_FILE, 'utf-8')).categories || {};
+  }
+
+  // Find all skill directories
+  log('Scanning skills directory...', 'gray');
+  const skills = findSkillDirs(SKILLS_DIR);
+  log(`Found ${skills.length} skill(s)`, 'gray');
+  log('');
+
+  if (skills.length === 0) {
+    log('No skills found. Registry will be empty.', 'yellow');
+    return;
+  }
+
+  // Build plugin entries
+  const pluginSkills = [];
+
+  for (const skill of skills) {
+    log(`Processing: ${skill.name}`, 'gray');
+
+    // Get metadata
+    const metadata = parseMetadata(skill.path);
+    const sourceJson = parseSourceJson(skill.path);
+    const description = metadata?.description || getSkillDescription(skill.path) || 'No description';
+
+    // Determine category
+    const category = metadata?.category || getSkillCategory(skill.relativePath, categories);
+
+    // Build relative path from .claude-plugin
+    const relativeFromPlugin = path.join('..', 'template', '.claude', 'skills', skill.relativePath);
+
+    pluginSkills.push({
+      name: skill.name,
+      description: description,
+      path: `./${relativeFromPlugin}`,
+      category: category,
+      external: !!sourceJson
+    });
+  }
+
+  // Build the full registry
+  const registry = {
+    name: 'smc-skills',
+    description: 'Sumulige Claude Agent Harness - Curated skill collection for AI coding agents',
+    homepage: 'https://github.com/sumulige/sumulige-claude',
+    owner: {
+      name: 'sumulige',
+      email: 'sumulige@example.com'
+    },
+    plugins: [
+      {
+        name: 'smc-skills',
+        description: 'Multi-agent orchestration harness with curated skills. Includes Conductor, Architect, Builder, Reviewer, Librarian agents plus RAG-based skill discovery system.',
+        source: './',
+        skills: pluginSkills.map(s => s.path),
+        strict: false,
+        skill_list: pluginSkills
+      }
+    ],
+    metadata: {
+      version: getPackageVersion(),
+      generated_at: new Date().toISOString(),
+      skill_count: skills.length,
+      categories: categories
+    }
+  };
+
+  // Write registry file
+  log('', 'gray');
+  log(`Writing registry to: ${MARKETPLACE_FILE}`, 'gray');
+  fs.writeFileSync(MARKETPLACE_FILE, JSON.stringify(registry, null, 2));
+
+  log('', 'gray');
+  log('=====================================', 'gray');
+  log(`✅ Registry generated with ${skills.length} skills`, 'green');
+  log('=====================================', 'gray');
+}
+
+/**
+ * Get package version
+ */
+function getPackageVersion() {
+  try {
+    const pkgPath = path.join(ROOT_DIR, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version || '1.0.0';
+  } catch (error) {
+    return '1.0.0';
+  }
+}
+
+// ============================================================================
+// Run
+// ============================================================================
+
+generateRegistry();

package/sources.yaml

@@ -0,0 +1,83 @@
+# SMC External Skills Sources
+# ===========================
+# 此清单定义了从外部仓库同步到本项目的技能。
+# GitHub Actions 工作流会读取此文件并每日自动同步上游技能。
+#
+# 添加技能：提交 PR 添加条目到此处。参考 CONTRIBUTING.md。
+
+version: 1
+skills:
+  # ─────────────────────────────────────────────────────────────────────────────
+  # manus-kickoff - Native skill (maintained directly in this repo)
+  # ─────────────────────────────────────────────────────────────────────────────
+  - name: manus-kickoff
+    description: Manus-style project kickoff workflow for AI autonomous development
+    native: true  # Maintained directly in this repo
+    target:
+      category: workflow
+      path: template/.claude/skills/manus-kickoff
+    author:
+      name: sumulige
+      github: sumulige
+    license: MIT
+    homepage: https://github.com/sumulige/sumulige-claude
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # Example: Adding an external skill (commented out)
+  # ─────────────────────────────────────────────────────────────────────────────
+  # - name: dev-browser
+  #   description: Browser automation with persistent page state
+  #   source:
+  #     repo: SawyerHood/dev-browser
+  #     path: skills/dev-browser
+  #     ref: main
+  #   target:
+  #     category: automation
+  #     path: template/.claude/skills/automation/dev-browser
+  #   author:
+  #     name: Sawyer Hood
+  #     github: SawyerHood
+  #   license: MIT
+  #   homepage: https://github.com/SawyerHood/dev-browser
+  #   verified: false
+  #   sync:
+  #     include:
+  #       - SKILL.md
+  #       - references/
+  #       - scripts/
+  #       - src/
+  #       - package.json
+  #     exclude:
+  #       - node_modules/
+  #       - "*.lock"
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Schema Reference
+# ─────────────────────────────────────────────────────────────────────────────
+#
+# skills[]:
+#   name: Required. Unique skill identifier (lowercase, hyphens ok)
+#   description: Required. One-line description for marketplace listings
+#
+#   native: Optional. Set true if skill is maintained directly in this repo
+#
+#   source: Required for external skills
+#     repo: GitHub owner/repo (e.g., "SawyerHood/dev-browser")
+#     path: Path to skill folder within repo
+#     ref: Branch, tag, or commit SHA (default: main)
+#
+#   target: Required
+#     category: One of: tools, development, productivity, automation, data, documentation, workflow
+#     path: Target path in smc-skills repo
+#
+#   author: Required
+#     name: Display name
+#     github: GitHub username
+#
+#   license: Required. SPDX identifier (MIT, Apache-2.0, etc.)
+#   homepage: Required. Link to project homepage or repo
+#   verified: Optional. Set true after manual review (default: false)
+#
+#   sync: Optional. Fine-grained sync control
+#     include: List of files/folders to copy
+#     exclude: Glob patterns to skip