sumulige-claude 1.0.11 → 1.1.1

package/PROJECT_STRUCTURE.md

@@ -15,9 +15,12 @@
 | 功能 | 描述 |
 |------|------|
 | **多 Agent 协作** | 5个专业化 Agent（Conductor/Architect/Builder/Reviewer/Librarian）分工协作 |
+| **技能市场** | 发现、安装和同步外部技能（v1.0.8 新增） |
 | **技能系统** | 可复用的 Claude Skills 管理（安装/创建/依赖检查） |
+| **版本迁移** | 自动检测并迁移旧格式项目（v1.0.11 新增） |
 | **项目模板** | 一键部署完整的 Claude Code 项目配置 |
 | **TODO 管理** | 按优先级分组的 AI 自动维护任务系统 |
+| **测试套件** | 78 个测试用例覆盖核心模块（v1.0.11 新增） |
 | **ThinkingLens** | 对话追踪和增量记忆系统 |
 
 ### Agent 角色说明
@@ -52,10 +55,36 @@ sumulige-claude/
 ├── lib/                              # ⭐ 核心库模块（v1.0.6+ 重构）
 │   ├── commands.js                   # 命令实现（~700 行）
 │   ├── config.js                     # 配置管理（~70 行）
+│   ├── marketplace.js                # 技能市场功能（v1.0.8 新增）
+│   ├── migrations.js                 # 版本迁移系统（v1.0.11 新增）
 │   └── utils.js                      # 公共工具函数（~60 行）
 │
 ├── config/                           # ⭐ 默认配置（v1.0.6+ 新增）
-│   └── defaults.json                 # 默认配置文件
+│   ├── defaults.json                 # 默认配置文件
+│   └── skill-categories.json         # 技能分类（v1.0.8 新增）
+│
+├── scripts/                          # ⭐ 自动化脚本（v1.0.8 新增）
+│   ├── sync-external.mjs             # 外部技能同步引擎
+│   └── update-registry.mjs           # 市场注册表生成器
+│
+├── tests/                            # ⭐ 测试套件（v1.0.11 新增）
+│   ├── *.test.js                     # 单元测试（78 tests）
+│   ├── fixtures/                     # 测试夹具
+│   ├── mocks/                        # Mock 数据
+│   └── README.md                     # 测试文档
+│
+├── docs/                             # ⭐ 开发文档（v1.0.8 新增）
+│   ├── DEVELOPMENT.md                # 开发指南
+│   └── MARKETPLACE.md                # 技能市场指南
+│
+├── .claude-plugin/                   # ⭐ Claude Code 插件（v1.0.8 新增）
+│   └── marketplace.json              # 技能市场注册表
+│
+├── .github/                          # CI/CD 配置（v1.0.8 新增）
+│   └── workflows/
+│       └── sync-skills.yml           # 每日技能同步
+│
+├── sources.yaml                      # 外部技能源配置（v1.0.8 新增）
 │
 ├── development/                      # 开发任务管理
 │   └── todos/                        # TODO 任务系统（GTD 风格）
@@ -131,7 +160,8 @@ sumulige-claude/
 smc (sumulige-claude 简写)
 ├── init                  # 初始化配置 (~/.claude/config.json)
 ├── status                # 查看状态（Agents/Skills/Tasks）
-├── sync                  # 同步配置到项目
+├── sync                  # 同步配置到项目（自动执行迁移）
+├── migrate               # 手动执行项目迁移（v1.0.11 新增）
 ├── template [path]       # 部署项目模板
 ├── kickoff               # Manus 风格项目规划启动
 │
@@ -140,6 +170,13 @@ smc (sumulige-claude 简写)
 ├── skill:check [name]    # 检查技能依赖
 ├── skill:install <src>   # 安装外部技能
 │
+├── marketplace:list      # 列出市场技能（v1.0.8 新增）
+├── marketplace:install   # 安装市场技能
+├── marketplace:sync      # 同步外部技能源
+├── marketplace:add       # 添加技能源
+├── marketplace:remove    # 移除技能源
+├── marketplace:status    # 查看市场状态
+│
 └── agent <task>          # 启动 Agent 编排
 ```
 
@@ -226,4 +263,4 @@ smc (sumulige-claude 简写)
 
 ---
 
-*Generated: 2026-01-13*
+*Generated: 2026-01-15*

package/Q&A.md

@@ -121,4 +121,188 @@ template/.claude/          xxx/.claude/
 
 ---
 
+## Q3: `smc template` 和 `smc sync` 有什么区别？
+
+### 🔑 一句话答案
+**`template` 是"全屋装修"，`sync` 是"添置物品"。**
+
+### 📊 对比理解
+
+| 命令 | 行为 | 用途 | 风险 |
+|------|------|------|------|
+| `smc template` | **完整覆盖** | 新项目初始化 | ⚠️ 会覆盖已有文件 |
+| `smc sync` | **增量同步** | 现有项目更新 | ✅ 只补缺少的 |
+
+### 🏠 类比说明
+
+```
+smc template                    smc sync
+────────────                    ────────
+
+🏗️ 新房装修                      🛋️ 添置家具
+
+空房子 ──→ 精装房                已住的房子 ──→ 补个沙发
+
+全屋定制                         只买缺的
+（窗帘+地板+沙发）               （只买沙发）
+
+覆盖原有装修                     不动已有物品
+```
+
+### 🔄 使用流程
+
+**场景 A：启动新项目**
+```bash
+mkdir my-new-project
+cd my-new-project
+smc template    # ✅ 一次性配置好所有 AI 能力
+```
+
+**场景 B：已有项目想用 sumulige-claude**
+```bash
+cd existing-project
+smc sync        # ✅ 增量添加，不覆盖已有配置
+```
+
+### 📋 命令效果对比
+
+| 操作 | smc template | smc sync |
+|------|--------------|----------|
+| `.claude/` 目录 | ✅ 创建/覆盖 | ✅ 补充缺失 |
+| `CLAUDE.md` | ⚠️ 覆盖 | ✅ 保留已有 |
+| `hooks/*` | ⚠️ 覆盖 | ✅ 保留已有 |
+| `commands/*` | ⚠️ 覆盖 | ✅ 保留已有 |
+| `sessions/` | ✅ 新建空目录 | ✅ 完整保留 |
+
+### 💡 最佳实践
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  判断流程                                                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  项目是空的？                                               │
+│       │                                                     │
+│       ├─ 是 → smc template                                 │
+│       │        (全屋装修)                                   │
+│       │                                                     │
+│       └─ 否 → smc sync                                     │
+│                (添置物品)                                   │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### ⚠️ 注意事项
+
+`smc template` 会**覆盖**以下关键文件：
+- `.claude/CLAUDE.md` - 项目配置
+- `.claude/hooks/*` - 钩子脚本
+- `.claude/commands/*` - 命令定义
+
+**v1.1.0 新增安全选项**：
+- `smc template --safe`   - 跳过已存在的文件（不覆盖）
+- `smc template --force`  - 强制覆盖（不备份）
+- `smc template` (默认)   - 覆盖前自动备份到 `.claude/backup/`
+
+### 🛡️ 安全机制
+
+默认情况下，`smc template` 会自动备份被覆盖的文件：
+
+```bash
+smc template
+# 会创建备份文件：.claude/backup/CLAUDE.2026-01-15.bak
+```
+
+如果你不想要任何备份（确定要覆盖），使用 `--force`：
+```bash
+smc template --force  # 不备份，直接覆盖
+```
+
+如果你想完全保留现有文件，使用 `--safe`：
+```bash
+smc template --safe  # 只添加缺失的文件
+```
+
+---
+
+## Q4: sumulige-claude 发布新版本后如何更新？
+
+### 🔑 一句话答案
+**更新全局包 → 同步到项目**
+
+### 📦 更新流程
+
+```bash
+# 1️⃣ 检查当前版本
+smc --version
+
+# 2️⃣ 更新全局包
+npm update -g sumulige-claude
+
+# 3️⃣ 同步到项目（进入你的项目目录）
+cd your-project
+smc sync          # 增量同步新能力
+```
+
+### 🔄 管理逻辑差异
+
+| 维度 | 全局 `~/.claude/` | 项目 `./.claude/` |
+|------|-------------------|-------------------|
+| **作用域** | 用户级 | 项目级 |
+| **初始化** | `smc init` | `smc template` / `smc sync` |
+| **更新时机** | npm update 后 | 运行 smc sync |
+| **内容性质** | 能力定义 (能做什么) | 运行状态 (做过什么) |
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  一句话区别                                                  │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  全局 = "工具箱"    → 定义有什么工具可用                     │
+│  项目 = "工作台"    → 记录用工具做了什么                     │
+│                                                             │
+│  init  = "买工具箱"  → 一次购买，终身使用                    │
+│  template = "摆工具"  → 每个项目摆一次                       │
+│  sync   = "补工具"   → 发现缺什么补什么                      │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 🔍 版本检查
+
+sumulige-claude 采用**惰性检查**策略：
+
+| 时机 | 检查方式 | 说明 |
+|------|---------|------|
+| `smc --version` | 主动检查 | 用户主动触发，零性能开销 |
+| `smc sync` | 主动检查 | 同步时已联网，无额外开销 |
+| 其他命令 | 不检查 | 不影响正常使用 |
+
+### 📋 发布端操作（作者）
+
+```bash
+# 1️⃣ 更新版本号
+npm version patch  # 1.1.0 → 1.1.1 (bug fix)
+npm version minor  # 1.1.0 → 1.2.0 (新功能)
+
+# 2️⃣ 生成 changelog
+npm run release
+
+# 3️⃣ 推送并发布
+git push --follow-tags
+npm publish
+```
+
+### ✨ 自动化特性
+
+`postinstall` 钩子确保全局配置始终最新：
+
+```json
+"postinstall": "node cli.js init"
+```
+
+运行 `npm update -g sumulige-claude` 时会自动执行 `smc init`。
+
+---
+
 *更多问题？查看 [README.md](./README.md)*

package/README.md

@@ -151,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 / 项目模板
 
@@ -198,7 +199,7 @@ smc kickoff
 
 ```json
 {
-  "version": "1.0.7",
+  "version": "1.0.11",
   "model": "claude-opus-4.5",
   "agents": {
     "conductor": {
@@ -261,6 +262,55 @@ See **[tests/README.md](tests/README.md)** for detailed test documentation.
 
 ## 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,13 +20,17 @@ 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 (auto-migrates old format)',
-    args: ''
+    args: '[--check-update]'
   },
   migrate: {
     help: 'Migrate old hooks format to new',
@@ -34,7 +38,7 @@ const COMMANDS = {
   },
   template: {
     help: 'Deploy Claude Code project template',
-    args: '[path]'
+    args: '[path] [--safe] [--force] [--help]'
   },
   kickoff: {
     help: 'Start project planning workflow (Manus-style)',
@@ -87,6 +91,78 @@ 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]'
+  },
+  'config:validate': {
+    help: 'Validate configuration files',
+    args: ''
+  },
+  'config:backup': {
+    help: 'Create configuration backup',
+    args: ''
+  },
+  'config:rollback': {
+    help: 'Rollback to previous config',
+    args: '[version]'
+  },
+  'config:diff': {
+    help: 'Show config diff',
+    args: '[file1] [file2]'
+  },
+  'qg:check': {
+    help: 'Run quality gate check',
+    args: '[severity]'
+  },
+  'qg:rules': {
+    help: 'List available quality rules',
+    args: ''
+  },
+  'qg:init': {
+    help: 'Initialize quality gate config',
+    args: ''
+  },
+  changelog: {
+    help: 'Generate changelog from git commits',
+    args: '[--from <tag>] [--to <tag>] [--json]'
   }
 };
 
@@ -114,10 +190,13 @@ function showHelp() {
   console.log('');
   console.log('Examples:');
   console.log('  smc init');
-  console.log('  smc sync            # Auto-migrates old format');
+  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');
+  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');
@@ -126,6 +205,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');
 }
 
 // ============================================================================
@@ -135,6 +220,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
+    }
+  ]
+}