AI 编程 Agent：从辅助到自主编码

AI 编程能力进化路径

2022 ──── 代码补全 ──── 2023 ──── 对话辅助 ──── 2024 ──── 集成助手 ──── 2025 ──── 自主 Agent ──── 2026+
          (Copilot)         (ChatGPT)        (Cursor)         (Claude Code)      (多 Agent 协作)

人类参与度: ████████████████████ ────────────────────────────→ ░░░░░░░░░░░░░░░░░░
                100%                                                     10%
AI 自主度:    ░░░░░░░░░░░░░░░░░░ ────────────────────────────→ ████████████████████
                0%                                                      90%

典型任务:
  代码补全  →  单行/单函数补全
  对话辅助  →  "写一个排序函数" → 生成代码片段
  集成助手  →  "添加用户认证" → 读取文件 → 修改代码 → 运行测试
  自主 Agent →  "重构 API 模块" → 理解代码库 → 制定计划 → 实现 → 测试 → 修复 → 提交

# Claude Code 使用示例

# 基本用法：给一个任务描述
$ claude "为 UserAPI 添加分页功能，每页 20 条"

# Claude Code 会自主完成：
# 1. 读取 UserAPI 相关文件（routes/users.js, models/User.js）
# 2. 理解现有代码结构
# 3. 修改代码添加分页逻辑
# 4. 运行测试
# 5. 如果测试失败，分析错误并修复
# 6. 提交 commit

# 使用 /compact 压缩上下文（当对话过长时）
/compact

# 使用 /clear 清除对话历史
/clear

# 使用 /cost 查看当前会话的 token 消耗
/cost

# 权限模式（2026 新特性）
# 默认：自动模式（AI 自主操作）
# 安全模式：敏感操作需要人工确认
/permissions set sensitive=confirm

# 与 MCP Server 集成
# claude --mcp-config mcp-config.json "查询数据库并生成报告脚本"

# Claude Code 的 CLAUDE.md 文件
# 在项目根目录创建 CLAUDE.md，给 AI 提供项目级指令

# 示例 CLAUDE.md
---
# 项目: 电商后端 API
# 技术栈: Node.js + Express + PostgreSQL

## 代码规范
- 使用 TypeScript 严格模式
- 所有 API 端点必须有 Zod 验证
- 错误处理使用 AppError 类
- 测试覆盖率要求 > 80%

## 架构约定
- 路由文件放在 src/routes/
- 控制器放在 src/controllers/
- 服务层放在 src/services/
- 数据模型放在 src/models/

## 重要提醒
- 不要修改数据库迁移文件
- API 响应格式必须遵循 { success, data, error } 结构
- 所有外部调用必须有超时和重试逻辑
- 提交前运行: npm run lint && npm test
---

# Cursor 的 .cursor/rules 配置示例
# 比 CLAUDE.md 更灵活——支持按文件路径匹配不同规则

---
# 规则 1: API 端点规范
alwaysApply: false
globs: ["src/routes//*.ts", "src/controllers//*.ts"]
description: "API 路由和控制器必须遵循的规范"
---
所有 API 端点必须:
1. 使用 Zod 进行请求体验证
2. 返回统一格式: { success: boolean, data?: T, error?: string }
3. 包含 try-catch 错误处理
4. 使用 async/await（不使用 .then）
5. 添加 OpenAPI 注释（用于自动生成文档）

---
# 规则 2: 数据库模型规范
alwaysApply: false
globs: ["src/models/**/*.ts"]
description: "Prisma 模型定义规范"
---
所有 Prisma 模型必须:
1. 包含 createdAt 和 updatedAt 字段
2. 使用 @map 指定数据库列名（snake_case）
3. 添加 @@map 指定数据库表名（复数形式）
4. 所有字符串字段指定 @db.VarChar 长度限制

---
# 规则 3: 全局规范
alwaysApply: true
description: "所有代码都必须遵守的规则"
---
- 使用 TypeScript 严格模式
- 不使用 any 类型
- 所有导出函数必须有 JSDoc
- 错误消息使用中文（用户可见的错误）
- 日志使用英文（开发者日志）

# Cursor Agent 模式实战

# 场景：重构一个 Express 路由，添加错误处理和日志

# 1. 在 Cursor 中按 Cmd+K（或 Ctrl+K）打开 Agent 模式
# 2. 输入自然语言指令：
"重构 src/routes/orders.ts：
- 添加 try-catch 错误处理
- 每个端点添加请求日志（方法、路径、耗时）
- 使用 AppError 替代直接 throw Error
- 确保所有测试通过"

# 3. Cursor Agent 会：
#    - 读取 orders.ts 和相关文件
#    - 分析现有代码结构
#    - 逐步修改代码
#    - 在终端运行 npm test
#    - 如果失败，分析错误并修复
#    - 完成后展示 diff

# 4. 你可以：
#    - 在过程中随时查看和修改 AI 的更改
#    - 按 Accept 接受或按 Reject 拒绝
#    - 继续对话进一步调整

# 关键技巧：
# - 任务描述越具体，AI 执行越准确
# - 包含验收标准（"确保所有测试通过"）
# - 指出约束条件（"不要修改测试文件"）

// 多 Agent 协作编程框架（简化概念示例）
interface Agent {
  role: "architect" | "implementer" | "reviewer";
  model: string;
  execute: (task: Task) => Promise<Result>;
}

interface Task {
  id: string;
  description: string;
  dependencies?: string[];
  assignedTo?: string;
  status: "pending" | "in_progress" | "completed" | "blocked";
}

interface Result {
  taskId: string;
  output: string;
  artifacts: string[]; // 生成的文件路径
  success: boolean;
  reviewNotes?: string;
}

class MultiAgentDevTeam {
  private agents: Agent[];
  private tasks: Task[];
  private results: Map<string, Result> = new Map();

  constructor(agents: Agent[]) {
    this.agents = agents;
    this.tasks = [];
  }

  // 架构师 Agent 分析需求并拆分任务
  async plan(architect: Agent, requirement: string): Promise<Task[]> {
    const plan = await architect.execute({
      id: "plan",
      description: `分析需求并拆分任务: ${requirement}`,
      status: "pending",
    });

    // 解析架构师输出的任务列表
    this.tasks = this.parsePlan(plan.output);
    return this.tasks;
  }

  // 并行分配任务给实现 Agent
  async executeParallel(): Promise<Result[]> {
    const readyTasks = this.tasks.filter(
      (t) =>
        t.status === "pending" &&
        (t.dependencies?.every((dep) =>
          this.results.get(dep)?.success
        ) ?? true)
    );

    const implementers = this.agents.filter(
      (a) => a.role === "implementer"
    );

    // 并行执行
    const promises = readyTasks.map((task, i) => {
      const agent = implementers[i % implementers.length];
      task.status = "in_progress";
      task.assignedTo = agent.model;
      return agent.execute(task).then((result) => {
        this.results.set(task.id, result);
        task.status = result.success ? "completed" : "blocked";
        return result;
      });
    });

    return Promise.all(promises);
  }

  // 审查 Agent 审查所有生成代码
  async reviewAll(): Promise<Result[]> {
    const reviewers = this.agents.filter((a) => a.role === "reviewer");
    const completedResults = Array.from(this.results.values()).filter(
      (r) => r.success
    );

    const reviewPromises = completedResults.map((result, i) => {
      const reviewer = reviewers[i % reviewers.length];
      return reviewer.execute({
        id: `review-${result.taskId}`,
        description: `审查代码: ${result.artifacts.join(", ")}`,
        status: "pending",
      });
    });

    return Promise.all(reviewPromises);
  }
}

# 多 Agent 协作实战场景：重构用户模块

# 输入需求
"重构用户模块：
1. 添加角色权限系统（admin, editor, viewer）
2. 将密码加密从 bcrypt 改为 argon2
3. 添加用户审计日志
4. 确保向后兼容现有 API"

# 架构师 Agent 输出：
# ┌─────────────────────────────────────────┐
# │ 技术设计方案                             │
# │                                         │
# │ 1. 新增 Role 枚举和 User.role 字段       │
# │ 2. 替换 @bcrypt 为 @argon2              │
# │ 3. 新增 AuditLog 模型和中间件            │
# │ 4. API 兼容层：保留旧字段，标记 @deprecated │
# │                                         │
# │ 任务拆分：                               │
# │   Task A: 数据库迁移 (Role, AuditLog)    │
# │   Task B: 密码加密替换                   │
# │   Task C: 权限中间件实现                 │
# │   Task D: API 兼容层                    │
# │   Task E: 测试更新                       │
# └─────────────────────────────────────────┘

# 并行执行（4 个实现 Agent）：
# Agent 1 → Task A (10 min)
# Agent 2 → Task B (8 min)
# Agent 3 → Task C (12 min)
# Agent 4 → Task D (6 min)
#         → Task E (等 A-D 完成后, 15 min)

# 总时间：~25 分钟（vs 单 Agent ~50 分钟）

# 审查 Agent 输出：
# ✅ Task A: 迁移正确，添加了回滚脚本
# ✅ Task B: argon2 配置合理（memoryCost: 19456）
# ⚠️ Task C: 权限检查缺少缓存，建议添加
# ✅ Task D: 兼容层完整，deprecated 标记正确
# ✅ Task E: 测试覆盖率 92%，通过

// AI 驱动测试先行（AI-driven TDD）工作流

// 步骤 1: 人类描述需求
const requirement = `
实现一个用户注册验证函数：
- 用户名：3-20 个字符，只允许字母数字和下划线
- 邮箱：有效邮箱格式
- 密码：至少 8 个字符，包含大小写字母和数字
- 返回验证结果和错误信息列表
`;

// 步骤 2: AI 生成测试用例
const generatedTests = `
describe("validateRegistration", () => {
  // 正常路径
  it("should accept valid input", () => {
    const result = validateRegistration({
      username: "user_123",
      email: "user@example.com",
      password: "SecurePass1"
    });
    expect(result.valid).toBe(true);
    expect(result.errors).toHaveLength(0);
  });

  // 边界条件
  it("should reject username too short", () => {
    const result = validateRegistration({
      username: "ab",
      email: "user@example.com",
      password: "SecurePass1"
    });
    expect(result.valid).toBe(false);
    expect(result.errors).toContain("用户名至少需要 3 个字符");
  });

  it("should reject username with special chars", () => {
    const result = validateRegistration({
      username: "user@name!",
      email: "user@example.com",
      password: "SecurePass1"
    });
    expect(result.valid).toBe(false);
  });

  it("should reject invalid email", () => {
    const result = validateRegistration({
      username: "valid_user",
      email: "not-an-email",
      password: "SecurePass1"
    });
    expect(result.valid).toBe(false);
  });

  it("should reject weak password (no uppercase)", () => {
    const result = validateRegistration({
      username: "valid_user",
      email: "user@example.com",
      password: "weakpass1"
    });
    expect(result.valid).toBe(false);
  });

  it("should reject weak password (too short)", () => {
    const result = validateRegistration({
      username: "valid_user",
      email: "user@example.com",
      password: "Ab1"
    });
    expect(result.valid).toBe(false);
  });

  it("should reject missing fields", () => {
    const result = validateRegistration({
      username: "",
      email: "",
      password: ""
    });
    expect(result.valid).toBe(false);
    expect(result.errors.length).toBeGreaterThan(0);
  });
});
`;

// 步骤 3: 人类审查测试用例
// - 是否覆盖了所有需求？
// - 是否有遗漏的边界条件？（例如：用户名已存在？）
// - 错误消息是否清晰？

// 步骤 4: AI 实现功能
const implementation = `
interface ValidationResult {
  valid: boolean;
  errors: string[];
}

export function validateRegistration(input: {
  username: string;
  email: string;
  password: string;
}): ValidationResult {
  const errors: string[] = [];

  if (!input.username || input.username.length < 3) {
    errors.push("用户名至少需要 3 个字符");
  }
  if (!/^[a-zA-Z0-9_]{3,20}$/.test(input.username)) {
    errors.push("用户名只能包含字母、数字和下划线");
  }
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(input.email)) {
    errors.push("请输入有效的邮箱地址");
  }
  if (!/(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{8,}/.test(input.password)) {
    errors.push("密码需要至少 8 个字符，包含大小写字母和数字");
  }

  return { valid: errors.length === 0, errors };
}
`;

// 步骤 5: AI 运行测试，迭代修复直到全部通过

# AI 代码审查清单（人工审查时检查这些项）

## 功能性
- [ ] 代码是否满足需求描述？
- [ ] 是否处理了所有边界条件？
- [ ] 错误处理是否完整？

## 安全性
- [ ] 是否有 SQL 注入风险？（参数化查询）
- [ ] 是否有 XSS 风险？（输出转义）
- [ ] 是否有硬编码密钥/密码？
- [ ] 权限检查是否正确？

## 性能
- [ ] 是否有 N+1 查询问题？
- [ ] 是否有不必要的循环或递归？
- [ ] 大数据量场景是否考虑？

## 可维护性
- [ ] 代码结构是否清晰？
- [ ] 命名是否有意义？
- [ ] 是否有足够的注释/文档？
- [ ] 是否遵循项目代码规范？

## AI 特有风险
- [ ] AI 是否"发明"了不存在的 API？（幻觉）
- [ ] 依赖库是否真实存在？（AI 可能编造包名）
- [ ] 代码是否过度复杂？（AI 倾向过度设计）
- [ ] 是否有不必要的抽象层？

# AI 编程实战工作流

## 1. 任务准备（5 分钟）
$ git checkout -b feature/add-pagination
$ cat << 'EOF' > task-description.md
# 任务: 为 UserAPI 添加分页
## 背景: 用户列表接口返回所有数据，数据量大时性能差
## 需求:
- 支持 page 和 page_size 参数
- 默认 page_size=20, 最大 100
- 返回总记录数 (total) 和总页数 (total_pages)
- 向后兼容：不传参数时行为不变
- 更新相关测试
## 相关文件:
- src/routes/users.ts (主路由)
- src/services/userService.ts (业务逻辑)
- src/__tests__/users.test.ts (测试)
EOF

## 2. AI 执行（5-15 分钟）
$ claude "$(cat task-description.md)"
# AI 自主读取文件 → 修改代码 → 运行测试 → 修复

## 3. 人类审查（5 分钟）
$ git diff
# 仔细检查每一处修改
$ npm test
# 确认所有测试通过
$ npm run lint
# 确认代码规范

## 4. 提交
$ git add -A
$ git commit -m "feat: 添加用户列表分页支持

AI 生成: Claude Code
Reviewed-by: 薛帅"
$ git push origin feature/add-pagination

## 5. PR 审查
# 在 PR 中记录 AI 决策和人工审查结论

# AI 代码 Git 元数据记录方案

# 方案 1: 在 commit message 中标记
git commit -m "feat(auth): 添加 JWT 刷新机制

AI-generated: Claude Code (claude-sonnet-4-20250514)
Context: 需求描述见 task-auth-refresh.md
Reviewed: Yes - 薛帅
Changes: 
  - 新增 token refresh 端点
  - 修改 auth middleware 支持 token 过期检测
  - 更新 3 个测试用例"

# 方案 2: 使用 Git trailers
git commit -m "feat: 添加用户分页

AI-generated-by: Claude Code
AI-model: claude-sonnet-4-20250514
AI-prompt-hash: sha256:abc123...
Reviewed-by: 薛帅 <xueshuai@example.com>
Tested-by: CI/CD Pipeline"

# 方案 3: 使用自定义 Git hook 自动记录
# .git/hooks/commit-msg
#!/bin/bash
# 自动在 commit message 中追加 AI 信息
if [ -f ".ai-session.json" ]; then
    echo "" >> $1
    echo "AI-generated: $(cat .ai-session.json | jq -r '.tool')" >> $1
    echo "AI-model: $(cat .ai-session.json | jq -r '.model')" >> $1
    echo "AI-tokens: $(cat .ai-session.json | jq -r '.tokens_used')" >> $1
fi

# 2026-2030 AI 编程发展路线图

2026 ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░ 35%
├── AI 编程助手普及（>50% 开发者使用）
├── 多 Agent 协作成为主流
├── MCP 协议标准化
└── AI 代码审查工具成熟

2027 ████████████████████░░░░░░░░░░░░░░░░░░ 55%
├── AI 理解项目历史和业务上下文
├── 跨模态编程（设计稿 → 代码）
├── 自主代码改进（技术债务管理）
└── AI 编程教育普及（从 CS 课程开始）

2028 ██████████████████████████░░░░░░░░░░░░ 70%
├── 规范驱动的编程（意图 → 代码）
├── AI 原生开发框架
├── 代码自动生成率 >70%
└── 开发者角色从"写代码"转为"定义问题"

2029-2030 ████████████████████████████████████ 90%
├── 全自主软件开发流水线
├── AI 与人类开发者的无缝协作
├── 软件工程教育根本性变革
└── 编程成为一种"元技能"而非职业技能

# 开发者如何应对 AI 编程时代

## 立即行动（2026）
✅ 掌握 AI 编程工具（Claude Code, Cursor）
✅ 学习 Prompt Engineering for Code
✅ 建立 AI 代码审查流程
✅ 投资自动化测试基础设施

## 中期规划（2027）
📋 学习 MCP 协议和 Agent 开发
📋 培养系统架构能力（AI 擅长编码，你擅长设计）
📋 深入理解业务领域（AI 不懂你的行业）
📋 建立 AI 编程最佳实践文档

## 长期准备（2028+）
🎯 从"代码作者"转型为"问题定义者"
🎯 培养跨领域能力（技术 + 业务 + 用户）
🎯 关注软件伦理和责任（AI 生成代码的责任归属）
🎯 持续学习——工具会变，但解决问题的能力不变

## 永远不会过时的技能
⭐ 问题分析和分解能力
⭐ 系统思维和架构设计
⭐ 沟通和协作能力
⭐ 对用户体验的敏感度
⭐ 对质量和安全的执着