sumulige-claude 1.0.9 → 1.1.0

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)
 
 ---
 
@@ -150,7 +151,8 @@ smc kickoff
 |---------|-------------------|
 | `smc init` | Initialize configuration / 初始化配置 |
 | `smc status` | Show configuration status / 显示配置状态 |
-| `smc sync` | Sync to current project / 同步到当前项目 |
+| `smc sync` | Sync to current project (auto-migrates old format) / 同步到当前项目（自动迁移旧格式） |
+| `smc migrate` | Manually run project migrations / 手动执行项目迁移 |
 
 ### Project Template / 项目模板
 
@@ -197,7 +199,7 @@ smc kickoff
 
 ```json
 {
-  "version": "1.0.7",
+  "version": "1.0.11",
   "model": "claude-opus-4.5",
   "agents": {
     "conductor": {
@@ -230,15 +232,85 @@ 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 / 测试覆盖率和策略
 
 ---
 
 ## Changelog / 更新日志
 
+### v1.0.11 (2026-01-15)
+
+**English** | Test suite and version-aware migration system.
+
+**中文** | 测试套件和版本感知迁移系统。
+
+- **Migration System / 迁移系统**
+  - `lib/migrations.js` - Version-aware migrations / 版本感知迁移
+  - `smc migrate` command / 迁移命令
+  - Auto-migration on sync / 同步时自动迁移
+- **Test Suite / 测试套件**
+  - 78 tests across 5 modules / 5 个模块共 78 个测试
+  - Jest framework with mocking / Jest 框架和 Mock
+
+### v1.0.10 (2026-01-15)
+
+**English** | Conversation logger hook for daily tracking.
+
+**中文** | 对话日志器 Hook，按日期记录。
+
+- `template/.claude/hooks/conversation-logger.cjs` - Auto-record conversations / 自动记录对话
+- `DAILY_CONVERSATION.md` - Date-grouped history / 按日期分组的历史记录
+
+### v1.0.9 (2026-01-15)
+
+**English** | Session cleanup improvements.
+
+**中文** | 会话清理改进。
+
+- Clean up stale session entries / 清理过期会话记录
+
+### v1.0.8 (2026-01-14)
+
+**English** | Skill Marketplace system with auto-sync.
+
+**中文** | 技能市场系统，支持自动同步。
+
+- **Marketplace System / 市场系统**
+  - `.claude-plugin/marketplace.json` - Claude Code native plugin registry / 原生插件注册表
+  - `sources.yaml` - External skills configuration / 外部技能配置
+  - 6 new marketplace commands / 6 个新市场命令
+- **Auto-Sync / 自动同步**
+  - `scripts/sync-external.mjs` - Sync engine / 同步引擎
+  - `scripts/update-registry.mjs` - Registry generator / 注册表生成器
+  - GitHub Actions daily sync / GitHub Actions 每日同步
+- **Documentation / 文档**
+  - `docs/DEVELOPMENT.md` - Development guide / 开发指南
+  - `docs/MARKETPLACE.md` - Marketplace user guide / 市场用户指南
+
 ### v1.0.7 (2025-01-14)
 
 **English** | Added Skill Marketplace system with auto-sync from external repositories.

package/cli.js

@@ -20,17 +20,25 @@ const { marketplaceCommands } = require('./lib/marketplace');
 // ============================================================================
 
 const COMMANDS = {
+  version: {
+    help: 'Show version and check for updates',
+    args: ''
+  },
   init: {
     help: 'Initialize configuration',
-    args: ''
+    args: '[--interactive]'
   },
   sync: {
-    help: 'Sync to current project',
+    help: 'Sync to current project (auto-migrates old format)',
+    args: '[--check-update]'
+  },
+  migrate: {
+    help: 'Migrate old hooks format to new',
     args: ''
   },
   template: {
     help: 'Deploy Claude Code project template',
-    args: '[path]'
+    args: '[path] [--safe] [--force] [--help]'
   },
   kickoff: {
     help: 'Start project planning workflow (Manus-style)',
@@ -83,6 +91,50 @@ const COMMANDS = {
   'marketplace:status': {
     help: 'Show marketplace status',
     args: ''
+  },
+  ultrathink: {
+    help: 'Enable deep thinking mode for AI',
+    args: ''
+  },
+  'skills:official': {
+    help: 'List official Claude skills',
+    args: ''
+  },
+  'skills:install-official': {
+    help: 'Install an official skill',
+    args: '<name>'
+  },
+  'skills:install-all': {
+    help: 'Install all recommended skills',
+    args: ''
+  },
+  doctor: {
+    help: 'Check system health',
+    args: ''
+  },
+  'skills:search': {
+    help: 'Search skills by keyword',
+    args: '<keyword>'
+  },
+  'skills:validate': {
+    help: 'Validate skill format',
+    args: '[path]'
+  },
+  'skills:update': {
+    help: 'Update official skills list',
+    args: ''
+  },
+  'skills:publish': {
+    help: 'Publish skill to GitHub',
+    args: '[path]'
+  },
+  config: {
+    help: 'Manage configuration',
+    args: '[get|set] [key] [value]'
+  },
+  changelog: {
+    help: 'Generate changelog from git commits',
+    args: '[--from <tag>] [--to <tag>] [--json]'
   }
 };
 
@@ -110,9 +162,13 @@ function showHelp() {
   console.log('');
   console.log('Examples:');
   console.log('  smc init');
-  console.log('  smc sync');
-  console.log('  smc template');
+  console.log('  smc sync            # Sync to current project');
+  console.log('  smc sync --check-update  # Force check for updates');
+  console.log('  smc migrate         # Manual migration');
+  console.log('  smc template          # Deploy to current dir (with backup)');
   console.log('  smc template /path/to/project');
+  console.log('  smc template --safe   # Skip existing files');
+  console.log('  smc template --force  # Overwrite without backup');
   console.log('  smc kickoff        # Start project planning');
   console.log('  smc agent "Build a REST API"');
   console.log('  smc skill:create api-tester');
@@ -121,6 +177,12 @@ function showHelp() {
   console.log('  smc marketplace:list');
   console.log('  smc marketplace:install dev-browser');
   console.log('  smc marketplace:sync');
+  console.log('  smc ultrathink      # Enable deep thinking mode');
+  console.log('  smc skills:official # List official skills');
+  console.log('  smc doctor           # Check system health');
+  console.log('  smc skills:search    # Search skills by keyword');
+  console.log('  smc changelog        # Generate changelog');
+  console.log('  smc init -i         # Interactive setup');
 }
 
 // ============================================================================
@@ -130,6 +192,18 @@ function showHelp() {
 function main() {
   const [cmd, ...args] = process.argv.slice(2);
 
+  // Handle --version flag
+  if (cmd === '--version' || cmd === '-v') {
+    runCommand('version', []);
+    return;
+  }
+
+  // Handle help command
+  if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
+    showHelp();
+    return;
+  }
+
   if (!cmd) {
     showHelp();
     return;

package/config/official-skills.json

@@ -0,0 +1,183 @@
+{
+  "version": "1.0.0",
+  "last_updated": "2026-01-15",
+  "source": "anthropics/skills",
+  "categories": {
+    "documents": {
+      "name": "文档处理",
+      "icon": "📄",
+      "description": "Office 文档创建、编辑和转换"
+    },
+    "creative": {
+      "name": "创意设计",
+      "icon": "🎨",
+      "description": "艺术创作、设计、品牌规范"
+    },
+    "development": {
+      "name": "开发工具",
+      "icon": "🛠️",
+      "description": "MCP 服务器、技能创建、测试"
+    },
+    "workflow": {
+      "name": "工作流",
+      "icon": "📋",
+      "description": "文档协作、内部沟通"
+    }
+  },
+  "skills": [
+    {
+      "name": "docx",
+      "category": "documents",
+      "description": "Word 文档创建、编辑、修订模式和批注",
+      "source": "anthropics/skills",
+      "path": "skills/docx",
+      "license": "source-available",
+      "recommended": true
+    },
+    {
+      "name": "pdf",
+      "category": "documents",
+      "description": "PDF 文本表格提取、合并拆分、表单填写",
+      "source": "anthropics/skills",
+      "path": "skills/pdf",
+      "license": "source-available",
+      "recommended": true
+    },
+    {
+      "name": "pptx",
+      "category": "documents",
+      "description": "PowerPoint 演示文稿创建、编辑、布局管理",
+      "source": "anthropics/skills",
+      "path": "skills/pptx",
+      "license": "source-available",
+      "recommended": true
+    },
+    {
+      "name": "xlsx",
+      "category": "documents",
+      "description": "Excel 电子表格创建、公式、格式化、数据分析",
+      "source": "anthropics/skills",
+      "path": "skills/xlsx",
+      "license": "source-available",
+      "recommended": true
+    },
+    {
+      "name": "frontend-design",
+      "category": "creative",
+      "description": "生产级前端界面设计，避免 AI 审美同质化",
+      "source": "anthropics/skills",
+      "path": "skills/frontend-design",
+      "license": "Apache-2.0",
+      "recommended": true
+    },
+    {
+      "name": "algorithmic-art",
+      "category": "creative",
+      "description": "使用 p5.js 创建算法艺术、流场、粒子系统",
+      "source": "anthropics/skills",
+      "path": "skills/algorithmic-art",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "canvas-design",
+      "category": "creative",
+      "description": "创建 PNG/PDF 格式的视觉艺术作品",
+      "source": "anthropics/skills",
+      "path": "skills/canvas-design",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "brand-guidelines",
+      "category": "creative",
+      "description": "应用 Anthropic 官方品牌色彩和排版",
+      "source": "anthropics/skills",
+      "path": "skills/brand-guidelines",
+      "license": "proprietary",
+      "recommended": false
+    },
+    {
+      "name": "mcp-builder",
+      "category": "development",
+      "description": "创建 MCP 服务器的完整指南（Python FastMCP / Node SDK）",
+      "source": "anthropics/skills",
+      "path": "skills/mcp-builder",
+      "license": "Apache-2.0",
+      "recommended": true
+    },
+    {
+      "name": "skill-creator",
+      "category": "development",
+      "description": "创建高质量 Agent Skills 的指南",
+      "source": "anthropics/skills",
+      "path": "skills/skill-creator",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "webapp-testing",
+      "category": "development",
+      "description": "使用 Playwright 测试本地 Web 应用",
+      "source": "anthropics/skills",
+      "path": "skills/webapp-testing",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "doc-coauthoring",
+      "category": "workflow",
+      "description": "结构化文档协作工作流（提案、规格、决策文档）",
+      "source": "anthropics/skills",
+      "path": "skills/doc-coauthoring",
+      "license": "Apache-2.0",
+      "recommended": true
+    },
+    {
+      "name": "internal-comms",
+      "category": "workflow",
+      "description": "企业内部沟通格式（状态报告、更新、公告）",
+      "source": "anthropics/skills",
+      "path": "skills/internal-comms",
+      "license": "proprietary",
+      "recommended": false
+    },
+    {
+      "name": "slack-gif-creator",
+      "category": "creative",
+      "description": "创建适用于 Slack 的动画 GIF",
+      "source": "anthropics/skills",
+      "path": "skills/slack-gif-creator",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "theme-factory",
+      "category": "creative",
+      "description": "为文档应用预设主题（10 种配色/字体方案）",
+      "source": "anthropics/skills",
+      "path": "skills/theme-factory",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "web-artifacts-builder",
+      "category": "development",
+      "description": "使用 React/Tailwind/shadcn.ui 构建 HTML 工件",
+      "source": "anthropics/skills",
+      "path": "skills/web-artifacts-builder",
+      "license": "Apache-2.0",
+      "recommended": false
+    },
+    {
+      "name": "test-workflow",
+      "category": "development",
+      "description": "自动化测试工作流：Playwright测试 + Slack GIF录制 + 测试报告生成",
+      "source": "sumulige-claude",
+      "path": "test-workflow",
+      "license": "MIT",
+      "recommended": true,
+      "native": true
+    }
+  ]
+}

package/development/todos/.state.json

@@ -0,0 +1,4 @@
+{
+  "tasks": {},
+  "transitions": []
+}

package/development/todos/INDEX.md

@@ -1,70 +1,105 @@
 # 项目任务追踪系统
 
-> 本目录由 AI 自动维护，记录项目开发任务和进度
+> **统一管理**: 研究 → 开发 → 测试
+> **最后更新**: 2026-01-15
 
-**最后更新**: 2026-01-14
+@version: 2.0.0
 
-@version: 1.0.0
+---
+
+## 📊 项目进度
+
+| 阶段 | 进度 | 状态 |
+|------|------|------|
+| Phase 1: MVP 智能监控 | 80% | 🚧 进行中 |
+| Phase 2: V1.5 动态调整 | 0% | 📋 待规划 |
+| Phase 3: V2.0 AI 教练 | 0% | 📋 待规划 |
+
+---
+
+## 🔄 任务生命周期
+
+```
+┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+│  RESEARCH   │ → │  DEVELOP    │ → │   TEST      │
+│  📊 研究     │    │  💻 开发     │    │  🧪 测试     │
+└─────────────┘    └─────────────┘    └─────────────┘
+```
+
+---
 
-## 目录结构
+## 📁 目录结构
 
 ```
 development/todos/
 ├── INDEX.md           # 本文件 - 任务总览
-├── active/            # 进行中的任务 (1)
-├── completed/         # 已完成的任务 (1)
-├── backlog/           # 待规划的任务 (1)
-└── archived/          # 已归档的任务 (0)
+├── _templates/        # 任务模板
+├── active/            # 进行中的任务 (0)
+│   ├── research/      # 📊 研究中 (0)
+│   ├── develop/       # 💻 开发中 (0)
+│   └── test/          # 🧪 测试中 (0)
+├── completed/         # 已完成的任务 (0)
+│   ├── research/
+│   ├── develop/
+│   └── test/
+├── backlog/           # 待规划的任务 (0)
+└── archived/          # 已归档的任务
 ```
 
-## 快速跳转
+---
+
+## 🚧 当前进行中的任务
+
+### 📊 研究任务
+暂无
 
-## 🚧 进行中的任务 (1)
+### 💻 开发任务
+暂无
 
-- [P1] [TODO 任务管理系统](./active/todo-system.md) - 🚧 `branch: feature/todo-system`
+### 🧪 测试任务
+暂无
+
+---
 
 ## ✅ 最近完成的任务
 
-- [Boris 最佳实践集成](./completed/boris-optimizations.md)
+### 💻 开发任务
+暂无
 
-## 📋 待办任务 (1)
+### 🧪 测试任务
+暂无
 
-- [P2] [MCP 集成增强](./backlog/mcp-integration.md)
+---
 
-## 全部目录
+## 📋 待办任务
 
-- [🚧 所有进行中的任务](./active/) - 当前开发重点
-- [✅ 所有已完成的任务](./completed/) - 完整历史
-- [📋 所有待办任务](./backlog/) - 待规划
-- [📦 所有已归档任务](./archived/) - 历史记录
+暂无
 
-## 使用方式
+---
+
+## 🎯 使用方式
 
 ### 查看任务
-点击上方链接跳转到对应目录，或使用：
 ```bash
-# 查看进行中的任务
-cat development/todos/active/*.md
-
-# 查看特定任务
-cat development/todos/active/feature-name.md
+# 按类型查看
+ls development/todos/active/research/   # 研究任务
+ls development/todos/active/develop/    # 开发任务
+ls development/todos/active/test/       # 测试任务
 ```
 
 ### 创建新任务
 在 Claude Code 中：
 ```
-创建一个新任务：实现用户登录功能
+创建一个新任务：
+- 类型：测试
+- 标题：Dashboard 功能测试
 ```
 
-AI 会自动在 `active/` 目录创建对应的任务文件。
-
 ### 更新任务状态
 ```
 将 [任务名] 标记为完成
 ```
 
-AI 会自动将任务移动到 `completed/` 目录。
-
 ---
 
-> **维护说明**: 本系统由 AI 自动维护，请勿手动编辑（除非你知道自己在做什么）
+> **维护说明**: 本系统由 AI 自动维护

package/docs/RELEASE.md

@@ -0,0 +1,93 @@
+# Release Guide
+
+Automated version release with `standard-version`.
+
+## How It Works
+
+`standard-version` analyzes your git commits to generate CHANGELOG entries and bump the version automatically.
+
+## Commit Convention
+
+Use [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```
+<type>: <description>
+
+[optional body]
+```
+
+### Types
+
+| Type | Section | Example |
+|------|---------|---------|
+| `feat` | Added | `feat: add user authentication` |
+| `fix` | Fixed | `fix: resolve migration bug` |
+| `docs` | Changed | `docs: update README installation steps` |
+| `refactor` | Changed | `refactor: simplify config loading` |
+| `perf` | Changed | `perf: optimize startup time` |
+| `test` | Changed | `test: add unit tests for marketplace` |
+| `chore` | Changed | `chore: update dependencies` |
+| `style` | (hidden) | `style: format code` |
+
+## Usage
+
+### 1. Development
+
+Make commits following the convention:
+
+```bash
+git commit -m "feat: add new command"
+git commit -m "fix: resolve migration issue"
+git commit -m "docs: update API documentation"
+```
+
+### 2. Release
+
+Run the release command:
+
+```bash
+# Auto-detect version bump (patch/minor/major)
+npm run release
+
+# Or specify the version type
+npm run release:patch   # 1.0.11 → 1.0.12
+npm run release:minor   # 1.0.11 → 1.1.0
+npm run release:major   # 1.0.11 → 2.0.0
+```
+
+This will:
+1. Analyze commits since last tag
+2. Generate CHANGELOG entry
+3. Bump version in package.json
+4. Create a git commit
+
+### 3. Tag & Push
+
+```bash
+# Create and push tag (skipped by standard-version)
+git tag v$(node -p "require('./package.json').version")
+git push --follow-tags origin main
+
+# Optional: publish to npm
+npm publish
+```
+
+## Configuration
+
+See `.versionrc` for customization.
+
+## Example Workflow
+
+```bash
+# 1. Make some changes
+git commit -m "feat: add dark mode support"
+git commit -m "fix: resolve layout issue"
+
+# 2. Release
+npm run release
+
+# 3. Review and push
+git log -1                    # Review the release commit
+git tag v1.0.12               # Create tag
+git push --follow-tags origin main
+```