sumulige-claude 1.2.0 → 1.3.0

package/.claude/skills/manus-kickoff/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/skills/manus-kickoff/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/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