sumulige-claude 1.2.1 → 1.3.0

package/.claude/skills/design-brain/SKILL.md

@@ -0,0 +1,190 @@
+# Design Brain
+
+> 设计大脑 - 合并: planner + architect-design
+
+## 核心职责
+
+统一处理设计和规划工作：
+
+1. **需求分析** - 理解和澄清需求
+2. **架构设计** - 系统设计、技术选型
+3. **实现规划** - 步骤分解、风险评估
+
+## 工作模式
+
+### 模式 1：快速规划（默认）
+
+```
+触发：一般任务
+输出：简洁的实现步骤
+耗时：< 2 分钟
+```
+
+### 模式 2：深度设计
+
+```
+触发：--deep 或复杂架构决策
+输出：完整设计文档
+耗时：5-10 分钟
+```
+
+## 快速规划流程
+
+```
+1. 理解需求（30s）
+   - 核心目标是什么？
+   - 有哪些约束？
+
+2. 识别依赖（30s）
+   - 需要修改哪些文件？
+   - 需要什么外部包？
+
+3. 制定步骤（1min）
+   - 分解为可验证的小步骤
+   - 确定步骤顺序
+```
+
+## 深度设计流程
+
+```
+1. 需求分析（2min）
+   - 功能需求
+   - 非功能需求（性能、安全、可用性）
+   - 边界条件
+
+2. 架构设计（3min）
+   - 组件划分
+   - 接口定义
+   - 数据流设计
+
+3. 技术选型（2min）
+   - 框架/库选择
+   - 权衡分析
+
+4. 实现规划（3min）
+   - 详细步骤
+   - 风险评估
+   - 测试策略
+```
+
+## 输出格式
+
+### 快速规划
+
+```markdown
+# Plan: [功能名称]
+
+## Goal
+[一句话描述]
+
+## Steps
+1. [ ] [步骤 1]
+2. [ ] [步骤 2]
+3. [ ] [步骤 3]
+
+## Files
+- `path/to/file.ts` - [修改内容]
+
+## Risk
+- [主要风险] → [缓解策略]
+```
+
+### 深度设计
+
+```markdown
+# Design: [系统/功能名称]
+
+## Overview
+[背景和目标]
+
+## Architecture
+
+### Components
+```
+┌─────────────┐     ┌─────────────┐
+│ Component A │────▶│ Component B │
+└─────────────┘     └─────────────┘
+```
+
+### Data Flow
+[数据如何流动]
+
+## Technical Decisions
+
+### Decision 1: [名称]
+- **Choice**: [选择]
+- **Reason**: [原因]
+- **Alternatives**: [备选方案]
+- **Trade-offs**: [权衡]
+
+## Implementation Plan
+
+### Phase 1: [阶段名]
+1. [ ] Step 1
+2. [ ] Step 2
+
+### Phase 2: [阶段名]
+...
+
+## Risks
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+
+## Success Criteria
+- [ ] 标准 1
+- [ ] 标准 2
+```
+
+## 设计原则
+
+### 1. 简单优于复杂
+
+```
+能用简单方案就不要复杂化
+避免过度设计
+YAGNI - 不需要的就不做
+```
+
+### 2. 最小变更
+
+```
+优先复用现有代码
+避免不必要的重构
+保持向后兼容
+```
+
+### 3. 可测试性
+
+```
+每个步骤都可验证
+定义清晰的成功标准
+考虑自动化测试
+```
+
+## 常用设计模式
+
+| 场景 | 推荐模式 |
+|------|---------|
+| 数据访问 | Repository |
+| 业务逻辑 | Service Layer |
+| 对象创建 | Factory |
+| 算法切换 | Strategy |
+| 事件驱动 | Observer |
+| UI 组件 | Compound Components |
+
+## 使用方式
+
+```bash
+# 快速规划（默认）
+/plan
+
+# 深度设计
+/plan --deep
+
+# 仅架构设计
+/plan --arch
+```
+
+---
+
+**原则**：好的设计是演进出来的。保持简单，按需扩展。先规划后动手。

package/.claude/skills/design-brain/metadata.yaml

@@ -0,0 +1,26 @@
+name: design-brain
+version: 2.0.0
+description: |
+  设计大脑。合并了规划和架构设计功能。
+  支持快速规划和深度设计两种模式。
+  仅在复杂任务时使用 opus 模型，日常规划使用 sonnet。
+
+triggers:
+  - plan
+  - design
+  - architecture
+  - system design
+  - technical decision
+  - 规划
+  - 设计
+  - 架构
+
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Task
+
+model: opus
+
+source: merged from planner + architect-design

package/.claude/skills/quality-guard/SKILL.md

@@ -0,0 +1,138 @@
+# Quality Guard
+
+> 代码质量守护者 - 合并: code-reviewer + security-reviewer + refactor-cleaner
+
+## 核心职责
+
+统一处理代码质量的三个维度：
+
+1. **代码审查** - 可读性、可维护性、最佳实践
+2. **安全检查** - OWASP Top 10、漏洞检测
+3. **代码清理** - 死代码、重复代码、未使用依赖
+
+## 工作模式
+
+### 模式 1：快速审查（默认）
+
+```
+触发：代码变更后
+范围：变更文件
+输出：问题列表 + 严重程度
+```
+
+### 模式 2：安全深扫
+
+```
+触发：--security 或处理认证/支付/用户输入
+范围：相关模块
+输出：安全报告 + 修复建议
+```
+
+### 模式 3：代码清理
+
+```
+触发：--clean 或明确要求清理
+范围：整个项目
+输出：可删除项列表 + 风险评级
+```
+
+## 审查清单
+
+### 代码质量（HIGH）
+
+- [ ] 函数 < 50 行
+- [ ] 文件 < 800 行
+- [ ] 嵌套深度 < 4 层
+- [ ] 命名清晰、语义化
+- [ ] 无 console.log 语句
+- [ ] 无硬编码魔法值
+- [ ] 错误处理完善
+
+### 安全检查（CRITICAL）
+
+- [ ] 无硬编码凭证（API keys, passwords, tokens）
+- [ ] 无 SQL 注入风险
+- [ ] 无 XSS 漏洞
+- [ ] 输入验证完整
+- [ ] 无不安全依赖（npm audit）
+- [ ] 无路径遍历风险
+- [ ] 认证/授权正确实现
+
+### 代码清理（MEDIUM）
+
+- [ ] 无未使用的导出
+- [ ] 无未使用的依赖
+- [ ] 无重复代码块
+- [ ] 无死代码分支
+- [ ] 无过时的 TODO/FIXME
+
+## 分析工具
+
+```bash
+# 代码质量
+npx eslint . --report-unused-disable-directives
+
+# 安全检查
+npm audit
+npx snyk test
+
+# 死代码检测
+npx knip           # 未使用的文件、导出、依赖
+npx depcheck       # 未使用的 npm 依赖
+npx ts-prune       # 未使用的 TypeScript 导出
+```
+
+## 输出格式
+
+```markdown
+# Quality Guard Report
+
+## Summary
+- 🔴 CRITICAL: X issues
+- 🟠 HIGH: X issues
+- 🟡 MEDIUM: X issues
+
+## Security Issues
+| File | Line | Issue | Fix |
+|------|------|-------|-----|
+
+## Code Quality Issues
+| File | Line | Issue | Fix |
+|------|------|-------|-----|
+
+## Cleanup Suggestions
+| Item | Type | Risk | Action |
+|------|------|------|--------|
+
+## Verdict
+✅ APPROVED / ⚠️ NEEDS ATTENTION / ❌ BLOCKED
+```
+
+## 严重程度
+
+| 级别 | 类别 | 处理 |
+|------|------|------|
+| 🔴 CRITICAL | 安全漏洞 | 必须修复，阻止提交 |
+| 🟠 HIGH | 代码质量 | 应该修复 |
+| 🟡 MEDIUM | 清理建议 | 建议修复 |
+| 🟢 LOW | 风格建议 | 可选修复 |
+
+## 使用方式
+
+```bash
+# 快速审查（默认）
+/review
+
+# 安全深扫
+/review --security
+
+# 代码清理
+/review --clean
+
+# 完整审查
+/review --all
+```
+
+---
+
+**原则**：质量是不可妥协的。安全问题必须立即修复。

package/.claude/skills/quality-guard/metadata.yaml

@@ -0,0 +1,27 @@
+name: quality-guard
+version: 2.0.0
+description: |
+  代码质量守护者。合并了代码审查、安全检查、死代码清理三大功能。
+  支持快速审查、安全深扫、代码清理三种模式。
+  自动在代码变更后触发，确保代码质量和安全性。
+
+triggers:
+  - code review
+  - security check
+  - clean code
+  - dead code
+  - refactor
+  - vulnerability
+  - 代码审查
+  - 安全检查
+  - 清理代码
+
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+
+model: sonnet
+
+source: merged from code-reviewer + security-reviewer + refactor-cleaner

package/.claude/skills/quick-fix/SKILL.md

@@ -0,0 +1,138 @@
+# Quick Fix
+
+> 快速修复者 - 优化版 build-error-resolver
+
+## 核心职责
+
+快速修复常见的开发问题：
+
+1. **构建错误** - TypeScript 编译错误
+2. **Lint 错误** - ESLint/Prettier 问题
+3. **类型错误** - 类型不匹配、缺少类型
+
+## 设计理念
+
+**轻量 + 快速 + 最小变更**
+
+使用 haiku 模型，确保响应快速，成本低。
+
+## 工作流程
+
+### 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
+```
+
+### 2. 错误分类
+
+| 类型 | 示例 | 处理策略 |
+|------|------|---------|
+| 类型错误 | `TS2345: Argument of type...` | 添加类型断言或修复类型 |
+| 导入错误 | `Cannot find module...` | 检查路径或安装依赖 |
+| 语法错误 | `Unexpected token...` | 修复语法 |
+| Lint 错误 | `no-unused-vars` | 删除或使用变量 |
+
+### 3. 增量修复
+
+```
+原则：每次只修复一个错误
+流程：
+1. 读取第一个错误
+2. 定位问题文件和行号
+3. 应用最小修复
+4. 重新编译验证
+5. 如果仍有错误，重复步骤 1
+```
+
+## 常见修复模式
+
+### 类型错误
+
+```typescript
+// 错误: Type 'string | undefined' is not assignable to type 'string'
+// 修复 1: 非空断言
+const value = maybeString!
+
+// 修复 2: 默认值
+const value = maybeString ?? ''
+
+// 修复 3: 类型守卫
+if (maybeString) {
+  const value = maybeString
+}
+```
+
+### 导入错误
+
+```typescript
+// 错误: Cannot find module './utils'
+// 检查 1: 文件是否存在
+// 检查 2: 路径是否正确
+// 检查 3: 扩展名是否需要
+
+// 修复: 更正路径
+import { helper } from './utils/helpers'
+```
+
+### Lint 错误
+
+```typescript
+// 错误: 'foo' is defined but never used
+// 修复 1: 删除未使用的变量
+// 修复 2: 如果需要保留，使用 _ 前缀
+const _foo = unused
+```
+
+## 输出格式
+
+```markdown
+# Quick Fix Report
+
+## Errors Found: X
+## Fixed: Y
+## Remaining: Z
+
+## Fixes Applied
+| File | Line | Error | Fix |
+|------|------|-------|-----|
+| src/app.ts | 42 | TS2345 | Added type assertion |
+| src/utils.ts | 15 | no-unused-vars | Removed unused import |
+
+## Build Status
+✅ SUCCESS / ❌ FAILED (X errors remaining)
+```
+
+## 使用方式
+
+```bash
+# 修复构建错误
+/fix --build
+
+# 修复 lint 错误
+/fix --lint
+
+# 修复类型错误
+/fix --type
+
+# 自动修复所有
+/fix --all
+```
+
+## 限制
+
+- 不处理复杂的架构问题
+- 不重构代码
+- 仅做最小必要的修改
+- 如果错误过于复杂，建议使用 `/plan` 先规划
+
+---
+
+**原则**：快速、最小、安全。不确定的修复不要做。

package/.claude/skills/quick-fix/metadata.yaml

@@ -0,0 +1,26 @@
+name: quick-fix
+version: 2.0.0
+description: |
+  快速修复者。专注于构建错误、lint 错误、类型错误的快速修复。
+  使用 haiku 模型确保响应快速、成本低。
+  遵循最小变更原则，不做复杂重构。
+
+triggers:
+  - build error
+  - compile error
+  - type error
+  - lint error
+  - tsc error
+  - 构建错误
+  - 编译错误
+  - 类型错误
+
+tools:
+  - Read
+  - Edit
+  - Bash
+  - Grep
+
+model: haiku
+
+source: optimized from build-error-resolver

package/.claude/skills/test-master/SKILL.md

@@ -0,0 +1,186 @@
+# Test Master
+
+> 测试大师 - 合并: tdd-workflow + e2e-runner
+
+## 核心职责
+
+统一处理所有测试相关工作：
+
+1. **单元测试** - TDD 流程、Jest/Vitest
+2. **E2E 测试** - Playwright、用户流程
+3. **覆盖率** - 分析和提升覆盖率
+
+## 工作模式
+
+### 模式 1：TDD 开发
+
+```
+触发：实现新功能或修复 bug
+流程：RED → GREEN → REFACTOR
+目标：测试先行，覆盖率 > 80%
+```
+
+### 模式 2：E2E 测试
+
+```
+触发：--e2e 或用户流程测试
+框架：Playwright + Page Object Model
+输出：测试文件 + 截图/视频
+```
+
+### 模式 3：覆盖率分析
+
+```
+触发：--coverage
+输出：覆盖率报告 + 未覆盖代码建议
+```
+
+## TDD 工作流
+
+### RED（写失败的测试）
+
+```typescript
+// 1. 先写测试，明确期望行为
+describe('calculateTotal', () => {
+  it('should sum all items with tax', () => {
+    const items = [{ price: 100 }, { price: 200 }]
+    expect(calculateTotal(items, 0.1)).toBe(330)
+  })
+})
+```
+
+### GREEN（最小实现）
+
+```typescript
+// 2. 写最少代码让测试通过
+function calculateTotal(items, taxRate) {
+  const subtotal = items.reduce((sum, item) => sum + item.price, 0)
+  return subtotal * (1 + taxRate)
+}
+```
+
+### REFACTOR（优化）
+
+```typescript
+// 3. 重构，保持测试通过
+function calculateTotal(items: Item[], taxRate: number): number {
+  const subtotal = items.reduce((sum, { price }) => sum + price, 0)
+  return Math.round(subtotal * (1 + taxRate) * 100) / 100
+}
+```
+
+## E2E 测试结构
+
+```
+tests/
+├── e2e/
+│   ├── pages/              # Page Objects
+│   │   ├── LoginPage.ts
+│   │   ├── DashboardPage.ts
+│   │   └── BasePage.ts
+│   ├── fixtures/           # 测试数据
+│   │   └── users.json
+│   ├── specs/              # 测试用例
+│   │   ├── auth.spec.ts
+│   │   └── dashboard.spec.ts
+│   └── playwright.config.ts
+```
+
+### Page Object 示例
+
+```typescript
+// pages/LoginPage.ts
+import { Page } from '@playwright/test'
+
+export class LoginPage {
+  constructor(private page: Page) {}
+
+  async goto() {
+    await this.page.goto('/login')
+  }
+
+  async login(email: string, password: string) {
+    await this.page.fill('[data-testid="email"]', email)
+    await this.page.fill('[data-testid="password"]', password)
+    await this.page.click('[data-testid="submit"]')
+  }
+
+  async expectError(message: string) {
+    await expect(this.page.locator('.error')).toContainText(message)
+  }
+}
+```
+
+## 覆盖率目标
+
+| 类型 | 目标 | 最低 |
+|------|------|------|
+| 语句覆盖 | 90% | 80% |
+| 分支覆盖 | 85% | 70% |
+| 函数覆盖 | 90% | 80% |
+| 行覆盖 | 90% | 80% |
+
+## 测试命令
+
+```bash
+# 运行单元测试
+npm test
+
+# 运行并生成覆盖率
+npm test -- --coverage
+
+# 运行 E2E 测试
+npx playwright test
+
+# 运行特定测试
+npm test -- --grep "calculateTotal"
+
+# 监视模式
+npm test -- --watch
+```
+
+## 输出格式
+
+```markdown
+# Test Report
+
+## Summary
+- Total: X tests
+- Passed: X ✅
+- Failed: X ❌
+- Skipped: X ⏭️
+
+## Coverage
+| Metric | Current | Target | Status |
+|--------|---------|--------|--------|
+| Statements | 85% | 80% | ✅ |
+| Branches | 72% | 70% | ✅ |
+| Functions | 88% | 80% | ✅ |
+| Lines | 85% | 80% | ✅ |
+
+## Failed Tests
+[详细失败信息]
+
+## Uncovered Code
+[建议添加测试的代码]
+```
+
+## 使用方式
+
+```bash
+# TDD 开发
+/test
+
+# E2E 测试
+/test --e2e
+
+# 覆盖率分析
+/test --coverage
+
+# 完整测试
+/test --all
+```
+
+---
+
+**原则**：没有测试的代码是不完整的。测试先行，覆盖率为王。