sumulige-claude 1.3.2 → 1.4.0

package/template/README.md

@@ -1,148 +1,618 @@
-# Claude Code 项目模板
+# Sumulige Claude
 
-> 通用 Claude Code 深度集成模板 - 适用于任何项目
+**The Best Agent Harness for Claude Code**
+**Claude Code 的终极 Agent 编排框架**
+
+[![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)
+
+---
+
+## Table of Contents / 目录
+
+1. [Layer 1: What is it? / 第一层：它是什么？](#layer-1-what-is-it--第一层它是什么)
+2. [Layer 2: Why use it? / 第二层：为什么使用它？](#layer-2-why-use-it--第二层为什么使用它)
+3. [Layer 3: Core Concepts / 第三层：核心概念](#layer-3-core-concepts--第三层核心概念)
+4. [Layer 4: Quick Start / 第四层：快速开始](#layer-4-quick-start--第四层快速开始)
+5. [Layer 5: Commands / 第五层：命令参考](#layer-5-commands--第五层命令参考)
+6. [Layer 6: Advanced / 第六层：高级配置](#layer-6-advanced--第六层高级配置)
+7. [Layer 7: Lifecycle Hooks / 第七层：生命周期钩子](#layer-7-lifecycle-hooks--第七层生命周期钩子)
+8. [Layer 8: Data Flow Architecture / 第八层：数据流转架构](#layer-8-data-flow-architecture--第八层数据流转架构)
+9. [Documentation / 文档](#documentation--文档)
+
+---
+
+## Layer 1: What is it? / 第一层：它是什么？
+
+### The 30-Second Version / 30 秒版本
+
+**English** | Sumulige Claude is a CLI tool that makes Claude Code smarter by:
+- Adding specialized AI agents (like a team of experts)
+- Providing ready-to-use project templates
+- Managing reusable "skills" for common tasks
+
+**中文** | Sumulige Claude 是一个让 Claude Code 更聪明的 CLI 工具：
+- 添加专业的 AI Agent（像专家团队）
+- 提供开箱即用的项目模板
+- 管理可复用的"技能"
+
+### The 5-Minute Version / 5 分钟版本
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Without Sumulige Claude                  │
+├─────────────────────────────────────────────────────────────┤
+│  你 ──▶ Claude ──▶ 写代码                                    │
+│  │                                                          │
+│  └─ 每次都要解释项目结构                                     │
+│  └─ 要重复告诉 Claude 代码风格                               │
+│  └─ Claude 不知道你的团队约定                                │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│                    With Sumulige Claude                     │
+├─────────────────────────────────────────────────────────────┤
+│  你 ──▶ Conductor ──▶ Architect ──▶ Builder ──▶ 代码        │
+│       (协调)        (架构)         (实现)                    │
+│                                                             │
+│  ✓ 自动理解项目结构                                          │
+│  ✓ 知道团队代码风格                                          │
+│  ✓ 记住所有历史决策                                          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Layer 2: Why use it? / 第二层：为什么使用它？
+
+### Problem vs Solution / 问题 vs 解决方案
+
+| 问题 | 传统方式 | Sumulige Claude |
+|------|---------|-----------------|
+| **每次都要解释项目结构** | 复制粘贴 README 内容 | `.claude/rag/` 自动存储项目知识 |
+| **代码风格不一致** | 手动告诉 Claude 规则 | Quality Gate 自动检查 |
+| **AI 不记得之前的决策** | 翻聊天记录找答案 | ThinkingLens 记忆所有对话 |
+| **团队成员配置不同** | 各自配置 Claude | `smc sync` 统一环境 |
+| **重复性任务** | 每次重新写 Prompt | Skills 系统，一键调用 |
+
+### Three Key Benefits / 三大核心价值
+
+```
+1. 记忆 (Memory)
+   ┌─────────────────────────────────────────────┐
+   │  ThinkingLens                                │
+   │  ├─ 记住每次对话的上下文                      │
+   │  ├─ 记住项目的架构决策                        │
+   │  └─ 记住代码风格约定                          │
+   └─────────────────────────────────────────────┘
+
+2. 分工 (Specialization)
+   ┌─────────────────────────────────────────────┐
+   │  Multi-Agent System                          │
+   │  ├─ Conductor  → 任务分解                    │
+   │  ├─ Architect  → 架构设计                    │
+   │  ├─ Builder    → 代码实现                    │
+   │  ├─ Reviewer   → 质量检查                    │
+   │  └─ Librarian  → 文档整理                    │
+   └─────────────────────────────────────────────┘
+
+3. 复用 (Reuse)
+   ┌─────────────────────────────────────────────┐
+   │  Skills System                               │
+   │  ├─ 安装社区技能                             │
+   │  ├─ 创建自己的技能                           │
+   │  └─ 团队共享技能库                           │
+   └─────────────────────────────────────────────┘
+```
+
+---
+
+## Layer 3: Core Concepts / 第三层：核心概念
+
+### Concept 1: What is an "Agent"? / 什么是 "Agent"？
+
+**English** | An Agent is like a virtual team member with a specific role. Instead of one AI doing everything, you have specialized AIs working together.
+
+**中文** | Agent 就像是一个有特定职责的虚拟团队成员。不是让一个 AI 做所有事，而是让专业的 AI 协作。
+
+```
+传统方式：
+┌─────────────────────────────────────┐
+│         Claude (通用 AI)             │
+│  写代码 + 审查 + 架构 + 文档         │
+└─────────────────────────────────────┘
+
+Agent 方式：
+┌─────────┐  ┌─────────┐  ┌─────────┐
+│Conductor│─▶│Architect│─▶│ Builder │
+│ 分解任务 │  │ 设计架构 │  │ 实现代码 │
+└─────────┘  └─────────┘  └─────────┘
+                    │
+                    ▼
+              ┌─────────┐
+              │Reviewer │
+              │ 审查代码 │
+              └─────────┘
+```
+
+### Concept 2: What is a "Skill"? / 什么是 "Skill"？
+
+**English** | A Skill is a reusable set of instructions for Claude. Think of it as a "plugin" that gives Claude new capabilities.
+
+**中文** | Skill 是一组可复用的指令，就像是给 Claude 安装"插件"，赋予它新的能力。
+
+```
+Skill = 上下文 + 指令 + 资源
+
+┌─────────────────────────────────────┐
+│  Skill: api-tester                  │
+├─────────────────────────────────────┤
+│  上下文: REST/GraphQL API 测试知识   │
+│  指令: 如何验证 API 响应             │
+│  资源: 测试脚本模板                  │
+└─────────────────────────────────────┘
+```
+
+### Concept 3: What is the Template? / 什么是模板？
+
+**English** | The Template is a pre-configured project structure with all AI settings, hooks, and skills ready to use.
+
+**中文** | 模板是预先配置好的项目结构，包含所有 AI 设置、钩子和技能，开箱即用。
+
+```
+smc template 之后，你的项目会变成：
+
+your-project/
+├── .claude/
+│   ├── commands/      # 斜杠命令定义
+│   ├── skills/        # 技能库
+│   ├── hooks/         # 自动化钩子
+│   ├── rag/           # 项目知识库
+│   └── sessions/      # 对话历史
+├── CLAUDE.md          # AI 配置文件
+└── development/
+    └── todos/         # 任务管理系统
+```
 
 ---
 
-## 快速开始
+## Layer 4: Quick Start / 第四层：快速开始
+
+### Installation / 安装
 
 ```bash
-# 1. 复制整个模板文件夹到你的项目根目录
-cp -r claude-project-template/* /你的项目/
+npm install -g sumulige-claude
+```
 
-# 2. 重命名 CLAUDE-template.md 为 CLAUDE.md
-mv /你的项目/.claude/CLAUDE-template.md /你的项目/.claude/CLAUDE.md
+### Three Commands to Get Started / 三个命令开始使用
 
-# 3. 编辑 CLAUDE.md，填入你的项目信息
-vim /你的项目/.claude/CLAUDE.md
+```bash
+# Step 1: Initialize global config / 初始化全局配置
+smc init
 
-# 4. 给 hooks 添加执行权限
-chmod +x /你的项目/.claude/hooks/*.js
-chmod +x /你的项目/.claude/hooks/*.sh
+# Step 2: Deploy to your project / 部署到项目
+mkdir my-project && cd my-project
+smc template
 
-# 5. 配置 Claude Code（如果还没配置）
-vim /你的项目/.claude/settings.json
+# Step 3: Start planning / 开始规划
+smc kickoff
 ```
 
+### What Each Command Does / 每个命令做什么
+
+| 命令 | 做什么 | 类比 |
+|------|--------|------|
+| `smc init` | 创建 `~/.claude/config.json` | 买房前准备工具箱 |
+| `smc template` | 复制模板到项目 | 装修新房子 |
+| `smc kickoff` | 启动项目规划 | 开工典礼 |
+
 ---
 
-## 文件结构
+## Layer 5: Commands / 第五层：命令参考
+
+### Command Groups / 命令分组
 
 ```
-claude-project-template/
-├── README.md                   # 本文件
-├── init.sh                     # 一键初始化脚本 ⭐
-├── project-paradigm.md         # 通用项目开发范式 ⭐
-├── CLAUDE-template.md          # CLAUDE.md 模板
-├── thinkinglens-silent.md      # 无感知追踪说明
-└── .claude/
-    ├── CLAUDE-template.md      # 项目 CLAUDE.md 模板
-    ├── settings.json           # Claude Code 配置模板
-    ├── hooks/
-    │   ├── thinking-silent.js  # 无感知对话追踪 Hook
-    │   ├── tl-summary.sh       # 查看对话摘要脚本
-    │   ├── sync-to-log.sh      # 同步对话到 PROJECT_LOG.md ⭐
-    │   └── session-end.sh      # 退出时保存摘要（可选）
-    └── thinking-routes/
-        └── QUICKREF.md         # 对话查找速查卡
+┌─────────────────────────────────────────────────────────────┐
+│  基础命令 (每次使用都需要)                                    │
+├─────────────────────────────────────────────────────────────┤
+│  smc init          初始化全局配置                            │
+│  smc status        查看当前状态                              │
+│  smc sync          同步到当前项目（增量）                     │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  项目命令 (新项目启动时使用)                                  │
+├─────────────────────────────────────────────────────────────┤
+│  smc template      部署项目模板                              │
+│  smc kickoff       启动项目规划                              │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  技能命令 (管理 Claude 能力)                                 │
+├─────────────────────────────────────────────────────────────┤
+│  smc skill:list    列出已安装技能                            │
+│  smc marketplace:list  浏览技能市场                          │
+│  smc marketplace:install <name>  安装技能                   │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  配置命令 (高级配置)                                          │
+├─────────────────────────────────────────────────────────────┤
+│  smc config:validate   验证配置文件                          │
+│  smc config:backup     创建配置备份                          │
+│  smc qg:check          运行质量检查                          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Command Flow / 命令流程
+
+```
+新项目流程：
+┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
+│  新建   │──▶ │ smc     │──▶ │ smc     │──▶ │ smc     │
+│  项目   │    │ template │    │ kickoff │    │  开发   │
+└─────────┘    └─────────┘    └─────────┘    └─────────┘
+
+已有项目：
+┌─────────┐    ┌─────────┐    ┌─────────┐
+│ 进入    │──▶ │ smc     │──▶ │  开发   │
+│ 项目    │    │ sync    │    │         │
+└─────────┘    └─────────┘    └─────────┘
 ```
 
 ---
 
-## 核心特性
+## Layer 5.5: Core Skills / 核心技能系统
+
+### 4 Core Skills / 4 个核心技能
+
+> v2.0.0 优化：将 9 个技能合并为 4 个核心技能，成本降低 60-70%
+
+| Skill | 命令 | 模型 | 作用 |
+|-------|------|------|------|
+| `quality-guard` | `/review` | sonnet | 代码审查 + 安全检查 + 清理建议 |
+| `test-master` | `/test` | sonnet | TDD + E2E + 覆盖率分析 |
+| `design-brain` | `/plan` | opus | 规划 + 架构设计 |
+| `quick-fix` | `/fix` | haiku | 快速修复构建/类型/lint 错误 |
+
+### Quick Reference / 命令速查
+
+```bash
+# 代码审查
+/review              # 标准审查
+/review --security   # 安全深扫 (OWASP Top 10)
+/review --clean      # 死代码清理
+
+# 测试
+/test                # 运行测试
+/test --tdd          # TDD 模式
+/test --e2e          # E2E 测试
+/test --coverage     # 覆盖率
+
+# 规划
+/plan                # 快速规划
+/plan --deep         # 深度设计
+
+# 快速修复
+/fix                 # 自动检测修复
+/fix --build         # 构建错误
+/fix --type          # 类型错误
+
+# 重构
+/refactor            # 分析建议
+/refactor --execute  # 执行清理
+```
 
-### 1. AI 自治记忆系统
-- **ANCHORS.md** - 锚点索引，快速定位模块
-- **MEMORY.md** - 增量记忆日志
-- **PROJECT_LOG.md** - 完整项目构建历史
-- **CLAUDE.md** - 项目核心知识
+### Model Cost Strategy / 模型成本策略
 
-### 2. 无感知追踪
-- **thinking-silent.js** - 零输出、自动追踪对话
-- **每 20 轮自动同步** - 对话摘要自动追加到 PROJECT_LOG.md ⭐
-- **tl-summary.sh** - 按需查看对话摘要
-- 数据本地存储，隐私安全
+```
+┌─────────┬─────────────────────┬──────────┬────────┐
+│  模型   │      使用场景        │ 相对成本 │  速度  │
+├─────────┼─────────────────────┼──────────┼────────┤
+│ haiku   │ /fix 快速修复        │   1x     │  最快  │
+│ sonnet  │ /review, /test      │   5x     │  中等  │
+│ opus    │ /plan --deep        │  15x     │  较慢  │
+└─────────┴─────────────────────┴──────────┴────────┘
+```
 
-### 3. 项目范式
-- **Personal Panopticon** - 个人全景塔理念
-- **锚点系统** - `[类型:名称]` 索引规范
-- **Skills 模板** - 领域知识库结构
-- **Hooks 配置** - 自动化钩子示例
+详细使用指南: [.claude/USAGE.md](.claude/USAGE.md)
 
 ---
 
-## 配置说明
+## Layer 6: Advanced / 第六层：高级配置
 
-### settings.json
+### Multi-Agent Configuration / 多 Agent 配置
+
+**English** | Each agent can be customized with its own model and role description.
+
+**中文** | 每个 Agent 都可以自定义模型和职责描述。
 
 ```json
 {
-  "matcher": "UserPromptSubmit|PreToolUse|PostToolUse",
-  "hooks": [{
-    "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.js",
-    "timeout": 1
-  }]
+  "version": "1.2.0",
+  "model": "claude-opus-4.5",
+  "agents": {
+    "conductor": {
+      "role": "任务协调与分解 - 理解需求并分配给合适的 Agent",
+      "model": "claude-opus-4.5"
+    },
+    "architect": {
+      "role": "架构设计 - 设计系统架构和技术选型",
+      "model": "claude-sonnet-4.5"
+    },
+    "builder": {
+      "role": "代码实现 - 编写高质量代码和测试",
+      "model": "claude-sonnet-4.5"
+    },
+    "reviewer": {
+      "role": "代码审查 - 检查代码质量和安全问题",
+      "model": "claude-opus-4.5"
+    },
+    "librarian": {
+      "role": "文档管理 - 整理文档和知识库",
+      "model": "claude-haiku-4.5"
+    }
+  },
+  "skills": [
+    "anthropics/skills",
+    "numman-ali/n-skills"
+  ],
+  "thinkingLens": {
+    "enabled": true,
+    "autoSync": true,
+    "syncInterval": 20
+  }
 }
 ```
 
-### CLAUDE.md 模板
+### Quality Gate / 质量门禁
 
-编辑以下部分：
+**English** | Automatically check code quality before commits.
 
-```markdown
-## Project Vision
-[你的项目愿景]
+**中文** | 提交前自动检查代码质量。
 
-## Stack
-[技术栈：React, TypeScript, Node.js...]
+```json
+{
+  "enabled": true,
+  "severity": "warn",
+  "rules": [
+    { "id": "line-count-limit", "enabled": true },
+    { "id": "no-console-logs", "enabled": true }
+  ],
+  "gates": {
+    "preCommit": true,
+    "prePush": true
+  }
+}
+```
 
-## Common Commands
-[常用命令]
+### Skills Marketplace / 技能市场
+
+```bash
+# Browse available skills / 浏览可用技能
+smc marketplace:list
+
+# Install a skill / 安装技能
+smc marketplace:install dev-browser
+
+# Create your own skill / 创建自己的技能
+smc skill:create my-skill
 ```
 
 ---
 
-## 使用命令
+## Layer 7: Lifecycle Hooks / 第七层：生命周期钩子
 
-```bash
-# 一键初始化（推荐）
-/path/to/claude-project-template/init.sh .
+### Auto-Sync System / 自动同步系统
 
-# 查看对话摘要
-tl                    # 或 .claude/hooks/tl-summary.sh
+> v1.3.2: 利用 Claude Code 官方 Hook 事件实现记忆自动同步
 
-# 手动同步到日志
-.claude/hooks/sync-to-log.sh
+```
+┌─────────────────────────────────────────────────────────────┐
+│  SessionStart ──► memory-loader.cjs                         │
+│    └─ 自动加载 MEMORY.md, ANCHORS.md, TODO 状态              │
+│                                                              │
+│  PreCompact ──► auto-handoff.cjs                            │
+│    └─ 上下文压缩前自动生成 handoff 文档                       │
+│                                                              │
+│  SessionEnd ──► memory-saver.cjs                            │
+│    └─ 会话结束自动保存摘要到 MEMORY.md                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Hook Files / 钩子文件
+
+| Hook | 文件 | 触发时机 | 功能 |
+|------|------|----------|------|
+| `SessionStart` | `memory-loader.cjs` | 会话开始 | 加载记忆、锚点、TODO |
+| `SessionEnd` | `memory-saver.cjs` | 会话结束 | 保存摘要、归档会话 |
+| `PreCompact` | `auto-handoff.cjs` | 上下文压缩前 | 生成 handoff 保护上下文 |
 
-# 查看项目日志
-cat .claude/PROJECT_LOG.md
+### Handoff Documents / 交接文档
 
-# 查看记忆变更
-cat .claude/MEMORY.md
+当上下文即将被压缩时，自动生成交接文档：
+
+```
+.claude/handoffs/
+├── LATEST.md           # 最新交接文档
+├── INDEX.md            # 交接文档索引
+└── handoff_*.md        # 历史交接文档
+```
+
+每个交接文档包含：
+- 会话信息（项目、版本、开始时间）
+- 活跃 TODOs 列表
+- 最近修改的文件
+- 恢复命令
+
+### Update Hooks / 更新钩子
+
+其他项目如何获取新 hooks：
+
+```bash
+# 方式 1: 完整更新（推荐）
+smc template --force
+
+# 方式 2: 增量同步（仅更新 hooks）
+smc sync --hooks
+
+# 方式 3: 手动安装
+npm update -g sumulige-claude
+smc template
 ```
 
 ---
 
-## 成功标准
+## Layer 8: Data Flow Architecture / 第八层：数据流转架构
+
+> v1.4.0: Hook 统一调度 + 智能过滤，Token 成本降低 62%
 
-完成后，项目应该具备：
+### Hook 调度流程
 
-- ✅ AI 能够理解项目规范并生成符合标准的代码
-- ✅ AI 启动时自动加载完整上下文
-- ✅ 关键决策可追溯（ThinkingLens）
-- ✅ 知识可累积（Skills 系统）
-- ✅ 记忆可同步（Hooks）
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           Claude Code 事件触发                            │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+                                    ▼
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         settings.json 路由                               │
+├─────────────────────────────────────────────────────────────────────────┤
+│  SessionStart  ──────→ memory-loader.cjs (直接执行)                      │
+│  SessionEnd    ──────→ memory-saver.cjs (直接执行)                       │
+│  PreCompact    ──────→ auto-handoff.cjs (直接执行)                       │
+│  UserPromptSubmit ───→ hook-dispatcher.cjs                              │
+│  PreToolUse    ──────→ (空，不执行任何 hook)                              │
+│  PostToolUse   ──────→ code-formatter.cjs (仅 Write/Edit 时)            │
+│  AgentStop     ──────→ hook-dispatcher.cjs                              │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### Hook Dispatcher 内部流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                      hook-dispatcher.cjs                                 │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+                    ┌───────────────┼───────────────┐
+                    ▼               ▼               ▼
+            ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
+            │ 加载 Registry│ │  加载 State │ │ 获取事件类型 │
+            │ hook-registry│ │ .dispatcher │ │CLAUDE_EVENT │
+            │    .json    │ │ -state.json │ │   _TYPE     │
+            └─────────────┘ └─────────────┘ └─────────────┘
+                    │               │               │
+                    └───────────────┼───────────────┘
+                                    ▼
+                    ┌───────────────────────────────┐
+                    │      筛选当前事件的 Hooks      │
+                    └───────────────────────────────┘
+                                    │
+                                    ▼
+            ┌───────────────────────────────────────────────┐
+            │              对每个 Hook 检查                  │
+            ├───────────────────────────────────────────────┤
+            │  1. shouldRunDebounce() - 5秒内执行过? → 跳过  │
+            │  2. shouldRunOnce() - 已执行过? → 跳过         │
+            │  3. shouldRunCondition() - 条件不满足? → 跳过  │
+            └───────────────────────────────────────────────┘
+                                    │
+                                    ▼
+                    ┌───────────────────────────────┐
+                    │   执行通过检查的 Hook + 更新状态 │
+                    └───────────────────────────────┘
+```
+
+### 增量同步流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    smc sync --incremental                                │
+└─────────────────────────────────────────────────────────────────────────┘
+                                    │
+        ┌───────────────────────────┼───────────────────────────┐
+        ▼                           ▼                           ▼
+┌───────────────┐         ┌───────────────┐         ┌───────────────┐
+│ 读取项目版本   │         │ 读取版本清单   │         │  计算差异变更  │
+│ .sumulige-    │         │ version-      │         │ getChangesSince│
+│ claude-version│         │ manifest.json │         │   (1.3.3)     │
+└───────────────┘         └───────────────┘         └───────────────┘
+                                    │
+                                    ▼
+            ┌───────────────────────────────────────────────┐
+            │  应用变更: hook/config/lib/command            │
+            │  更新项目版本标记                              │
+            └───────────────────────────────────────────────┘
+```
+
+### 状态文件汇总
+
+| 文件 | 用途 | 生命周期 |
+|------|------|----------|
+| `.dispatcher-state.json` | Hook 执行状态 | 会话级 |
+| `.match-cache.json` | RAG 匹配缓存 | 5 分钟 TTL |
+| `.sumulige-claude-version` | 项目版本标记 | 永久 |
+
+---
+
+## Documentation / 文档
+
+- **[Development Guide / 开发指南](docs/DEVELOPMENT.md)** - Architecture, adding skills / 架构、添加技能
+- **[Marketplace Guide / 市场指南](docs/MARKETPLACE.md)** - Skill marketplace user guide / 技能市场用户指南
+- **[Q&A / 常见问题](Q&A.md)** - Core design concepts explained / 核心设计理念解释
 
 ---
 
-## 更多文档
+## Changelog / 更新日志
+
+### v1.2.0 (2026-01-17)
+
+**English** | Comprehensive regression test suite.
+
+**中文** | 完整的回归测试套件。
+
+- **Test Coverage / 测试覆盖**
+  - 219 new tests across 6 modules / 6 个模块新增 219 个测试
+  - errors.js: 100% statement coverage / 100% 语句覆盖率
+  - quality-gate.js: 95.59% statement coverage / 95.59% 语句覆盖率
+  - quality-rules.js: 86.17% statement coverage / 86.17% 语句覆盖率
+  - config-manager.js: 91.66% statement coverage / 91.66% 语句覆盖率
+  - config-validator.js: 77.41% statement coverage / 77.41% 语句覆盖率
+  - version-check.js: 55.07% statement coverage / 55.07% 语句覆盖率
+
+### v1.1.1 (2026-01-16)
+
+**English** | Config validation and quality gate system.
+
+**中文** | 配置验证和质量门禁系统。
 
-- `project-paradigm.md` - 详细的开发范式说明
-- `thinkinglens-silent.md` - 无感知追踪原理
-- `.claude/thinking-routes/QUICKREF.md` - 对话查找速查
+- **Config System / 配置系统**
+  - JSON Schema validation for all configs / 所有配置的 JSON Schema 验证
+  - Backup/rollback functionality / 备份回滚功能
+  - Environment variable expansion / 环境变量展开
+- **Quality Gate / 质量门禁**
+  - 8 built-in quality rules / 8 条内置质量规则
+  - Pre-commit/pre-push Git hooks / Git 钩子
+  - Configurable severity levels / 可配置严重级别
+
+### v1.1.0 (2026-01-15)
+
+**English** | Skill Marketplace with auto-sync.
+
+**中文** | 技能市场，支持自动同步。
+
+- Marketplace system with 6 new commands / 市场系统，6 个新命令
+- Auto-sync via GitHub Actions / GitHub Actions 自动同步
+- 20+ built-in skills / 20+ 内置技能
 
 ---
 
-**记住**：目标不是让 AI 帮你写代码，而是让 AI 成为你思维的延伸。
+## License / 许可证
+
+MIT © [sumulige](https://github.com/sumulige)
+
+---
 
-"Take the tower early. Do not let it take you."
+**Happy Coding with AI! / 祝编码愉快! 🚀**