sumulige-claude 1.0.9 → 1.1.0

package/.versionrc

@@ -0,0 +1,25 @@
+{
+  "types": [
+    { "type": "feat", "section": "Added" },
+    { "type": "fix", "section": "Fixed" },
+    { "type": "chore", "hidden": false },
+    { "type": "docs", "section": "Changed", "hidden": false },
+    { "type": "style", "hidden": true },
+    { "type": "refactor", "section": "Changed" },
+    { "type": "perf", "section": "Changed" },
+    { "type": "test", "hidden": false }
+  ],
+  "commitUrlFormat": "https://github.com/sumulige/sumulige-claude/commits/{{hash}}",
+  "compareUrlFormat": "https://github.com/sumulige/sumulige-claude/compare/{{previousTag}}...{{currentTag}}",
+  "issueUrlFormat": "https://github.com/sumulige/sumulige-claude/issues/{{id}}",
+  "bumpFiles": [
+    {
+      "filename": "package.json",
+      "type": "json"
+    }
+  ],
+  "skip": {
+    "tag": true,
+    "commit": false
+  }
+}

package/AGENTS.md

@@ -2,91 +2,176 @@
 
 <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>API testing and HTTP request validation tool for REST/GraphQL endpoints</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>test-workflow</name>
+<description>Automated testing workflow that combines Playwright testing, Slack GIF recording, and test report generation. Use when user mentions "测试"、"test"、"Playwright" or asks for QA/testing workflows. Automatically generates: (1) Test execution with Playwright, (2) Slack-optimized GIF of test process, (3) Screenshot at each verification point, (4) Markdown test report with embedded screenshots.</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/CHANGELOG.md

@@ -1,9 +1,88 @@
-# Changelog
+## [Unreleased] (2026-01-15)
 
-All notable changes to this project will be documented in this file.
+### ✨ Features
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+- kickoff creates tasks in backlog (d1a6f958)
+- add 'help' command as alias (697d5ef2)
+- add --check-update flag to sync command (b8ab1131)
+- add version update check (stage 1 & 2) (dd116a75)
+- add safety options to smc template command (74441b8f)
+- upgrade todo-manager to v2.0 with R-D-T lifecycle (16e8f7ea)
+- add test-workflow skill and enhance CLI commands (972a6762)
+
+### 📝 Documentation
+
+- add Q4 for version update flow (16c43298)
+- add Q3 for smc template vs sync comparison (346e9a6e)
+
+### 🧹 Chores
+
+- **release**: 1.1.0 (ba1afd24)
+
+## [1.1.0](https://github.com/sumulige/sumulige-claude/compare/v1.0.11...v1.1.0) (2026-01-15)
+
+
+### Changed
+
+* sync documentation with v1.0.11 ([b00c509](https://github.com/sumulige/sumulige-claude/commits/b00c50928038bf8a4a655e81712420cd3294935d))
+
+
+* add standard-version for automated releases ([32522fa](https://github.com/sumulige/sumulige-claude/commits/32522fa912dd26a4540cba10532c24d4e29e6daf))
+
+
+### Added
+
+* add test-workflow skill and enhance CLI commands ([972a676](https://github.com/sumulige/sumulige-claude/commits/972a6762411c5f863d9bfa3e360df7dc7f379aab))
+
+## [1.0.11] - 2026-01-15
+
+### Added
+- Complete test suite with 78 tests across 5 modules
+- Version-aware migration system (`lib/migrations.js`)
+- `smc migrate` command for manual migration
+- Auto-migration of old hooks format on `smc sync`
+- Code simplifier integration
+
+### Changed
+- Modularized codebase for better maintainability
+
+### Fixed
+- Test coverage improvements
+
+## [1.0.10] - 2026-01-15
+
+### Added
+- Conversation logger Hook (`conversation-logger.cjs`)
+- Automatic conversation recording to `DAILY_CONVERSATION.md`
+- Date-grouped conversation history
+
+### Fixed
+- Auto-migration for old hooks format
+
+## [1.0.9] - 2026-01-15
+
+### Fixed
+- Clean up stale session entries
+
+## [1.0.8] - 2026-01-14
+
+### Added
+- Skill Marketplace system with external repository support
+- Auto-sync mechanism via GitHub Actions (daily schedule)
+- 6 new marketplace commands: `list`, `install`, `sync`, `add`, `remove`, `status`
+- Claude Code native plugin registry (`.claude-plugin/marketplace.json`)
+- Skill categorization system (7 categories)
+- Development documentation (`docs/DEVELOPMENT.md`)
+- Marketplace user guide (`docs/MARKETPLACE.md`)
+
+### Changed
+- Refactored CLI into modular architecture (`lib/` directory)
+- Streamlined README with dedicated documentation files
+
+## [1.0.7] - 2026-01-13
+
+### Changed
+- Project template updates
 
 ## [1.0.6] - 2026-01-14
 

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)*