sumulige-claude 1.2.0 → 1.3.0

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
+```
+
+---
+
+**原则**：没有测试的代码是不完整的。测试先行，覆盖率为王。

package/.claude/skills/test-master/metadata.yaml

@@ -0,0 +1,29 @@
+name: test-master
+version: 2.0.0
+description: |
+  测试大师。合并了 TDD 工作流和 E2E 测试功能。
+  支持单元测试、E2E 测试、覆盖率分析三种模式。
+  遵循 RED-GREEN-REFACTOR 循环，目标覆盖率 80%+。
+
+triggers:
+  - write test
+  - tdd
+  - test-driven
+  - e2e test
+  - playwright
+  - coverage
+  - unit test
+  - 写测试
+  - 测试覆盖
+
+tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Grep
+  - Glob
+
+model: sonnet
+
+source: merged from tdd-workflow + e2e-runner

package/.claude/templates/PROJECT_KICKOFF.md

@@ -0,0 +1,89 @@
+# 项目启动清单 (Project Kickoff)
+
+> 本文件由 AI 在项目启动时生成并维护
+> 最后更新: {DATE}
+
+---
+
+## 项目概述
+
+### 项目名称
+{PROJECT_NAME}
+
+### 一句话描述
+{ONE_LINE_DESCRIPTION}
+
+### 项目目标
+| 优先级 | 目标 | 成功标准 | 状态 |
+|--------|------|----------|------|
+| P0 | {PRIMARY_GOAL} | {SUCCESS_CRITERIA} | ⏳ 待确认 |
+| P1 | {SECONDARY_GOAL} | {SUCCESS_CRITERIA} | ⏳ 待确认 |
+| P2 | {STRETCH_GOAL} | {SUCCESS_CRITERIA} | ⏳ 待确认 |
+
+---
+
+## 约束条件
+
+### 技术约束
+- 语言/框架: {TECH_STACK}
+- 部署环境: {DEPLOYMENT}
+- 外部依赖: {EXTERNAL_DEPS}
+
+### 非技术约束
+- 时间预算: {TIME_BUDGET}
+- 质量标准: {QUALITY_STANDARDS}
+- 团队规模: {TEAM_SIZE}
+
+---
+
+## AI 自治原则
+
+### AI 负责范围
+- ✅ 代码编写与重构
+- ✅ 测试编写与执行
+- ✅ 文档更新
+- ✅ 技术方案选择
+- ✅ 问题诊断与修复
+
+### Human 确认点
+- 🛑 架构设计变更
+- 🛑 数据模型变更
+- 🛑 新增外部依赖
+- 🛑 安全与隐私相关
+- 🛑 用户体验重大变更
+- 🛑 成本与资源相关
+
+---
+
+## 上下文边界
+
+### 包含范围
+{IN_SCOPE}
+
+### 不包含范围
+{OUT_OF_SCOPE}
+
+### 未来考虑 (Later)
+{FUTURE_CONSIDERATIONS}
+
+---
+
+## 启动检查清单
+
+- [ ] 项目目标已明确
+- [ ] 约束条件已定义
+- [ ] 成功标准已对齐
+- [ ] AI/Human 责任已划分
+- [ ] 任务计划已生成 (TASK_PLAN.md)
+- [ ] 技术架构已确认 (ARCHITECTURE.md)
+- [ ] Human 已批准启动
+
+---
+
+## 启动确认
+
+**Human 确认**: ⏳ 待确认
+
+**AI 确认**: {AI_NAME} @ {DATE}
+
+**备注**: {NOTES}

package/.claude/templates/PROJECT_PROPOSAL.md

@@ -0,0 +1,227 @@
+# 项目计划书 (Project Proposal)
+
+> 完整技术方案与实施计划
+> 生成日期: {DATE}
+
+---
+
+## 执行摘要
+
+{EXECUTIVE_SUMMARY}
+
+---
+
+## 1. 项目背景
+
+### 1.1 问题陈述
+{PROBLEM_STATEMENT}
+
+### 1.2 解决方案概述
+{SOLUTION_OVERVIEW}
+
+### 1.3 目标用户
+{TARGET_USERS}
+
+---
+
+## 2. 功能需求
+
+### 2.1 核心功能 (MVP)
+| 功能 | 描述 | 优先级 |
+|------|------|--------|
+| {FEATURE_1} | {DESCRIPTION} | P0 |
+| {FEATURE_2} | {DESCRIPTION} | P0 |
+
+### 2.2 扩展功能
+| 功能 | 描述 | 优先级 |
+|------|------|--------|
+| {FEATURE_3} | {DESCRIPTION} | P1 |
+
+---
+
+## 3. 技术架构
+
+### 3.1 架构图
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        系统架构                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐   │
+│   │   前端层     │    │   API层     │    │   数据层     │   │
+│   │  {FRONTEND} │◄──►│  {API}      │◄──►│ {DATABASE}  │   │
+│   └─────────────┘    └─────────────┘    └─────────────┘   │
+│                             │                                │
+│                             ▼                                │
+│                    ┌─────────────┐                         │
+│                    │  外部服务    │                         │
+│                    │ {EXTERNAL}  │                         │
+│                    └─────────────┘                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 技术栈
+
+| 层级 | 技术选择 | 理由 |
+|------|----------|------|
+| **前端** | {FRONTEND_TECH} | {REASON} |
+| **后端** | {BACKEND_TECH} | {REASON} |
+| **数据库** | {DATABASE_TECH} | {REASON} |
+| **部署** | {DEPLOYMENT_TECH} | {REASON} |
+| **监控** | {MONITORING_TECH} | {REASON} |
+
+### 3.3 数据模型
+
+```typescript
+// 核心数据结构
+interface {ENTITY_NAME} {
+  id: string;
+  {FIELD}: {TYPE};
+  // ...
+}
+```
+
+### 3.4 API 设计
+
+| 方法 | 端点 | 描述 | 认证 |
+|------|------|------|------|
+| GET | /api/{RESOURCE} | 获取列表 | ✅ |
+| POST | /api/{RESOURCE} | 创建资源 | ✅ |
+| PUT | /api/{RESOURCE}/:id | 更新资源 | ✅ |
+| DELETE | /api/{RESOURCE}/:id | 删除资源 | ✅ |
+
+---
+
+## 4. 目录结构
+
+```
+{PROJECT_NAME}/
+├── docs/                  # 文档
+├── src/                   # 源代码
+│   ├── components/        # 组件
+│   ├── services/          # 服务
+│   ├── utils/             # 工具
+│   └── types/             # 类型定义
+├── tests/                 # 测试
+├── .claude/               # AI 上下文
+│   ├── CLAUDE.md          # 项目说明
+│   ├── MEMORY.md          # 增量记忆
+│   ├── PROJECT_LOG.md     # 构建历史
+│   ├── TASK_PLAN.md       # 任务计划
+│   └── skills/            # 领域技能
+└── package.json
+```
+
+---
+
+## 5. 开发计划
+
+### 5.1 迭代规划
+
+| Sprint | 目标 | 任务 | 预估 | 状态 |
+|--------|------|------|------|------|
+| Sprint 0 | 项目启动 | 架构设计、环境搭建 | 1周 | ⏳ |
+| Sprint 1 | MVP 核心 | 核心功能开发 | 2周 | ⏳ |
+| Sprint 2 | 完善 | 扩展功能、测试 | 1周 | ⏳ |
+| Sprint 3 | 优化 | 性能优化、文档 | 1周 | ⏳ |
+
+### 5.2 里程碑
+
+| 里程碑 | 交付物 | 预计日期 |
+|--------|--------|----------|
+| M0: 项目启动 | 架构文档、任务计划 | {DATE} |
+| M1: MVP | 可运行的原型 | {DATE} |
+| M2: Beta | 功能完整 | {DATE} |
+| M3: Release | 生产就绪 | {DATE} |
+
+---
+
+## 6. 质量保证
+
+### 6.1 测试策略
+- **单元测试**: 覆盖率目标 {COVERAGE}%
+- **集成测试**: 关键流程覆盖
+- **E2E 测试**: 用户场景覆盖
+
+### 6.2 代码质量
+- **Linting**: {LINTER}
+- **格式化**: {FORMATTER}
+- **代码审查**: AI Reviewer + Human 确认
+
+### 6.3 性能指标
+| 指标 | 目标 | 测量方法 |
+|------|------|----------|
+| 响应时间 | < {LATENCY}ms | 自动化测试 |
+| 吞吐量 | > {THROUGHPUT} QPS | 压力测试 |
+| 错误率 | < {ERROR_RATE}% | 监控 |
+
+---
+
+## 7. 部署计划
+
+### 7.1 环境配置
+- **开发**: 本地 Docker
+- **测试**: CI/CD 自动部署
+- **生产**: {PRODUCTION_DEPLOYMENT}
+
+### 7.2 发布流程
+1. 代码审查
+2. 测试通过
+3. Human 确认
+4. 标记版本
+5. 部署上线
+
+---
+
+## 8. 风险与缓解
+
+| 风险 | 影响 | 可能性 | 缓解措施 |
+|------|------|--------|----------|
+| {RISK_1} | 高 | 中 | {MITIGATION_1} |
+| {RISK_2} | 中 | 低 | {MITIGATION_2} |
+
+---
+
+## 9. 成功指标
+
+### 9.1 技术指标
+- 代码测试覆盖率 > {TARGET}%
+- 构建时间 < {TARGET}min
+- 部署频率 > {TARGET}/week
+
+### 9.2 业务指标
+- {BUSINESS_METRIC_1}
+- {BUSINESS_METRIC_2}
+
+---
+
+## 10. 后续规划
+
+### 10.1 短期 (3个月)
+{SHORT_TERM_PLANS}
+
+### 10.2 中期 (6个月)
+{MID_TERM_PLANS}
+
+### 10.3 长期 (1年)
+{LONG_TERM_PLANS}
+
+---
+
+## 附录
+
+### A. 术语表
+| 术语 | 定义 |
+|------|------|
+| {TERM} | {DEFINITION} |
+
+### B. 参考资料
+- {REFERENCE_1}
+- {REFERENCE_2}
+
+---
+
+**文档版本**: v1.0
+**最后更新**: {DATE}
+**状态**: ⏳ 待 Human 确认

package/.claude/templates/TASK_PLAN.md

@@ -0,0 +1,121 @@
+# 任务执行计划 (Task Execution Plan)
+
+> 本文件由 AI 在项目启动时生成，执行时持续更新
+> 关联文件: PROJECT_KICKOFF.md, ARCHITECTURE.md
+
+---
+
+## 任务概览
+
+```
+总任务数: {TOTAL_TASKS} | 已完成: {COMPLETED} | 进行中: {IN_PROGRESS} | 待开始: {PENDING}
+进度: {PERCENTAGE}%
+```
+
+---
+
+## 任务分解 (WBS)
+
+### Phase 1: {PHASE_1_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T1.1 | {TASK_NAME} | - | {EST} | P0 | ⏳ | {AGENT} |
+| T1.2 | {TASK_NAME} | T1.1 | {EST} | P0 | ⏳ | {AGENT} |
+
+### Phase 2: {PHASE_2_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T2.1 | {TASK_NAME} | T1.2 | {EST} | P1 | ⏳ | {AGENT} |
+
+### Phase 3: {PHASE_3_NAME}
+| ID | 任务 | 依赖 | 预估 | 优先级 | 状态 | 负责Agent |
+|----|------|------|------|--------|------|-----------|
+| T3.1 | {TASK_NAME} | T2.1 | {EST} | P2 | ⏳ | {AGENT} |
+
+---
+
+## 依赖关系图
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        任务依赖图                            │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   [T1.1] ──► [T1.2] ──► [T1.3]                            │
+│                │                                            │
+│                └───► [T2.1] ──► [T2.2]                     │
+│                         │                                  │
+│                         └───► [T3.1]                       │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 里程碑
+
+| 里程碑 | 包含任务 | 预计完成 | 实际完成 | 状态 |
+|--------|----------|----------|----------|------|
+| M1: {MILESTONE} | T1.1-T1.3 | {DATE} | - | ⏳ |
+| M2: {MILESTONE} | T2.1-T2.2 | {DATE} | - | ⏳ |
+| M3: {MILESTONE} | T3.1 | {DATE} | - | ⏳ |
+
+---
+
+## 风险登记
+
+| 风险 | 可能性 | 影响 | 缓解措施 | 状态 |
+|------|--------|------|----------|------|
+| {RISK} | 高/中/低 | 高/中/低 | {MITIGATION} | 🟡 |
+
+---
+
+## 执行日志
+
+### {DATE}
+- **T1.1 完成**: {NOTES}
+- **T1.2 启动**: {NOTES}
+
+---
+
+## Agent 分配规则
+
+| Agent | 擅长任务 | 默认分配 |
+|-------|----------|----------|
+| **Conductor** | 任务分解、依赖分析、风险评估 | Phase 启动 |
+| **Architect** | 架构设计、技术选型、接口定义 | 架构相关任务 |
+| **Builder** | 功能实现、单元测试、Bug 修复 | 开发任务 |
+| **Reviewer** | 代码审查、质量检查、性能优化 | 审查任务 |
+| **Librarian** | 文档编写、知识整理、注释更新 | 文档任务 |
+
+---
+
+## 检查点策略
+
+| 检查点 | 触发条件 | Human 确认 |
+|--------|----------|------------|
+| CP1 | Phase 1 完成 | ✅ 必需 |
+| CP2 | 架构变更 | ✅ 必需 |
+| CP3 | 数据模型变更 | ✅ 必需 |
+| CP4 | 里程碑完成 | ✅ 确认 |
+
+---
+
+## 状态图例
+
+| 图例 | 含义 |
+|------|------|
+| ⏳ | 待开始 (Pending) |
+| 🔄 | 进行中 (In Progress) |
+| ✅ | 已完成 (Completed) |
+| ⏸️ | 阻塞 (Blocked) |
+| ❌ | 取消 (Cancelled) |
+| 🛑 | 等待确认 (Waiting for Human) |
+
+---
+
+## 下一步行动
+
+1. **当前任务**: {CURRENT_TASK}
+2. **阻塞问题**: {BLOCKERS}
+3. **需要决策**: {DECISIONS_NEEDED}

package/.claude-plugin/marketplace.json

@@ -27,8 +27,8 @@
     }
   ],
   "metadata": {
-    "version": "1.1.2",
-    "generated_at": "2026-01-17T09:45:22.671Z",
+    "version": "1.2.0",
+    "generated_at": "2026-01-18T05:55:02.439Z",
     "skill_count": 1,
     "categories": {
       "tools": {