sumulige-claude 1.0.8 → 1.0.11

package/.claude/skills/xlsx/recalc.py

@@ -0,0 +1,178 @@
+#!/usr/bin/env python3
+"""
+Excel Formula Recalculation Script
+Recalculates all formulas in an Excel file using LibreOffice
+"""
+
+import json
+import sys
+import subprocess
+import os
+import platform
+from pathlib import Path
+from openpyxl import load_workbook
+
+
+def setup_libreoffice_macro():
+    """Setup LibreOffice macro for recalculation if not already configured"""
+    if platform.system() == 'Darwin':
+        macro_dir = os.path.expanduser('~/Library/Application Support/LibreOffice/4/user/basic/Standard')
+    else:
+        macro_dir = os.path.expanduser('~/.config/libreoffice/4/user/basic/Standard')
+    
+    macro_file = os.path.join(macro_dir, 'Module1.xba')
+    
+    if os.path.exists(macro_file):
+        with open(macro_file, 'r') as f:
+            if 'RecalculateAndSave' in f.read():
+                return True
+    
+    if not os.path.exists(macro_dir):
+        subprocess.run(['soffice', '--headless', '--terminate_after_init'], 
+                      capture_output=True, timeout=10)
+        os.makedirs(macro_dir, exist_ok=True)
+    
+    macro_content = '''<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE script:module PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "module.dtd">
+<script:module xmlns:script="http://openoffice.org/2000/script" script:name="Module1" script:language="StarBasic">
+    Sub RecalculateAndSave()
+      ThisComponent.calculateAll()
+      ThisComponent.store()
+      ThisComponent.close(True)
+    End Sub
+</script:module>'''
+    
+    try:
+        with open(macro_file, 'w') as f:
+            f.write(macro_content)
+        return True
+    except Exception:
+        return False
+
+
+def recalc(filename, timeout=30):
+    """
+    Recalculate formulas in Excel file and report any errors
+    
+    Args:
+        filename: Path to Excel file
+        timeout: Maximum time to wait for recalculation (seconds)
+    
+    Returns:
+        dict with error locations and counts
+    """
+    if not Path(filename).exists():
+        return {'error': f'File {filename} does not exist'}
+    
+    abs_path = str(Path(filename).absolute())
+    
+    if not setup_libreoffice_macro():
+        return {'error': 'Failed to setup LibreOffice macro'}
+    
+    cmd = [
+        'soffice', '--headless', '--norestore',
+        'vnd.sun.star.script:Standard.Module1.RecalculateAndSave?language=Basic&location=application',
+        abs_path
+    ]
+    
+    # Handle timeout command differences between Linux and macOS
+    if platform.system() != 'Windows':
+        timeout_cmd = 'timeout' if platform.system() == 'Linux' else None
+        if platform.system() == 'Darwin':
+            # Check if gtimeout is available on macOS
+            try:
+                subprocess.run(['gtimeout', '--version'], capture_output=True, timeout=1, check=False)
+                timeout_cmd = 'gtimeout'
+            except (FileNotFoundError, subprocess.TimeoutExpired):
+                pass
+        
+        if timeout_cmd:
+            cmd = [timeout_cmd, str(timeout)] + cmd
+    
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    
+    if result.returncode != 0 and result.returncode != 124:  # 124 is timeout exit code
+        error_msg = result.stderr or 'Unknown error during recalculation'
+        if 'Module1' in error_msg or 'RecalculateAndSave' not in error_msg:
+            return {'error': 'LibreOffice macro not configured properly'}
+        else:
+            return {'error': error_msg}
+    
+    # Check for Excel errors in the recalculated file - scan ALL cells
+    try:
+        wb = load_workbook(filename, data_only=True)
+        
+        excel_errors = ['#VALUE!', '#DIV/0!', '#REF!', '#NAME?', '#NULL!', '#NUM!', '#N/A']
+        error_details = {err: [] for err in excel_errors}
+        total_errors = 0
+        
+        for sheet_name in wb.sheetnames:
+            ws = wb[sheet_name]
+            # Check ALL rows and columns - no limits
+            for row in ws.iter_rows():
+                for cell in row:
+                    if cell.value is not None and isinstance(cell.value, str):
+                        for err in excel_errors:
+                            if err in cell.value:
+                                location = f"{sheet_name}!{cell.coordinate}"
+                                error_details[err].append(location)
+                                total_errors += 1
+                                break
+        
+        wb.close()
+        
+        # Build result summary
+        result = {
+            'status': 'success' if total_errors == 0 else 'errors_found',
+            'total_errors': total_errors,
+            'error_summary': {}
+        }
+        
+        # Add non-empty error categories
+        for err_type, locations in error_details.items():
+            if locations:
+                result['error_summary'][err_type] = {
+                    'count': len(locations),
+                    'locations': locations[:20]  # Show up to 20 locations
+                }
+        
+        # Add formula count for context - also check ALL cells
+        wb_formulas = load_workbook(filename, data_only=False)
+        formula_count = 0
+        for sheet_name in wb_formulas.sheetnames:
+            ws = wb_formulas[sheet_name]
+            for row in ws.iter_rows():
+                for cell in row:
+                    if cell.value and isinstance(cell.value, str) and cell.value.startswith('='):
+                        formula_count += 1
+        wb_formulas.close()
+        
+        result['total_formulas'] = formula_count
+        
+        return result
+        
+    except Exception as e:
+        return {'error': str(e)}
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python recalc.py <excel_file> [timeout_seconds]")
+        print("\nRecalculates all formulas in an Excel file using LibreOffice")
+        print("\nReturns JSON with error details:")
+        print("  - status: 'success' or 'errors_found'")
+        print("  - total_errors: Total number of Excel errors found")
+        print("  - total_formulas: Number of formulas in the file")
+        print("  - error_summary: Breakdown by error type with locations")
+        print("    - #VALUE!, #DIV/0!, #REF!, #NAME?, #NULL!, #NUM!, #N/A")
+        sys.exit(1)
+    
+    filename = sys.argv[1]
+    timeout = int(sys.argv[2]) if len(sys.argv) > 2 else 30
+    
+    result = recalc(filename, timeout)
+    print(json.dumps(result, indent=2))
+
+
+if __name__ == '__main__':
+    main()

package/.claude-plugin/marketplace.json

@@ -27,8 +27,8 @@
     }
   ],
   "metadata": {
-    "version": "1.0.7",
-    "generated_at": "2026-01-14T12:21:55.220Z",
+    "version": "1.0.10",
+    "generated_at": "2026-01-14T18:29:51.539Z",
     "skill_count": 1,
     "categories": {
       "tools": {

package/AGENTS.md

@@ -2,91 +2,170 @@
 
 <skills_system priority="1">
 
-## Multi-Agent Orchestration
-
-This project uses **Sumulige Claude (SMC)** for intelligent multi-agent collaboration.
-
-### Available Agents
-
-| Agent | Model | Role |
-|-------|-------|------|
-| **Conductor** | claude-opus-4.5 | Task coordination and decomposition |
-| **Architect** | claude-opus-4.5 | Architecture design and technical decisions |
-| **Builder** | claude-opus-4.5 | Code implementation and testing |
-| **Reviewer** | claude-opus-4.5 | Code review and quality assurance |
-| **Librarian** | claude-opus-4.5 | Documentation and knowledge management |
-
-### Usage
-
-```bash
-# View agent status
-smc status
-
-# Run agent task
-smc agent <task>
-
-# List available skills
-smc marketplace:list
-
-# Install a skill
-smc marketplace:install <skill-name>
-
-# Sync external skills
-smc marketplace:sync
-```
-
----
-
-## Skills Marketplace
-
-This project includes a curated skills marketplace with automatic synchronization from external repositories.
-
-### Categories
-
-| Category | Description |
-|----------|-------------|
-| 🔧 **tools** | CLI tools and utilities |
-| 💻 **development** | Language-specific dev assistance |
-| ⚡ **productivity** | Workflow automation |
-| 🤖 **automation** | Browser, CI/CD, system automation |
-| 📊 **data** | Database, data processing |
-| 📚 **documentation** | Docs, diagrams, specs |
-| 🎼 **workflow** | Multi-agent orchestration |
-
-### Universal Compatibility
-
-This project follows the **AGENTS.md** standard, adopted by 20,000+ repositories and natively supported by:
-- Claude Code
-- GitHub Copilot
-- Google Gemini
-- OpenAI Codex
-- Factory Droid
-- Cursor
-- And more...
-
-### Quick Commands
-
-```bash
-# Initialize SMC in your project
-smc init
-
-# Deploy Claude Code project template
-smc template
-
-# Start Manus-style project planning
-smc kickoff
-```
-
----
-
-## Project Template Features
-
-When you run `smc template`, your project gets:
-
-- **ThinkingLens** - Autonomous memory system for AI
-- **Slash Commands** - `/commit`, `/test`, `/review`, `/pr`, etc.
-- **RAG System** - Dynamic skill discovery based on task context
-- **Hooks** - Automation for code formatting, TODO management, etc.
-- **TODO System** - GTD-style task management
+## Available Skills
+
+<!-- SKILLS_TABLE_START -->
+<usage>
+When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
+
+How to use skills:
+- Invoke: Bash("openskills read <skill-name>")
+- The skill content will load with detailed instructions on how to complete the task
+- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
+
+Usage notes:
+- Only use skills listed in <available_skills> below
+- Do not invoke a skill that is already loaded in your context
+- Each skill invocation is stateless
+</usage>
+
+<available_skills>
+
+<skill>
+<name>algorithmic-art</name>
+<description>Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>api-tester</name>
+<description></description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>brand-guidelines</name>
+<description>Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>canvas-design</name>
+<description>Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>doc-coauthoring</name>
+<description>Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>docx</name>
+<description>"Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks"</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>frontend-design</name>
+<description>Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>internal-comms</name>
+<description>A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>mcp-builder</name>
+<description>Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>pdf</name>
+<description>Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>pptx</name>
+<description>"Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks"</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>skill-creator</name>
+<description>Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>slack-gif-creator</name>
+<description>Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>template</name>
+<description>Replace with description of the skill and when Claude should use it.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>theme-factory</name>
+<description>Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>web-artifacts-builder</name>
+<description>Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>webapp-testing</name>
+<description>Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>xlsx</name>
+<description>"Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas"</description>
+<location>project</location>
+</skill>
+
+<skill>
+<name>architect</name>
+<description>|</description>
+<location>global</location>
+</skill>
+
+<skill>
+<name>builder</name>
+<description>|</description>
+<location>global</location>
+</skill>
+
+<skill>
+<name>conductor</name>
+<description>|</description>
+<location>global</location>
+</skill>
+
+<skill>
+<name>librarian</name>
+<description>|</description>
+<location>global</location>
+</skill>
+
+<skill>
+<name>manus-kickoff</name>
+<description></description>
+<location>global</location>
+</skill>
+
+<skill>
+<name>reviewer</name>
+<description>|</description>
+<location>global</location>
+</skill>
+
+</available_skills>
+<!-- SKILLS_TABLE_END -->
 
 </skills_system>

package/README.md

@@ -5,6 +5,7 @@
 
 [![npm version](https://badge.fury.io/js/sumulige-claude.svg)](https://www.npmjs.com/package/sumulige-claude)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-78%20passing-brightgreen)](./tests)
 
 ---
 
@@ -230,10 +231,31 @@ smc kickoff
 
 ---
 
+## Testing / 测试
+
+```bash
+# Run tests / 运行测试
+npm test
+
+# Run with coverage / 运行测试并生成覆盖率报告
+npm run test:coverage
+```
+
+**Coverage / 覆盖率**:
+- utils.js: 100%
+- migrations.js: 86.66%
+- config.js: 86.2%
+- Overall: 36.58%
+
+See **[tests/README.md](tests/README.md)** for detailed test documentation.
+
+---
+
 ## Documentation / 文档
 
 - **[Development Guide / 开发指南](docs/DEVELOPMENT.md)** - Architecture, adding skills, sync mechanism / 架构、添加技能、同步机制
 - **[Marketplace Guide / 市场指南](docs/MARKETPLACE.md)** - User guide for marketplace features / 市场功能用户指南
+- **[Tests Documentation / 测试文档](tests/README.md)** - Test coverage and strategy / 测试覆盖率和策略
 
 ---
 

package/cli.js

@@ -25,7 +25,11 @@ const COMMANDS = {
     args: ''
   },
   sync: {
-    help: 'Sync to current project',
+    help: 'Sync to current project (auto-migrates old format)',
+    args: ''
+  },
+  migrate: {
+    help: 'Migrate old hooks format to new',
     args: ''
   },
   template: {
@@ -110,7 +114,8 @@ function showHelp() {
   console.log('');
   console.log('Examples:');
   console.log('  smc init');
-  console.log('  smc sync');
+  console.log('  smc sync            # Auto-migrates old format');
+  console.log('  smc migrate         # Manual migration');
   console.log('  smc template');
   console.log('  smc template /path/to/project');
   console.log('  smc kickoff        # Start project planning');

package/development/todos/INDEX.md

@@ -2,7 +2,16 @@
 
 > 本目录由 AI 自动维护，记录项目开发任务和进度
 
-**最后更新**: 2026-01-14
+**最后更新**: 2026-01-15
+
+## 任务总览
+
+| 状态 | 目录 | 数量 |
+|------|------|------|
+| 🚧 进行中 | `active/` | 1 |
+| ✅ 已完成 | `completed/` | 1 |
+| 📋 待办 | `backlog/` | 1 |
+| 📦 已归档 | `archived/` | 0 |
 
 @version: 1.0.0
 

package/jest.config.js

@@ -0,0 +1,61 @@
+/**
+ * Jest 配置
+ * Sumulige-Claude 测试框架
+ */
+
+module.exports = {
+  // 测试环境
+  testEnvironment: 'node',
+
+  // 测试文件匹配模式
+  testMatch: [
+    '**/tests/**/*.test.js',
+    '**/__tests__/**/*.js'
+  ],
+
+  // 覆盖率收集配置
+  collectCoverageFrom: [
+    'lib/**/*.js',
+    '!lib/**/*.test.js',
+    '!**/node_modules/**'
+  ],
+
+  // 覆盖率阈值
+  coverageThreshold: {
+    global: {
+      branches: 50,
+      functions: 50,
+      lines: 50,
+      statements: 50
+    }
+  },
+
+  // 覆盖率报告格式
+  coverageReporters: ['text', 'lcov', 'html'],
+
+  // 覆盖率输出目录
+  coverageDirectory: 'coverage',
+
+  // 是否显示每个测试的耗时
+  verbose: true,
+
+  // 测试超时时间（毫秒）
+  testTimeout: 10000,
+
+  // 模块路径别名（可选）
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/$1'
+  },
+
+  // 忽略的目录
+  testPathIgnorePatterns: [
+    '/node_modules/',
+    '/template/',
+    '/coverage/'
+  ],
+
+  // 清除 mock
+  clearMocks: true,
+  resetMocks: true,
+  restoreMocks: true
+};