metame-cli 1.5.11 → 1.5.12

package/skills/skill-creator/scripts/package_skill.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+Skill Packager - Creates a distributable .skill file of a skill folder
+
+Usage:
+    python utils/package_skill.py <path/to/skill-folder> [output-directory]
+
+Example:
+    python utils/package_skill.py skills/public/my-skill
+    python utils/package_skill.py skills/public/my-skill ./dist
+"""
+
+import sys
+import zipfile
+from pathlib import Path
+from quick_validate import validate_skill
+
+
+def package_skill(skill_path, output_dir=None):
+    """
+    Package a skill folder into a .skill file.
+
+    Args:
+        skill_path: Path to the skill folder
+        output_dir: Optional output directory for the .skill file (defaults to current directory)
+
+    Returns:
+        Path to the created .skill file, or None if error
+    """
+    skill_path = Path(skill_path).resolve()
+
+    # Validate skill folder exists
+    if not skill_path.exists():
+        print(f"❌ Error: Skill folder not found: {skill_path}")
+        return None
+
+    if not skill_path.is_dir():
+        print(f"❌ Error: Path is not a directory: {skill_path}")
+        return None
+
+    # Validate SKILL.md exists
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        print(f"❌ Error: SKILL.md not found in {skill_path}")
+        return None
+
+    # Run validation before packaging
+    print("🔍 Validating skill...")
+    valid, message = validate_skill(skill_path)
+    if not valid:
+        print(f"❌ Validation failed: {message}")
+        print("   Please fix the validation errors before packaging.")
+        return None
+    print(f"✅ {message}\n")
+
+    # Determine output location
+    skill_name = skill_path.name
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    skill_filename = output_path / f"{skill_name}.skill"
+
+    # Create the .skill file (zip format)
+    try:
+        with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            # Walk through the skill directory
+            for file_path in skill_path.rglob('*'):
+                if file_path.is_file():
+                    # Calculate the relative path within the zip
+                    arcname = file_path.relative_to(skill_path.parent)
+                    zipf.write(file_path, arcname)
+                    print(f"  Added: {arcname}")
+
+        print(f"\n✅ Successfully packaged skill to: {skill_filename}")
+        return skill_filename
+
+    except Exception as e:
+        print(f"❌ Error creating .skill file: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python utils/package_skill.py <path/to/skill-folder> [output-directory]")
+        print("\nExample:")
+        print("  python utils/package_skill.py skills/public/my-skill")
+        print("  python utils/package_skill.py skills/public/my-skill ./dist")
+        sys.exit(1)
+
+    skill_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 Packaging skill: {skill_path}")
+    if output_dir:
+        print(f"   Output directory: {output_dir}")
+    print()
+
+    result = package_skill(skill_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/skill-creator/scripts/quick_validate.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+"""
+Quick validation script for skills - minimal version
+"""
+
+import sys
+import os
+import re
+import yaml
+from pathlib import Path
+
+def validate_skill(skill_path):
+    """Basic validation of a skill"""
+    skill_path = Path(skill_path)
+
+    # Check SKILL.md exists
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.md not found"
+
+    # Read and validate frontmatter
+    content = skill_md.read_text()
+    if not content.startswith('---'):
+        return False, "No YAML frontmatter found"
+
+    # Extract frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "Invalid frontmatter format"
+
+    frontmatter_text = match.group(1)
+
+    # Parse YAML frontmatter
+    try:
+        frontmatter = yaml.safe_load(frontmatter_text)
+        if not isinstance(frontmatter, dict):
+            return False, "Frontmatter must be a YAML dictionary"
+    except yaml.YAMLError as e:
+        return False, f"Invalid YAML in frontmatter: {e}"
+
+    # Define allowed properties
+    ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata', 'compatibility'}
+
+    # Check for unexpected properties (excluding nested keys under metadata)
+    unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
+    if unexpected_keys:
+        return False, (
+            f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. "
+            f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}"
+        )
+
+    # Check required fields
+    if 'name' not in frontmatter:
+        return False, "Missing 'name' in frontmatter"
+    if 'description' not in frontmatter:
+        return False, "Missing 'description' in frontmatter"
+
+    # Extract name for validation
+    name = frontmatter.get('name', '')
+    if not isinstance(name, str):
+        return False, f"Name must be a string, got {type(name).__name__}"
+    name = name.strip()
+    if name:
+        # Check naming convention (kebab-case: lowercase with hyphens)
+        if not re.match(r'^[a-z0-9-]+$', name):
+            return False, f"Name '{name}' should be kebab-case (lowercase letters, digits, and hyphens only)"
+        if name.startswith('-') or name.endswith('-') or '--' in name:
+            return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens"
+        # Check name length (max 64 characters per spec)
+        if len(name) > 64:
+            return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters."
+
+    # Extract and validate description
+    description = frontmatter.get('description', '')
+    if not isinstance(description, str):
+        return False, f"Description must be a string, got {type(description).__name__}"
+    description = description.strip()
+    if description:
+        # Check for angle brackets
+        if '<' in description or '>' in description:
+            return False, "Description cannot contain angle brackets (< or >)"
+        # Check description length (max 1024 characters per spec)
+        if len(description) > 1024:
+            return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters."
+
+    # Validate compatibility field if present (optional)
+    compatibility = frontmatter.get('compatibility', '')
+    if compatibility:
+        if not isinstance(compatibility, str):
+            return False, f"Compatibility must be a string, got {type(compatibility).__name__}"
+        if len(compatibility) > 500:
+            return False, f"Compatibility is too long ({len(compatibility)} characters). Maximum is 500 characters."
+
+    return True, "Skill is valid!"
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("Usage: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+    
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)

package/skills/skill-creator/scripts/setup.py

@@ -0,0 +1,141 @@
+#!/usr/bin/env python3
+"""
+skill-creator setup — auto-configures auto-evolution hook.
+
+Detects platform (Claude Code or OpenAI Codex CLI) and installs accordingly.
+Idempotent: safe to run multiple times.
+
+  python3 ~/.claude/skills/skill-creator/scripts/setup.py   # CC
+  python3 ~/.codex/skills/skill-creator/scripts/setup.py    # Codex
+"""
+
+import json
+import os
+import sys
+
+CLAUDE_DIR = os.path.expanduser('~/.claude')
+CODEX_DIR = os.path.expanduser('~/.codex')
+
+
+def get_hook_path():
+    scripts_dir = os.path.dirname(os.path.abspath(__file__))
+    return os.path.join(scripts_dir, 'auto_evolve_hook.js')
+
+
+def detect_platform():
+    """Detect whether running under Claude Code or OpenAI Codex CLI."""
+    # Prefer whichever directory contains the installed skill-creator
+    hook = get_hook_path()
+    if CLAUDE_DIR in hook or os.path.exists(os.path.join(CLAUDE_DIR, 'settings.json')):
+        return 'cc'
+    if CODEX_DIR in hook or os.path.exists(os.path.join(CODEX_DIR, 'config.toml')):
+        return 'codex'
+    # Fallback: check which dirs exist
+    if os.path.exists(CLAUDE_DIR):
+        return 'cc'
+    if os.path.exists(CODEX_DIR):
+        return 'codex'
+    return 'cc'  # default
+
+
+# ── Claude Code ───────────────────────────────────────────────────────────────
+
+def cc_is_installed(hook_path):
+    settings_file = os.path.join(CLAUDE_DIR, 'settings.json')
+    if not os.path.exists(settings_file):
+        return False
+    try:
+        with open(settings_file, 'r', encoding='utf-8') as f:
+            s = json.load(f)
+        for group in s.get('hooks', {}).get('Stop', []):
+            for h in group.get('hooks', []):
+                if hook_path in h.get('command', ''):
+                    return True
+    except Exception:
+        pass
+    return False
+
+
+def cc_install(hook_path):
+    settings_file = os.path.join(CLAUDE_DIR, 'settings.json')
+    os.makedirs(CLAUDE_DIR, exist_ok=True)
+    settings = {}
+    if os.path.exists(settings_file):
+        try:
+            with open(settings_file, 'r', encoding='utf-8') as f:
+                settings = json.load(f)
+        except Exception:
+            pass
+    hooks = settings.setdefault('hooks', {})
+    hooks.setdefault('Stop', []).append({
+        'hooks': [{'type': 'command', 'command': f'node "{hook_path}"'}]
+    })
+    with open(settings_file, 'w', encoding='utf-8') as f:
+        json.dump(settings, f, indent=2, ensure_ascii=False)
+        f.write('\n')
+
+
+# ── OpenAI Codex CLI ──────────────────────────────────────────────────────────
+
+def codex_is_installed(hook_path):
+    config_file = os.path.join(CODEX_DIR, 'config.toml')
+    if not os.path.exists(config_file):
+        return False
+    with open(config_file, 'r', encoding='utf-8') as f:
+        return 'auto_evolve_hook' in f.read()
+
+
+def codex_install(hook_path):
+    """
+    Codex uses config.toml + notify hook (fires on agent-turn-complete).
+    Note: Codex notify does NOT pass transcript data — evolution runs in
+    signal-only mode (tool failures captured per-turn, no Haiku analysis).
+    """
+    config_file = os.path.join(CODEX_DIR, 'config.toml')
+    os.makedirs(CODEX_DIR, exist_ok=True)
+    entry = f'\n# skill-creator: auto-evolution hook (fires on agent-turn-complete)\nnotify = ["node", "{hook_path}", "--codex"]\n'
+    with open(config_file, 'a', encoding='utf-8') as f:
+        f.write(entry)
+
+
+# ── Main ──────────────────────────────────────────────────────────────────────
+
+def main():
+    hook_path = get_hook_path()
+
+    if not os.path.exists(hook_path):
+        print(f'Error: hook script not found at:\n  {hook_path}', file=sys.stderr)
+        print('Make sure skill-creator is fully installed.', file=sys.stderr)
+        sys.exit(1)
+
+    platform = detect_platform()
+
+    if platform == 'cc':
+        if cc_is_installed(hook_path):
+            print('✓ Auto-evolve hook already configured (Claude Code). Nothing to do.')
+            return
+        cc_install(hook_path)
+        has_key = bool(os.environ.get('ANTHROPIC_API_KEY'))
+        print('✓ Auto-evolve hook installed (Claude Code).')
+        print(f'  Config: ~/.claude/settings.json → Stop hook')
+        if has_key:
+            print('  Mode: Haiku-powered analysis (ANTHROPIC_API_KEY detected)')
+        else:
+            print('  Mode: Rule-based signal capture')
+            print('  Tip: Set ANTHROPIC_API_KEY to enable Haiku-powered experience analysis.')
+        print('  Skills evolve automatically at the end of each session.')
+
+    else:  # codex
+        if codex_is_installed(hook_path):
+            print('✓ Auto-evolve hook already configured (Codex CLI). Nothing to do.')
+            return
+        codex_install(hook_path)
+        print('✓ Auto-evolve hook installed (Codex CLI).')
+        print(f'  Config: ~/.codex/config.toml → notify hook')
+        print('  Mode: Signal capture per turn (Codex notify has no transcript access)')
+        print('  Note: Full Haiku analysis not available on Codex — tool failures are')
+        print('        recorded each turn and stitched into SKILL.md incrementally.')
+
+
+if __name__ == '__main__':
+    main()

package/skills/skill-creator/scripts/smart_stitch.py

@@ -0,0 +1,82 @@
+import os
+import sys
+import json
+import re
+
+def stitch_skill(skill_dir):
+    """
+    Reads evolution.json and stitches it into SKILL.md under a dedicated section.
+    """
+    skill_md_path = os.path.join(skill_dir, "SKILL.md")
+    evolution_json_path = os.path.join(skill_dir, "evolution.json")
+
+    if not os.path.exists(skill_md_path):
+        print(f"Error: SKILL.md not found in {skill_dir}", file=sys.stderr)
+        return False
+        
+    if not os.path.exists(evolution_json_path):
+        print(f"Info: No evolution.json found in {skill_dir}. Nothing to stitch.", file=sys.stderr)
+        return True
+
+    try:
+        with open(evolution_json_path, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+    except Exception as e:
+        print(f"Error parsing evolution.json: {e}", file=sys.stderr)
+        return False
+
+    # Prepare the Markdown content block
+    evolution_section = []
+    evolution_section.append("\n\n## User-Learned Best Practices & Constraints")
+    evolution_section.append("\n> **Auto-Generated Section**: This section is maintained by `skill-creator`. Do not edit manually.")
+    
+    if data.get("preferences"):
+        evolution_section.append("\n### User Preferences")
+        for item in data["preferences"]:
+            evolution_section.append(f"- {item}")
+            
+    if data.get("fixes"):
+        evolution_section.append("\n### Known Fixes & Workarounds")
+        for item in data["fixes"]:
+            evolution_section.append(f"- {item}")
+            
+    if data.get("custom_prompts"):
+        evolution_section.append("\n### Custom Instruction Injection")
+        evolution_section.append(f"\n{data['custom_prompts']}")
+        
+    evolution_block = "\n".join(evolution_section)
+
+    # Read original SKILL.md
+    with open(skill_md_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+
+    # Regex to find existing User-Learned section and replace it, or append if not found
+    # Pattern looks for "## User-Learned Best Practices..." until end of file
+    pattern = r"(\n+## User-Learned Best Practices & Constraints.*$)"
+    
+    match = re.search(pattern, content, re.DOTALL)
+    
+    new_content = ""
+    if match:
+        # Replace existing section
+        print("Updating existing evolution section...", file=sys.stderr)
+        new_content = content[:match.start()] + evolution_block
+    else:
+        # Append to end
+        print("Appending new evolution section...", file=sys.stderr)
+        new_content = content + evolution_block
+
+    # Write back
+    with open(skill_md_path, 'w', encoding='utf-8') as f:
+        f.write(new_content)
+        
+    print(f"Successfully stitched evolution data into {skill_md_path}")
+    return True
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python smart_stitch.py <skill_dir>")
+        sys.exit(1)
+        
+    target_dir = sys.argv[1]
+    stitch_skill(target_dir)

package/skills/skill-manager/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: skill-manager
+description: 技能系统总管。AI 遇到任何能力不足、工具缺失、任务失败时，第一时间查阅此 skill。它掌握全部已安装技能的清单，决定是调用现有技能还是获取新技能，并在任务完成后自动进化技能库。触发条件：(1)任务执行失败或结果不理想，(2)需要的工具/能力不存在，(3)用户说"找技能"、"管理技能"、"更新技能"。本协议应自动触发，无需用户指令。
+---
+
+# Skill Manager — 技能系统总管
+
+## 核心原则
+
+你是技能系统的唯一决策入口。遇到任何能力问题，先来这里。不要自己瞎试，先看清全局再行动。复合任务先拆成独立子能力，每个子能力单独匹配 skill。
+
+## 第一步：看清全局
+
+```bash
+python ~/.opencode/skills/skill-manager/scripts/list_skills.py ~/.claude/skills 2>/dev/null; python ~/.opencode/skills/skill-manager/scripts/list_skills.py ~/.opencode/skills 2>/dev/null
+```
+
+有匹配的 skill → **路径 A**。没有 → **路径 B**。
+
+---
+
+## 路径 A：调用现有 skill
+
+读取对应 SKILL.md，按指引执行。完成后走路径 C。
+
+## 路径 B：获取新能力
+
+这是一条统一的流程，不管"知不知道怎么做"，都从调研开始。调研结果决定用哪个工具。
+
+### B1. 调研（必做，不要跳过）
+
+```
+搜索："[任务关键词] skill" 或 "[任务] automation tool"
+搜索："[平台名] API" 或 "如何自动化 [任务]"
+```
+
+目标：搞清楚有没有现成的东西能用，以及具体怎么做。
+
+### B2. 根据调研结果选择路径
+
+| 调研发现 | 行动 | 用哪个子系统 |
+|---------|------|-------------|
+| skills.sh 商城有现成 skill | 直接装 | `find-skills` |
+| GitHub 上有个项目能做这件事 | 包装成 skill | `github-to-skills` |
+| 找到了教程/方法，但没有现成工具 | 基于调研结果从零创建 | `skill-creator` |
+| 什么都没找到 | 用自己的知识从零创建 | `skill-creator` |
+
+**B2a. 商城安装（最便宜）**
+```bash
+npx skills find <关键词>
+npx skills add <owner/repo> -g -y
+```
+
+**B2b. GitHub 包装（中等成本）**
+
+调用 `github-to-skills` skill，提供 GitHub URL，自动生成 skill。
+
+**B2c. 从零创建（最贵）**
+
+调用 `skill-creator` skill，将调研到的流程写成 SKILL.md：
+- 具体步骤（URL、按钮、等待元素）
+- 前置依赖（Playwright MCP？登录？API Key？）
+- 已知限制和坑
+
+### B3. 验证
+
+```bash
+ls ~/.claude/skills/<技能名>/SKILL.md 2>/dev/null || ls ~/.agents/skills/<技能名>/SKILL.md 2>/dev/null
+```
+
+### B4. 用新 skill 执行原任务
+
+不要停下来汇报安装情况，直接继续干活。完成后走路径 C。
+
+## 路径 C：进化（任务完成后自动执行）
+
+查阅 `skill-evolution-manager`，将本次经验写回 skill。只记有价值的：踩过的坑、用户偏好、优化策略。没有新经验则跳过。
+
+## 路径 D：更新过时 skill
+
+```bash
+python ~/.opencode/skills/skill-manager/scripts/scan_and_check.py ~/.claude/skills
+```
+
+1. `python scripts/update_helper.py <skill_path>` 备份
+2. 拉取新版本
+3. `python ~/.opencode/skills/skill-evolution-manager/scripts/smart_stitch.py <skill_path>` 恢复经验
+
+## 子系统索引
+
+| 子系统 | Skill 名 | 何时调用 |
+|--------|----------|---------|
+| 商城搜索 | `find-skills` | B2a |
+| GitHub 包装 | `github-to-skills` | B2b |
+| 从零创建 | `skill-creator` | B2c |
+| 经验进化 | `skill-evolution-manager` | 路径 C |
+| 环境修复 | `mcp-installer` | 工具缺失错误 |
+| 深度调研 | `deep-research` | B1（复杂主题时） |
+| 自愈诊断 | `self-diagnose` | Daemon 执行失败自动触发；手机 `/doctor` 手动触发 |
+
+## Frontmatter 字段规范
+
+扫描/升级 skill 时，确保 frontmatter 包含：
+- `needs_browser: true` — 需要 Playwright 浏览器自动化的 skill 必须声明此字段，否则手机端会跳过 Playwright 加载（省 ~20s）
+
+## 约束
+
+- 单次最多安装 2 个新技能
+- 优先可信来源（anthropics/、vercel-labs/）
+- 依赖 MCP 的技能先走 `mcp-installer` 自愈协议
+- 商城：https://skills.sh/
+- 删除：`python scripts/delete_skill.py <name> ~/.claude/skills`

package/skills/skill-manager/scripts/delete_skill.py

@@ -0,0 +1,31 @@
+import os
+import sys
+import shutil
+
+def delete_skill(skills_root, skill_name):
+    skill_dir = os.path.join(skills_root, skill_name)
+    
+    if not os.path.exists(skill_dir):
+        print(f"Error: Skill '{skill_name}' not found at {skill_dir}")
+        return False
+        
+    try:
+        # Physical deletion
+        shutil.rmtree(skill_dir)
+        print(f"Successfully deleted skill: {skill_name}")
+        return True
+    except Exception as e:
+        print(f"Error deleting skill '{skill_name}': {e}")
+        return False
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python delete_skill.py <skill_name> [skills_root]")
+        sys.exit(1)
+        
+    name = sys.argv[1]
+    root = r"C:\Users\20515\.claude\skills"
+    if len(sys.argv) > 2:
+        root = sys.argv[2]
+        
+    delete_skill(root, name)

package/skills/skill-manager/scripts/list_skills.py

@@ -0,0 +1,61 @@
+import os
+import sys
+import yaml
+import io
+
+# Force UTF-8 encoding for stdout to handle Chinese characters on Windows
+if hasattr(sys.stdout, 'reconfigure'):
+    sys.stdout.reconfigure(encoding='utf-8')
+else:
+    # Fallback for older Python versions
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+
+def list_skills(skills_root):
+    if not os.path.exists(skills_root):
+        print(f"Error: {skills_root} not found")
+        return
+
+    # Header with Description column
+    header = f"{'Skill Name':<20} | {'Type':<12} | {'Description':<40} | {'Ver':<8}"
+    print(header)
+    print("-" * len(header))
+
+    for item in os.listdir(skills_root):
+        skill_dir = os.path.join(skills_root, item)
+        if not os.path.isdir(skill_dir):
+            continue
+            
+        skill_md = os.path.join(skill_dir, "SKILL.md")
+        skill_type = "Standard"
+        version = "0.1.0"
+        description = "No description"
+        
+        if os.path.exists(skill_md):
+            try:
+                with open(skill_md, "r", encoding="utf-8") as f:
+                    content = f.read()
+                parts = content.split("---")
+                if len(parts) >= 3:
+                    meta = yaml.safe_load(parts[1])
+                    if "github_url" in meta:
+                        skill_type = "GitHub"
+                    version = str(meta.get("version", "0.1.0"))
+                    description = meta.get("description", "No description").replace('\n', ' ')
+            except:
+                pass
+        
+        # Simple truncation for display
+        if len(description) > 37:
+            display_desc = description[:37] + "..."
+        else:
+            display_desc = description
+            
+        # Using a fixed width but acknowledging that Chinese chars take 2 cells
+        # This is a basic fix, for perfect alignment one would need wcwidth
+        print(f"{item:<20} | {skill_type:<12} | {display_desc:<40} | {version:<8}")
+
+if __name__ == "__main__":
+    skills_path = r"C:\Users\20515\.claude\skills"
+    if len(sys.argv) > 1:
+        skills_path = sys.argv[1]
+    list_skills(skills_path)