AI 编程工具技术栈：Claude Code/Cursor/Copilot 能力对比与工作流

# CLAUDE.md 示例
## 项目架构
- 前端: Next.js 14 + TypeScript + Tailwind CSS
- 后端: Go + Gin + PostgreSQL
- 部署: Docker + Kubernetes

## 编码规范
- TypeScript: 严格模式，禁止 `any` 类型
- Go: 遵循官方 style guide，使用 `golangci-lint`
- 提交消息: Conventional Commits 格式

## 常用命令
- 构建: `pnpm build`
- 测试: `pnpm test`
- Lint: `pnpm lint`
- 数据库迁移: `migrate -path migrations -database $DATABASE_URL up`

## 架构约束
- API 路由统一在 `internal/handler/` 下
- 数据访问层使用 Repository Pattern
- 错误处理使用自定义 AppError 类型

# 用户输入
claude "重构用户认证模块，将 JWT 验证逻辑从 handler 层提取到 middleware 层"

# Claude Code 自动分解为:
# 1. 分析当前 handler 层的 JWT 验证代码
# 2. 设计 middleware 层的接口
# 3. 实现 AuthMiddleware
# 4. 修改 handler 移除内联验证逻辑
# 5. 更新路由注册代码
# 6. 运行测试确保功能不变

# 审查当前分支的所有变更
claude review

# 审查特定文件
claude review --files src/auth/middleware.go

# 生成结构化的审查报告，包含：
# - 逻辑正确性
# - 边界条件处理
# - 安全漏洞
# - 性能隐患
# - 代码风格一致性

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read(*)",
      "Edit(src/**)",
      "Bash(pnpm test)",
      "Bash(pnpm build)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force)"
    ]
  }
}

# 在 CI 中自动修复 lint 错误
claude --headless --yes "修复所有 ESLint 错误，不要改变代码逻辑"

# 在 pre-commit hook 中自动审查
claude --headless "审查暂存区的变更，如果有安全问题则阻止提交"

// 你正在写一个 API 处理函数
export async function getUserProfile(req: Request) {
  const userId = req.params.id;
  // Cursor 会根据整个项目的数据访问模式，
  // 智能推断接下来应该查询数据库
  const user = await db.user.findUnique({
    where: { id: userId },
    // 甚至会自动添加你常用的 include 关系
    include: { profile: true, role: true }
  });
}

# Composer 的典型工作流
1. 描述目标: "添加一个用户导出功能，支持 CSV 和 Excel 格式"
2. @引用相关文件: @src/api/user.ts @src/types/user.ts
3. Composer 自动:
   - 创建新的导出处理器
   - 添加路由配置
   - 定义导出格式接口
   - 修改用户列表接口添加导出参数
   - 生成对应的前端组件

# .cursorrules 示例
项目技术栈: Next.js + TypeScript + Prisma + PostgreSQL
编码风格:
  - 使用函数式组件和 Hooks
  - 错误处理统一使用 Error Boundary
  - API 路由遵循 RESTful 规范
  - 数据库查询使用 Prisma Client
禁止操作:
  - 不要使用 any 类型
  - 不要直接操作 DOM
  - 不要在组件中写业务逻辑
测试要求:
  - 每个 API 路由必须有对应的测试
  - 使用 vitest 作为测试框架

# 典型多文件重构流程
1. 选择目标文件范围
2. 描述重构意图
3. Cursor 生成编辑计划（Preview 模式）
4. 逐文件确认变更
5. 一键应用所有变更
6. 运行测试验证

# Copilot 同时看到上方的导入和下方的注释
import pandas as pd
import numpy as np
from sklearn.model_selection import train_test_split

def preprocess_data(df: pd.DataFrame) -> tuple:
    """清洗数据集，处理缺失值和异常值"""
    # Copilot 会根据函数签名和 docstring 生成完整实现
    # ↓↓↓ 以下是 Copilot 建议的代码 ↓↓↓
    df = df.dropna(subset=['target'])
    numerical_cols = df.select_dtypes(include=[np.number]).columns
    for col in numerical_cols:
        df[col] = df[col].fillna(df[col].median())
    Q1 = df[numerical_cols].quantile(0.25)
    Q3 = df[numerical_cols].quantile(0.75)
    IQR = Q3 - Q1
    df = df[~((df[numerical_cols] < (Q1 - 1.5 * IQR)) | 
               (df[numerical_cols] > (Q3 + 1.5 * IQR))).any(axis=1)]
    return df

# Workspace 上下文中的提问
@workspace 如何在不破坏现有 API 的情况下，
给 Order 模型添加一个 status 字段？

# Copilot 会分析:
# - Order 模型的当前定义
# - 所有使用 Order 的代码位置
# - 数据库迁移文件
# - API 文档
# 然后给出分步操作建议

# 企业配置示例
organization_settings:
  content_exclusions:
    - pattern: "*.env"
    - pattern: "secrets/**"
    - pattern: "*.pem"
  chat_mode: "enabled"
  completions_mode: "enabled"
  policies:
    - name: "code_suggestions_policy"
      type: "filter_matches"
      filters:
        - type: "copy"
          filters:
            - is_error: true

┌─────────────────────────────────────────────────────────────┐
│                   交互模式光谱                                │
│                                                             │
│  终端原生                                    IDE 原生         │
│  ◄────────────────────────────────────────────────────►     │
│                                                             │
│  Claude Code          Cursor              Copilot           │
│  ┌──────────┐    ┌──────────────┐    ┌──────────────┐      │
│  │ Agent 优先 │    │ 补全+Agent   │    │ 补全优先      │      │
│  │ 任务驱动   │    │ 编辑器增强    │    │ 感知增强      │      │
│  │ CLI 交互   │    │ 混合交互      │    │ IDE 原生      │      │
│  └──────────┘    └──────────────┘    └──────────────┘      │
│                                                             │
│  适合: 系统级重构      适合: 全流程开发     适合: 日常编码       │
│  架构设计              多文件编辑           快速补全            │
│  CI/CD 集成           代码审查             轻量问答            │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  阶段 1: 需求理解与架构设计                        │
│                                                 │
│  工具: Claude Code (Agent 模式)                   │
│                                                 │
│  输入: 产品需求文档 / Issue 描述                    │
│  输出: 技术方案 + API 设计 + 数据模型               │
│                                                 │
│  Prompt 策略:                                    │
│  "分析以下需求，输出技术方案：                       │
│   1. 核心实体和关系图                              │
│   2. API 接口设计                                 │
│   3. 数据库表结构                                 │
│   4. 模块划分和依赖关系                            │
│   5. 潜在的技术风险"                               │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  阶段 2: 编码实现                                 │
│                                                 │
│  工具组合: Cursor (日常编码) + Claude Code (复杂逻辑) │
│                                                 │
│  Cursor 负责:                                    │
│  - Tab 补全加速日常编码                            │
│  - Composer 处理多文件新增模块                     │
│  - Chat 分析代码逻辑                              │
│                                                 │
│  Claude Code 负责:                                │
│  - 复杂算法实现                                   │
│  - 跨模块重构                                     │
│  - 数据库迁移脚本                                 │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  阶段 3: 测试与质量保障                            │
│                                                 │
│  工具: Claude Code + Copilot                     │
│                                                 │
│  Claude Code:                                    │
│  - 生成单元测试和集成测试                          │
│  - 分析测试覆盖率缺口                              │
│  - 设计边界条件测试用例                             │
│                                                 │
│  Copilot:                                        │
│  - 快速补全测试断言和 mock 数据                    │
│  - PR 自动审查                                    │
│  - 生成测试文档                                   │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  阶段 4: 部署与运维                               │
│                                                 │
│  工具: Claude Code (Headless 模式)                │
│                                                 │
│  应用场景:                                        │
│  - CI/CD 流水线中的自动修复                        │
│  - 生产环境日志分析                                │
│  - 自动化文档生成                                 │
│  - 依赖更新和兼容性检查                             │
│                                                 │
│  工作流:                                         │
│  git push → CI 触发 → Claude Code 检查 →         │
│  自动修复 lint 错误 → 运行测试 → 生成报告           │
└─────────────────────────────────────────────────┘

# 通用敏感信息防护策略
防护措施:
  - 环境变量管理:
      tool: "direnv / 1Password CLI"
      原则: "密钥绝不进入 AI 上下文"
  
  - .gitignore 配置:
      patterns:
        - "*.env*"
        - "secrets/**"
        - "*.pem"
        - "*.key"
  
  - 预提交钩子:
      tool: "detect-secrets / gitleaks"
      动作: "阻止包含密钥的代码提交"
  
  - AI 工具配置:
      Claude Code: "deny Bash(cat *.env)"
      Cursor: "在 .cursorignore 中排除敏感文件"
      Copilot: "配置 content_exclusions"

Copilot (补全) + Cursor (编辑)
- 用 Copilot 的 $10/月成本获得基础补全
- 用 Cursor 的 Composer 处理多文件任务
- 适合: 独立开发者、小团队

Claude Code (Agent) + Cursor (编辑)
- 用 Claude Code 处理架构设计、重构、调试
- 用 Cursor 处理日常编码和小范围修改
- 适合: 大型项目、架构驱动开发

Copilot Enterprise (团队) + Claude Code (复杂任务)
- Copilot 统一团队编码风格和补全体验
- Claude Code 作为"高级顾问"处理关键任务
- 适合: 10+ 人开发团队、企业级项目