Claude Code 使用指南

# ~/.claude/commands/review-pr.md
Review PR #$1 with priority $2 and assign to $3
​
# 使用
/review-pr 456 high alice

claude mcp add <name> npx <package>
claude mcp add my-server file:///path/to/server

{
  "permissions": {
    "allow": ["mcp__服务器名"],
    "deny": []
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@composio/mcp@latest", "github"]
    }
  },
  "permissions": {
    "allow": ["mcp__filesystem", "mcp__github"],
    "deny": []
  }
}

import { query } from "@anthropic-ai/claude-code";
​
const prompt = "查找 ./src/queries 目录中的重复查询";
​
for await (const message of query({ prompt })) {
  console.log(JSON.stringify(message, null, 2));
}

from anthropic_claude_code import query
import json
​
prompt = "分析这个项目的代码质量"
​
async for message in query(prompt=prompt):
    print(json.dumps(message, indent=2))

for await (const message of query({
  prompt: "重构这个函数",
  options: {
    allowedTools: ["Edit", "Write"]  // 允许编辑和创建文件
  }
})) {
  console.log(message);
}

{
  "PostToolUse": [{
    "matcher": "Write|Edit",
    "hooks": [{
      "type": "command",
      "command": "node scripts/ai-review.js"
    }]
  }]
}

import { query } from "@anthropic-ai/claude-code";

async function reviewCode() {
  const filePath = process.env.CLAUDE_TOOL_INPUT_file_path;

  // 针对不同文件类型的智能审查
  if (filePath?.endsWith('.java')) {
    const prompt = `
      审查 ${filePath} 的代码质量：
      1. 检查是否符合 Java 命名规范
      2. 查找潜在的空指针异常
      3. 评估方法复杂度
      4. 检查是否有重复代码
    `;

    for await (const message of query({ prompt })) {
      if (message.type === 'text' && message.text.includes('问题')) {
        console.error(`代码审查发现问题：\n${message.text}`);
      }
    }
  }
}

reviewCode();

const javaPrompt = `
  分析 src/main/java 目录：
  1. 找出所有未使用的导入
  2. 检查是否有违反 SOLID 原则的类
  3. 识别可以使用 Java 8+ 特性优化的代码
`;

for await (const message of query({ 
  prompt: javaPrompt,
  options: { allowedTools: ["Read", "Grep"] }
})) {
  // 处理分析结果
}

prompt = """
检查 Python 项目依赖：
1. 找出 requirements.txt 中未使用的包
2. 检查是否有安全漏洞
3. 建议版本升级
"""

async for message in query(prompt=prompt):
    if message.get('type') == 'text':
        print(message['text'])

{
  "session_id": "2d6a1e4d-6...",
  "transcript_path": "/Users/sg/...",
  "hook_event_name": "PreToolUse",
  "tool_name": "Read",
  "tool_input": {
    "file_path": "/code/queries/.env"
  }
}

{
  "PostToolUse": [{
    "matcher": "*",
    "hooks": [{
      "type": "command",
      "command": "jq . > debug/hook-data.json"
    }]
  }]
}

{
  "PreToolUse": [{
    "matcher": "Read|Grep",
    "hooks": [{
      "type": "command",
      "command": "python -c \"import sys, json; data=json.load(sys.stdin); path=data['tool_input'].get('file_path',''); sys.exit(2 if '.env' in path else 0)\" 2>&1 | tee -a /dev/stderr"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Write|Edit|MultiEdit",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if [[ \"$CLAUDE_TOOL_INPUT_file_path\" == *.java ]]; then google-java-format -i \"$CLAUDE_TOOL_INPUT_file_path\" 2>/dev/null || true; fi'"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Edit|Write|MultiEdit",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if [[ \"$CLAUDE_TOOL_INPUT_file_path\" == *.py ]]; then mypy \"$CLAUDE_TOOL_INPUT_file_path\" 2>&1 | head -20 || true; fi'"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Edit|Write",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if [[ \"$CLAUDE_TOOL_INPUT_file_path\" == *.java ]]; then javac -Xlint:all \"$CLAUDE_TOOL_INPUT_file_path\" 2>&1 | head -20; rm -f \"${CLAUDE_TOOL_INPUT_file_path%.java}.class\" 2>/dev/null; fi'"
    }]
  }]
}

{
  "PreToolUse": [{
    "matcher": "Execute",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if echo \"$CLAUDE_TOOL_INPUT_command\" | grep -qE \"rm.*-rf|:(){ :|:& };:\"; then echo \"危险命令被阻止\" >&2; exit 2; fi'"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Edit|Write",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if [[ \"$CLAUDE_TOOL_INPUT_file_path\" == *.py ]]; then flake8 \"$CLAUDE_TOOL_INPUT_file_path\" --max-line-length=120 2>&1 | head -10 || true; fi'"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Write|Edit",
    "hooks": [{
      "type": "command",
      "command": "node scripts/ai-code-review.js"
    }]
  }]
}

import { query } from "@anthropic-ai/claude-code";

async function aiCodeReview() {
  const filePath = process.env.CLAUDE_TOOL_INPUT_file_path;

  // Java 代码审查
  if (filePath?.endsWith('.java')) {
    const prompt = `
      审查 ${filePath}：
      1. 是否存在重复的业务逻辑
      2. 是否有潜在的并发问题
      3. 是否符合项目的设计模式
    `;

    for await (const message of query({ prompt })) {
      if (message.type === 'text') {
        console.log("AI 代码审查结果：", message.text);
      }
    }
  }

  // Python 代码审查
  if (filePath?.endsWith('.py')) {
    const prompt = `
      审查 ${filePath}：
      1. 是否有重复的函数定义
      2. 是否正确处理了异常
      3. 是否有性能优化空间
    `;

    for await (const message of query({ prompt })) {
      if (message.type === 'text') {
        console.log("AI 代码审查结果：", message.text);
      }
    }
  }
}

aiCodeReview();

{
  "SessionStart": [{
    "hooks": [{
      "type": "command",
      "command": "echo \"会话开始: $(date)\" >> .claude/session.log"
    }]
  }],
  "SessionEnd": [{
    "hooks": [{
      "type": "command",
      "command": "python scripts/backup_session.py"
    }]
  }]
}

{
  "PostToolUse": [{
    "matcher": "Edit",
    "hooks": [{
      "type": "command",
      "command": "bash -c 'if [[ \"$CLAUDE_TOOL_INPUT_file_path\" == *requirements.txt ]]; then safety check --json 2>&1 | jq -r \".vulnerabilities | length\"; fi'"
    }]
  }]
}

Claude 修改代码 → Hook 触发 → SDK 审查代码 → 
反馈给 Claude → Claude 根据反馈优化代码

my-skill/
├── SKILL.md          # 必需：核心定义文件
├── instructions.md   # 可选：详细操作指南
├── templates/        # 可选：代码模板
├── examples/         # 可选：使用示例
└── resources/        # 可选：参考资料

---
name: skill-name
description: 简短描述这个 Skill 的用途
version: 1.0.0
tags: [tag1, tag2, tag3]
---

# Skill 名称

## 功能概述
详细描述这个 Skill 能做什么

## 核心能力
- 能力1：具体描述
- 能力2：具体描述
- 能力3：具体描述

## 使用场景
描述什么情况下应该使用这个 Skill

## 工作流程
1. 步骤1
2. 步骤2
3. 步骤3

---
name: spring-boot-expert
description: Spring Boot 全栈开发专家，提供架构设计和代码生成
version: 2.0.0
tags: [java, spring, backend, microservices]
---

# Spring Boot Expert

## 核心能力

### 1. 项目架构
- 创建标准的分层架构（Controller, Service, Repository）
- 配置多模块项目结构
- 设置环境配置（dev, test, prod）

### 2. 代码生成
- 自动生成 CRUD 操作
- 创建 RESTful API 端点
- 生成 Swagger/OpenAPI 文档

### 3. 最佳实践
- 统一异常处理
- 全局响应封装
- 分页查询优化
- 缓存策略实施

## 激活场景
- 用户提到 Spring Boot、JPA、REST API
- 创建 Java 微服务项目
- 需要数据库操作代码

## 工作流程
1. 分析需求，确定实体和业务逻辑
2. 生成项目结构和配置文件
3. 创建实体类和数据库映射
4. 实现服务层和控制器
5. 添加测试用例

package ${package}.entity;

import lombok.Data;
import javax.persistence.*;
import java.time.LocalDateTime;

@Data
@Entity
@Table(name = "${table_name}")
public class ${EntityName} {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @Column(name = "created_at")
    private LocalDateTime createdAt;

    @Column(name = "updated_at")
    private LocalDateTime updatedAt;

    @PrePersist
    protected void onCreate() {
        createdAt = LocalDateTime.now();
        updatedAt = LocalDateTime.now();
    }

    @PreUpdate
    protected void onUpdate() {
        updatedAt = LocalDateTime.now();
    }
}

---
name: react-component-builder
description: React 组件开发专家，支持 TypeScript 和现代 Hooks
version: 1.5.0
tags: [react, typescript, frontend, components]
---

# React Component Builder

## 核心能力

### 1. 组件创建
- 函数组件与 Hooks
- TypeScript 类型定义
- 组件性能优化

### 2. 状态管理
- useState, useReducer 最佳实践
- Context API 应用
- 自定义 Hooks 开发

### 3. 样式方案
- CSS Modules
- Styled Components
- Tailwind CSS 集成

## 代码规范
- 使用函数组件而非类组件
- Props 使用 TypeScript 接口定义
- 组件按功能拆分，保持单一职责
- 使用 React.memo 优化渲染性能

import React, { useState, useCallback, memo } from 'react';
import styles from './${ComponentName}.module.css';

interface ${ComponentName}Props {
  title: string;
  onAction?: (value: string) => void;
}

export const ${ComponentName} = memo<${ComponentName}Props>(({ 
  title, 
  onAction 
}) => {
  const [value, setValue] = useState('');

  const handleChange = useCallback((e: React.ChangeEvent<HTMLInputElement>) => {
    const newValue = e.target.value;
    setValue(newValue);
    onAction?.(newValue);
  }, [onAction]);

  return (
    <div className={styles.container}>
      <h2>{title}</h2>
      <input 
        type="text" 
        value={value} 
        onChange={handleChange}
        className={styles.input}
      />
    </div>
  );
});

${ComponentName}.displayName = '${ComponentName}';

---
name: code-reviewer
description: 智能代码审查专家，提供安全、性能和质量分析
version: 3.0.0
tags: [review, quality, security, performance]
---

# Code Reviewer

## 审查维度

### 1. 代码质量
- 命名规范检查
- 函数复杂度分析
- 代码重复检测
- SOLID 原则遵循

### 2. 安全审查
- SQL 注入风险
- XSS 攻击防护
- 敏感信息暴露
- 依赖漏洞扫描

### 3. 性能优化
- 算法时间复杂度
- 数据库查询优化
- 内存泄漏检测
- 异步操作优化

## 审查流程
1. 静态代码分析
2. 潜在问题识别
3. 改进建议生成
4. 优先级排序

## 输出格式
- 🔴 严重问题：必须修复
- 🟡 警告：建议改进
- 🟢 建议：可选优化
- 💡 最佳实践提示

# 在 Claude 中运行
/skill-creator "创建一个 Python FastAPI 开发专家 Skill"

## 代码生成策略

根据项目环境自动适配：
- 检测到 TypeScript → 生成类型安全代码
- 检测到 ESLint → 遵循项目代码规范
- 检测到测试框架 → 同时生成测试用例

---
name: fullstack-developer
dependencies: [react-expert, node-backend, database-designer]
---

# 全栈开发者 Skill
整合前端、后端和数据库设计能力

---
name: performance-optimizer
activation_keywords: [slow, optimize, performance, 性能优化]
activation_patterns: ["查询.*慢", "页面.*卡顿"]
---