sumulige-claude 1.2.1 → 1.3.0

package/.claude/.kickoff-hint.txt

@@ -49,4 +49,4 @@
 
 💡 提示: 你也可以直接说 "跳过启动" 使用传统开发模式
 
-生成日期: 2026-01-18
+生成日期: 2026-01-22

package/.claude/AGENTS.md

@@ -6,10 +6,6 @@
 
 This project uses **Sumulige Claude** for multi-agent collaboration.
 
-### conductor
-- **Model**: claude-opus-4-5-20251101
-- **Role**: Task coordination and decomposition
-
 ### architect
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Architecture design and decisions
@@ -18,14 +14,18 @@ This project uses **Sumulige Claude** for multi-agent collaboration.
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Code implementation and testing
 
-### reviewer
+### conductor
 - **Model**: claude-opus-4-5-20251101
-- **Role**: Code review and quality check
+- **Role**: Task coordination and decomposition
 
 ### librarian
 - **Model**: claude-opus-4-5-20251101
 - **Role**: Documentation and knowledge
 
+### reviewer
+- **Model**: claude-opus-4-5-20251101
+- **Role**: Code review and quality check
+
 ## Usage
 
 ```bash

package/.claude/USAGE.md

@@ -0,0 +1,175 @@
+# Skills 系统使用手册
+
+> 版本: 2.0.0 | 更新日期: 2026-01-22
+
+---
+
+## 核心 Skills
+
+| Skill | 命令 | 触发时机 | 作用 | 模型 |
+|-------|------|---------|------|------|
+| `quality-guard` | `/review` | 提交前、PR 审查 | 代码质量 + 安全检查 + 清理建议 | sonnet |
+| `test-master` | `/test` | 实现功能后 | TDD + E2E + 覆盖率分析 | sonnet |
+| `design-brain` | `/plan` | 开始新任务前 | 规划 + 架构设计 | opus |
+| `quick-fix` | `/fix` | 构建失败时 | 快速修复错误 | haiku |
+
+---
+
+## 命令速查表
+
+### /review - 代码审查
+
+```bash
+/review              # 标准代码审查
+/review --security   # 安全深度扫描 (OWASP Top 10)
+/review --clean      # 死代码清理建议
+/review --all        # 完整审查
+```
+
+**触发时机**:
+- 准备提交代码前
+- PR 审查时
+- 怀疑有安全问题时
+
+### /test - 测试
+
+```bash
+/test                # 运行单元测试
+/test --tdd          # TDD 开发模式 (RED→GREEN→REFACTOR)
+/test --e2e          # E2E 测试 (Playwright)
+/test --coverage     # 覆盖率报告
+/test --all          # 完整测试套件
+```
+
+**触发时机**:
+- 完成功能实现后
+- 修复 bug 后
+- 提交前验证
+
+### /plan - 规划
+
+```bash
+/plan                # 快速规划（默认）
+/plan --deep         # 深度设计（架构决策）
+/plan --arch         # 仅架构设计
+```
+
+**触发时机**:
+- 开始新功能开发前
+- 重大重构前
+- 技术选型时
+
+### /fix - 快速修复
+
+```bash
+/fix                 # 自动检测并修复
+/fix --build         # 修复构建错误
+/fix --lint          # 修复 lint 错误
+/fix --type          # 修复类型错误
+/fix --all           # 修复所有错误
+```
+
+**触发时机**:
+- `npm run build` 失败
+- `tsc` 报类型错误
+- ESLint 报错
+
+### /refactor - 重构
+
+```bash
+/refactor            # 分析并建议清理
+/refactor --dead     # 查找死代码
+/refactor --deps     # 查找未使用依赖
+/refactor --duplicate # 查找重复代码
+/refactor --execute  # 执行清理（需确认）
+```
+
+**触发时机**:
+- 代码库变大需要清理
+- 发现重复代码
+- 依赖需要整理
+
+---
+
+## 模型成本策略
+
+| 模型 | 使用场景 | 相对成本 | 速度 |
+|------|---------|---------|------|
+| **haiku** | `/fix` 快速修复 | 1x (最低) | 最快 |
+| **sonnet** | `/review`, `/test` 标准任务 | 5x | 中等 |
+| **opus** | `/plan --deep` 复杂架构 | 15x | 较慢 |
+
+**自动选择规则**:
+- 简单修复 → haiku（节省成本）
+- 代码审查/测试 → sonnet（平衡性价比）
+- 架构设计 → opus（仅在需要深度分析时）
+
+---
+
+## 工作流示例
+
+### 新功能开发
+
+```
+1. /plan              # 规划实现步骤
+2. 编写代码           # 实现功能
+3. /fix               # 修复编译错误
+4. /test --tdd        # 补充测试
+5. /review            # 代码审查
+6. /commit            # 提交代码
+```
+
+### Bug 修复
+
+```
+1. /test              # 确认失败的测试
+2. 修复代码           # 实现修复
+3. /fix               # 确保编译通过
+4. /test              # 验证测试通过
+5. /review --security # 安全检查
+6. /commit            # 提交修复
+```
+
+### 代码清理
+
+```
+1. /refactor          # 分析代码库
+2. /refactor --dead   # 找死代码
+3. /refactor --deps   # 找未用依赖
+4. /refactor --execute # 执行清理
+5. /test              # 确保不破坏功能
+6. /commit            # 提交清理
+```
+
+---
+
+## 自动加载
+
+Skills 会根据用户输入自动加载：
+
+```json
+{
+  "auto_load": {
+    "enabled": true,
+    "confidence_threshold": 0.7,
+    "max_skills_per_task": 3
+  }
+}
+```
+
+**关键词触发示例**:
+- "review code" → `quality-guard`
+- "fix build error" → `quick-fix`
+- "plan architecture" → `design-brain`
+- "run tests" → `test-master`
+
+---
+
+## 配置文件
+
+| 文件 | 说明 |
+|------|------|
+| `.claude/rag/skill-index.json` | Skill 索引和模型策略 |
+| `.claude/skills/*/metadata.yaml` | 各 Skill 配置 |
+| `.claude/skills/*/SKILL.md` | Skill 详细指令 |
+| `.claude/commands/*.md` | 命令定义 |

package/.claude/commands/fix.md

@@ -0,0 +1,83 @@
+---
+description: Quick fix for build, lint, and type errors
+---
+
+# /fix
+
+快速修复构建错误、lint 错误、类型错误。
+
+## 使用方式
+
+```bash
+/fix              # 自动检测并修复（默认）
+/fix --build      # 修复构建错误
+/fix --lint       # 修复 lint 错误
+/fix --type       # 修复类型错误
+/fix --all        # 修复所有错误
+```
+
+## 关联 Skill
+
+此命令加载 `quick-fix` skill（使用 haiku 模型，快速响应）。
+
+---
+
+## 工作流程
+
+### Step 1: 错误检测
+
+```bash
+# 构建错误
+npm run build 2>&1 | head -100
+
+# 类型错误
+npx tsc --noEmit 2>&1 | head -50
+
+# Lint 错误
+npx eslint . --format json 2>&1 | head -100
+```
+
+### Step 2: 错误分类
+
+| 类型 | 示例 | 策略 |
+|------|------|------|
+| 类型错误 | `TS2345` | 添加类型或断言 |
+| 导入错误 | `Cannot find module` | 检查路径 |
+| 语法错误 | `Unexpected token` | 修复语法 |
+| Lint 错误 | `no-unused-vars` | 删除或使用 |
+
+### Step 3: 增量修复
+
+```
+原则：每次只修复一个错误
+
+1. 读取第一个错误
+2. 定位文件和行号
+3. 应用最小修复
+4. 重新编译验证
+5. 重复直到全部修复
+```
+
+### Step 4: 输出报告
+
+```markdown
+# Quick Fix Report
+
+## Errors Found: X
+## Fixed: Y
+## Remaining: Z
+
+| File | Line | Error | Fix |
+|------|------|-------|-----|
+
+## Build Status
+✅ SUCCESS / ❌ FAILED
+```
+
+---
+
+## 原则
+
+- **快速** - 使用轻量模型
+- **最小** - 只做必要修改
+- **安全** - 不确定的不修复

package/.claude/commands/plan.md

@@ -0,0 +1,88 @@
+---
+description: Plan implementation with architecture design
+---
+
+# /plan
+
+为功能或任务创建实现计划，支持快速规划和深度设计。
+
+## 使用方式
+
+```bash
+/plan              # 快速规划（默认）
+/plan --deep       # 深度设计（架构决策）
+/plan --arch       # 仅架构设计
+```
+
+## 关联 Skill
+
+此命令加载 `design-brain` skill（复杂任务使用 opus）。
+
+---
+
+## 工作流程
+
+### 快速规划（默认）
+
+```markdown
+# Plan: [功能名称]
+
+## Goal
+[一句话描述]
+
+## Steps
+1. [ ] [步骤 1]
+2. [ ] [步骤 2]
+3. [ ] [步骤 3]
+
+## Files
+- `path/to/file.ts` - [修改内容]
+
+## Risk
+- [主要风险] → [缓解策略]
+```
+
+### 深度设计（--deep）
+
+```markdown
+# Design: [系统名称]
+
+## Overview
+[背景和目标]
+
+## Architecture
+[组件图 + 数据流]
+
+## Technical Decisions
+| Decision | Choice | Reason | Trade-offs |
+|----------|--------|--------|------------|
+
+## Implementation Plan
+### Phase 1: [阶段名]
+1. [ ] Step 1
+2. [ ] Step 2
+
+## Risks
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+
+## Success Criteria
+- [ ] 标准 1
+- [ ] 标准 2
+```
+
+---
+
+## 设计原则
+
+1. **简单优于复杂** - 能用简单方案就不要复杂化
+2. **最小变更** - 优先复用现有代码
+3. **可测试性** - 每个步骤都可验证
+
+## 使用场景
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 小功能/bug 修复 | 快速规划 |
+| 新模块/系统 | 深度设计 |
+| 技术选型 | --arch |

package/.claude/commands/refactor.md

@@ -0,0 +1,102 @@
+---
+description: Safe code refactoring and cleanup
+---
+
+# /refactor
+
+安全的代码重构和清理。
+
+## 使用方式
+
+```bash
+/refactor              # 分析并建议清理（默认）
+/refactor --dead       # 查找死代码
+/refactor --deps       # 查找未使用依赖
+/refactor --duplicate  # 查找重复代码
+/refactor --execute    # 执行清理（需确认）
+```
+
+## 关联 Skill
+
+此命令加载 `quality-guard` skill（清理模式）。
+
+---
+
+## 工作流程
+
+### Step 1: 运行分析工具
+
+```bash
+# 未使用的文件、导出、依赖
+npx knip
+
+# 未使用的 npm 依赖
+npx depcheck
+
+# 未使用的 TypeScript 导出
+npx ts-prune
+
+# 未使用的 eslint-disable
+npx eslint . --report-unused-disable-directives
+```
+
+### Step 2: 风险分类
+
+| 风险 | 类型 | 处理 |
+|------|------|------|
+| 🟢 SAFE | 未使用导出、测试文件 | 可直接删除 |
+| 🟡 CAREFUL | 动态导入可能使用 | 需验证 |
+| 🔴 RISKY | 公共 API、配置文件 | 谨慎处理 |
+
+### Step 3: 生成报告
+
+```markdown
+# Refactor Report
+
+## Dead Code
+| File | Type | Risk | Reason |
+|------|------|------|--------|
+
+## Unused Dependencies
+| Package | Size | Last Used |
+|---------|------|-----------|
+
+## Duplicate Code
+| Location 1 | Location 2 | Lines |
+|------------|------------|-------|
+
+## Recommended Actions
+1. [ ] Remove unused-package (SAFE)
+2. [ ] Delete src/old.ts (SAFE)
+3. [ ] Review src/utils.ts (CAREFUL)
+
+## Impact
+- Files to delete: X
+- Dependencies to remove: Y
+- Lines of code: -Z
+```
+
+### Step 4: 执行清理（--execute）
+
+```
+⚠️ 执行前：
+1. 创建备份分支
+2. 确保测试通过
+3. 逐个删除，每删一个运行测试
+4. 记录到 DELETION_LOG.md
+```
+
+---
+
+## 安全检查清单
+
+删除前：
+- [ ] grep 所有引用
+- [ ] 检查动态导入
+- [ ] 查看 git 历史
+- [ ] 运行所有测试
+
+删除后：
+- [ ] 构建成功
+- [ ] 测试通过
+- [ ] 提交变更

package/.claude/hooks/pre-push.cjs

@@ -41,7 +41,8 @@ async function main() {
       stdio: 'pipe'
     }).trim() || 'origin/main';
 
-    const output = execSync(`git diff --name-only ${upstream}...HEAD`, {
+    // Use --diff-filter=ACMR to exclude deleted files (D)
+    const output = execSync(`git diff --name-only --diff-filter=ACMR ${upstream}...HEAD`, {
       encoding: 'utf-8',
       stdio: 'pipe'
     });
@@ -85,7 +86,7 @@ async function main() {
 
   const result = await gate.check({
     files: checkable.map(f => path.join(projectDir, f)),
-    severity: 'warn' // Block on warnings too for push
+    severity: 'error' // Only block on errors, not warnings
   });
 
   if (!result.passed) {

package/.claude/rag/skill-index.json

@@ -1,6 +1,7 @@
 {
-  "version": "1.0.0",
-  "last_updated": "2026-01-11",
+  "version": "2.0.0",
+  "last_updated": "2026-01-22",
+  "description": "Optimized skill index - merged 9 skills into 4 core skills",
   "skills": [
     {
       "name": "frontend-design",
@@ -46,7 +47,7 @@
     },
     {
       "name": "webapp-testing",
-      "keywords": ["test", "testing", "playwright", "browser", "automation", "e2e", "screenshot"],
+      "keywords": ["browser", "automation", "screenshot", "puppeteer", "scraping"],
       "description": "Toolkit for interacting with and testing local web applications using Playwright",
       "trigger": "when testing frontend functionality, debugging UI behavior, or capturing browser screenshots"
     },
@@ -105,22 +106,32 @@
       "trigger": "for complex artifacts requiring state management, routing, or shadcn/ui components"
     },
     {
-      "name": "dev-browser",
-      "keywords": ["browser", "scraping", "automation", "puppet", "playwright", "web"],
-      "description": "Browser automation with persistent state for testing and scraping",
-      "trigger": "when needing browser automation or web scraping capabilities"
+      "name": "quality-guard",
+      "keywords": ["review", "security", "quality", "lint", "code review", "vulnerability", "owasp", "dead code", "refactor", "cleanup"],
+      "description": "Code quality guardian - merged: code review + security check + dead code cleanup. Supports --security, --clean modes.",
+      "trigger": "when reviewing code, checking security, or cleaning up dead code",
+      "model": "sonnet"
     },
     {
-      "name": "zai-cli",
-      "keywords": ["z.ai", "vision", "search", "github", "exploration", "analysis"],
-      "description": "Z.AI vision, search, and GitHub exploration CLI tools",
-      "trigger": "when needing vision analysis, web search, or GitHub repository exploration"
+      "name": "test-master",
+      "keywords": ["test", "tdd", "e2e", "playwright", "coverage", "unit test", "jest", "vitest"],
+      "description": "Test master - merged: TDD workflow + E2E testing. Supports --tdd, --e2e, --coverage modes.",
+      "trigger": "when writing tests, doing TDD, running E2E tests, or checking coverage",
+      "model": "sonnet"
     },
     {
-      "name": "gastown",
-      "keywords": ["gastown", "multi-agent", "orchestrator", "coordination"],
-      "description": "Multi-agent orchestrator for complex task coordination",
-      "trigger": "when orchestrating multiple agents for complex workflows"
+      "name": "design-brain",
+      "keywords": ["plan", "design", "architecture", "system design", "technical decision", "strategy"],
+      "description": "Design brain - merged: planner + architect. Supports --quick (default) and --deep modes.",
+      "trigger": "when planning implementation or making architecture decisions",
+      "model": "opus"
+    },
+    {
+      "name": "quick-fix",
+      "keywords": ["fix", "build error", "compile error", "type error", "lint error", "tsc"],
+      "description": "Quick fixer - fast build/lint/type error resolution using haiku model for speed and cost efficiency.",
+      "trigger": "when build fails, type errors occur, or lint errors need fixing",
+      "model": "haiku"
     }
   ],
   "auto_load": {
@@ -131,5 +142,13 @@
   "fallback": {
     "enabled": true,
     "skill": "frontend-design"
+  },
+  "model_strategy": {
+    "description": "Cost-optimized model selection",
+    "rules": [
+      { "pattern": "quick-fix", "model": "haiku", "reason": "Fast, simple fixes" },
+      { "pattern": "quality-guard|test-master", "model": "sonnet", "reason": "Standard tasks" },
+      { "pattern": "design-brain", "model": "opus", "reason": "Complex architecture only" }
+    ]
   }
 }

package/.claude/rules/coding-style.md

@@ -0,0 +1,119 @@
+# Coding Style Rules
+
+> 代码风格规则 - 所有代码必须遵守
+
+## 不可变性 (CRITICAL)
+
+**始终创建新对象，永不变异：**
+
+```javascript
+// ❌ 错误：变异
+function updateUser(user, name) {
+  user.name = name  // 变异！
+  return user
+}
+
+// ✅ 正确：不可变
+function updateUser(user, name) {
+  return {
+    ...user,
+    name
+  }
+}
+```
+
+## 文件组织
+
+**多个小文件 > 少数大文件：**
+
+| 规则 | 阈值 |
+|------|------|
+| 典型文件 | 200-400 行 |
+| 最大文件 | 800 行 |
+| 组织方式 | 按功能/领域，而非按类型 |
+
+原则：高内聚，低耦合
+
+## 错误处理
+
+**始终全面处理错误：**
+
+```typescript
+try {
+  const result = await riskyOperation()
+  return result
+} catch (error) {
+  console.error('Operation failed:', error)
+  throw new Error('用户友好的详细错误信息')
+}
+```
+
+## 输入验证
+
+**始终验证用户输入：**
+
+```typescript
+import { z } from 'zod'
+
+const schema = z.object({
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150)
+})
+
+const validated = schema.parse(input)
+```
+
+## 代码质量检查清单
+
+完成工作前确认：
+
+- [ ] 代码可读、命名良好
+- [ ] 函数小（< 50 行）
+- [ ] 文件聚焦（< 800 行）
+- [ ] 无深嵌套（> 4 层）
+- [ ] 适当的错误处理
+- [ ] 无 console.log 语句
+- [ ] 无硬编码值
+- [ ] 无变异（使用不可变模式）
+
+## 命名规范
+
+| 类型 | 规范 | 示例 |
+|------|------|------|
+| 变量 | camelCase | `userName`, `isActive` |
+| 常量 | SCREAMING_SNAKE | `MAX_RETRY`, `API_URL` |
+| 函数 | camelCase, 动词开头 | `getUserById`, `validateInput` |
+| 类/组件 | PascalCase | `UserProfile`, `DataService` |
+| 文件 | kebab-case 或 PascalCase | `user-service.ts`, `UserProfile.tsx` |
+
+## 禁止的模式
+
+```typescript
+// ❌ 魔法数字
+if (status === 200) { ... }
+
+// ✅ 使用常量
+const HTTP_OK = 200
+if (status === HTTP_OK) { ... }
+
+// ❌ 变量名不清晰
+const x = getUser()
+const tmp = process(data)
+
+// ✅ 描述性命名
+const currentUser = getUser()
+const processedData = process(data)
+
+// ❌ 直接变异数组
+arr.push(item)
+arr.sort()
+
+// ✅ 创建新数组
+const newArr = [...arr, item]
+const sortedArr = [...arr].sort()
+```
+
+## 相关命令
+
+- `/code-review` - 代码审查
+- `/refactor-clean` - 重构清理