Claude Concepts 完整指南

---
name: 代码优化
description: 分析代码中的性能问题并给出优化建议
tags: performance, analysis
---

# 代码优化

请按以下优先级顺序审查给定代码中的问题：

1. **性能瓶颈** - 识别 O(n²) 操作、低效循环
2. **内存泄漏** - 查找未释放资源、循环引用
3. **算法改进** - 建议更优算法或数据结构
4. **缓存机会** - 识别重复计算
5. **并发问题** - 查找竞态条件或线程问题

请按以下格式输出：
- 问题严重级别（Critical/High/Medium/Low）
- 代码位置
- 解释说明
- 带代码示例的修复建议

# 用户在 Claude Code 中输入
/optimize

# Claude 加载提示并等待代码输入

---
name: 准备 Pull Request
description: 清理代码、暂存改动并准备一个 Pull Request
tags: git, workflow
---

# Pull Request 准备清单

在创建 PR 前，执行以下步骤：

1. 运行 lint：`prettier --write .`
2. 运行测试：`npm test`
3. 查看 git diff：`git diff HEAD`
4. 暂存改动：`git add .`
5. 按 conventional commits 规则编写提交信息：
   - `fix:` 用于 bug 修复
   - `feat:` 用于新功能
   - `docs:` 用于文档更新
   - `refactor:` 用于代码重构
   - `test:` 用于补充测试
   - `chore:` 用于维护性工作

6. 生成 PR 摘要，包括：
   - 改了什么
   - 为什么改
   - 做了哪些测试
   - 可能的影响

/pr

# Claude 按清单逐项检查并准备 PR

---
name: 生成 API 文档
description: 基于源代码生成完整 API 文档
tags: documentation, api
---

# API 文档生成器

通过以下步骤生成 API 文档：

1. 扫描 `/src/api/` 下的所有文件
2. 提取函数签名和 JSDoc 注释
3. 按 endpoint / module 组织结构
4. 生成带示例的 Markdown
5. 包含请求 / 响应 schema
6. 补充错误文档

输出格式：
- 输出 Markdown 文件到 `/docs/api.md`
- 为所有端点包含 curl 示例
- 补充 TypeScript 类型

---
name: code-reviewer
description: Comprehensive code quality and maintainability analysis
tools: read, grep, diff, lint_runner
---

# Code Reviewer Agent

You are an expert code reviewer specializing in:
- Performance optimization
- Security vulnerabilities
- Code maintainability
- Testing coverage
- Design patterns

## Review Priorities (in order)

1. **Security Issues** - Authentication, authorization, data exposure
2. **Performance Problems** - O(n²) operations, memory leaks, inefficient queries
3. **Code Quality** - Readability, naming, documentation
4. **Test Coverage** - Missing tests, edge cases
5. **Design Patterns** - SOLID principles, architecture

## Review Output Format

针对每个问题：
- **Severity**: Critical / High / Medium / Low
- **Category**: Security / Performance / Quality / Testing / Design
- **Location**: File path and line number
- **Issue Description**: What's wrong and why
- **Suggested Fix**: Code example
- **Impact**: How this affects the system

---
name: test-engineer
description: Test strategy, coverage analysis, and automated testing
tools: read, write, bash, grep
---

# Test Engineer Agent

You are expert at:
- Writing comprehensive test suites
- Ensuring high code coverage (>80%)
- Testing edge cases and error scenarios
- Performance benchmarking
- Integration testing

---
name: documentation-writer
description: Technical documentation, API docs, and user guides
tools: read, write, grep
---

# Documentation Writer Agent

You create:
- API documentation with examples
- User guides and tutorials
- Architecture documentation
- Changelog entries
- Code comment improvements

# 场景：构建支付功能

## 用户请求
"构建一个与 Stripe 集成的安全支付处理功能"

## 主 Agent 工作流

1. **规划阶段**
   - 理解需求
   - 确定所需任务
   - 规划架构

2. **委派给 Code Reviewer Subagent**
   - 任务："审查支付处理实现中的安全问题"
   - 上下文：认证、API 密钥、token 处理
   - 重点：SQL 注入、密钥泄露、HTTPS 强制

3. **委派给 Test Engineer Subagent**
   - 任务："为支付流程创建完整测试"
   - 上下文：成功场景、失败场景、边界情况
   - 输出：有效支付、拒付、网络故障、webhook 测试

4. **委派给 Documentation Writer Subagent**
   - 任务："为支付 API 端点编写文档"
   - 上下文：请求 / 响应 schema
   - 产出：带 curl 示例和错误码的 API 文档

5. **综合**
   - 主 Agent 汇总所有输出
   - 整合发现
   - 返回完整方案给用户

---
name: secure-reviewer
description: Security-focused code review with minimal permissions
tools: read, grep
---

# Secure Code Reviewer

Reviews code for security vulnerabilities only.

---
name: implementation-agent
description: Full implementation capabilities for feature development
tools: read, write, bash, grep, edit, glob
---

# Implementation Agent

Builds features from specifications.

# 项目配置

## 项目概览
- **名称**：电商平台
- **技术栈**：Node.js、PostgreSQL、React 18、Docker
- **团队规模**：5 名开发者
- **截止时间**：2025 年第 4 季度

## 架构
@docs/architecture.md
@docs/api-standards.md
@docs/database-schema.md

## 开发标准

### Code Style
- 使用 Prettier 格式化
- 使用 ESLint + airbnb config
- 最大行宽 100 字符
- 使用 2 空格缩进

### Naming Conventions
- **文件**：kebab-case
- **类**：PascalCase
- **函数/变量**：camelCase
- **常量**：UPPER_SNAKE_CASE
- **数据库表**：snake_case

# API 模块标准

该文件会覆盖根目录 `CLAUDE.md` 中对 `/src/api/` 的规则。

## API 专属标准

### Request Validation
- 使用 Zod 做 schema 校验
- 所有输入都必须校验
- 校验失败时返回 400
- 包含字段级错误详情

### Authentication
- 所有端点都要求 JWT token
- Token 通过 Authorization header 传递
- Token 24 小时过期
- 实现 refresh token 机制

# 我的开发偏好

## About Me
- **经验水平**：8 年全栈开发
- **偏好语言**：TypeScript、Python
- **沟通风格**：直接、配示例
- **学习风格**：喜欢图示和代码配合

## Code Preferences

### Error Handling
我偏好显式的 try-catch 和清晰的错误信息。
避免泛化错误，调试时始终记录日志。

User: 记住：所有新组件都优先使用 React hooks，不用 class components。

Claude: 我会把它加入记忆。你希望写入哪个记忆文件？
        1. 项目记忆（./CLAUDE.md）
        2. 个人记忆（~/.claude/CLAUDE.md）

User: 项目记忆

Claude: ✅ 记忆已保存！

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-database"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

# 使用多个 MCP 的日报工作流

## 设置
1. GitHub MCP - 获取 PR 指标
2. Database MCP - 查询销售数据
3. Slack MCP - 发送报告
4. Filesystem MCP - 保存报告

~/.claude/skills/code-review/
├── SKILL.md
├── templates/
│   ├── review-checklist.md
│   └── finding-template.md
└── scripts/
    ├── analyze-metrics.py
    └── compare-complexity.py

---
name: Code Review Specialist
description: Comprehensive code review with security, performance, and quality analysis
version: "1.0.0"
tags:
  - code-review
  - quality
  - security
when_to_use: 当用户希望审查代码、分析代码质量或评估 pull request 时
effort: high
shell: bash
---

# 代码审查 Skill

这个 skill 提供全面的代码审查能力，重点关注：

1. **安全分析**
2. **性能审查**
3. **代码质量**
4. **可维护性**

---
name: plugin-name
version: "1.0.0"
description: "What this plugin does"
author: "Your Name"
license: MIT
---

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/
├── agents/
├── skills/
├── hooks/
├── .mcp.json
├── templates/
├── scripts/
├── docs/
└── tests/

{
  "name": "pr-review",
  "version": "1.0.0",
  "description": "Complete PR review workflow with security, testing, and docs"
}

devops-automation/
├── commands/
├── agents/
├── mcp/
├── hooks/
└── scripts/

documentation/
├── commands/
├── agents/
├── mcp/
└── templates/

/plugin install pr-review
# ✅ 一次安装完成
# ✅ 即刻可用
# ✅ 团队可复现

1. 用户发来报错邮件
2. 读取记忆和历史上下文
3. 通过多个 MCP 查询系统状态
4. 自动识别适合的 Skill
5. 委派给对应 Subagent
6. Subagent 处理问题
7. Skill 负责按统一语气生成回复
8. MCP 将结果同步到外部系统
9. 返回给客户

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_FILE_PATH"
          }
        ]
      }
    ]
  }
}

# 按两次 Esc 打开 checkpoint 浏览器
Esc + Esc

# 或使用 /rewind
/rewind

{
  "autoCheckpoint": true
}

/plan Implement user authentication system

export MAX_THINKING_TOKENS=50000
claude -p "Should we use microservices or monolith?"

/task list
/task status bg-1234
/task show bg-1234
/task cancel bg-1234

claude -p "Run all tests"
cat error.log | claude -p "explain this error"
claude -p --output-format json "list all functions in src/"

/loop every 30m "Run tests and report failures"
/loop every 2h "Check for dependency updates"
/loop every 1d "Generate daily summary of code changes"

/resume
/rename "Feature"
/fork
claude -c
claude -r "Feature"

{
  "planning": {
    "autoEnter": true,
    "requireApproval": true
  },
  "backgroundTasks": {
    "enabled": true,
    "maxConcurrentTasks": 5
  },
  "permissions": {
    "mode": "default"
  }
}