Agentic Coding 实战：使用 Claude Code 多 Agent 协作完成复杂软件开发任务

创建项目并初始化

# 创建项目目录
mkdir -p ecommerce-demo && cd ecommerce-demo

# 初始化 Git 仓库
git init

# 创建基础项目结构
mkdir -p src/{frontend,backend,database,tests}
touch README.md

启动 Claude Code 并启用 Agent Teams：

# 方式 1：命令行参数
claude --agent-teams

# 方式 2：环境变量
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

定义团队角色与任务

在对话中明确指定各 Agent 的职责：

请创建一个 Agent 团队来完成电商系统开发，团队结构如下：

**组长 Agent**：负责整体架构设计、任务分解、代码审查

**组员 Agent 1 - 前端专家**：
- 技术栈：React 19 + TypeScript + Tailwind CSS
- 任务：商品列表页、购物车、结账流程

**组员 Agent 2 - 后端专家**：
- 技术栈：Node.js 22 + Express + TypeScript
- 任务：RESTful API、认证授权、订单管理

**组员 Agent 3 - 数据库专家**：
- 技术栈：PostgreSQL 17 + Prisma ORM
- 任务：数据库设计、迁移脚本、数据模型

**组员 Agent 4 - 测试专家**：
- 技术栈：Vitest + Playwright
- 任务：单元测试、集成测试、E2E 测试

组长 Agent 分解任务

组长 Agent 接收初始需求后，自动分解为可执行的子任务：

## 共享任务列表

### Phase 1: 数据库层
- [ ] 设计用户、商品、订单数据模型
- [ ] 编写 Prisma schema
- [ ] 生成迁移脚本

### Phase 2: 后端 API
- [ ] 用户认证模块（JWT）
- [ ] 商品 CRUD 接口
- [ ] 购物车接口
- [ ] 订单创建与查询

### Phase 3: 前端界面
- [ ] 商品列表与搜索
- [ ] 购物车页面
- [ ] 结账流程

### Phase 4: 测试与集成
- [ ] 单元测试覆盖核心逻辑
- [ ] API 集成测试
- [ ] E2E 流程测试

任务分解遵循SMART 原则：具体（Specific）、可衡量（Measurable）、可实现（Achievable）、相关性（Relevant）、时限性（Time-bound）。

并行执行子任务

各组员 Agent 领取任务后并行执行。以下是后端 Agent 的工作示例：

// backend/src/routes/products.ts
import { Router } from 'express';
import { prisma } from '../lib/prisma';

const router = Router();

// GET /products - 获取商品列表
router.get('/', async (req, res) => {
  const { page = 1, limit = 20, search } = req.query;

  const products = await prisma.product.findMany({
    where: search ? {
      name: { contains: search as string }
    } : {},
    skip: (Number(page) - 1) * Number(limit),
    take: Number(limit),
    include: { category: true }
  });

  res.json(products);
});

export default router;

同时，前端 Agent 正在开发对应的 UI 组件：

// frontend/src/components/ProductList.tsx
'use client';

export function ProductList({ products }: { products: Product[] }) {
  return (
    <div className="grid grid-cols-4 gap-4">
      {products.map(product => (
        <ProductCard key={product.id} product={product} />
      ))}
    </div>
  );
}

跨 Agent 代码审查

组员之间可以相互审查代码。测试 Agent 发现后端接口的边界问题：

@后端专家 我注意到 `/products` 接口缺少以下验证：

1. **分页参数验证**：`page` 和 `limit` 没有最小值检查
   ```typescript
   // 建议添加
   if (page < 1 || limit < 1 || limit > 100) {
     return res.status(400).json({ error: 'Invalid pagination' });
   }
   ```

2. **搜索关键词长度限制**：防止 SQL 注入风险
   ```typescript
   if (search && search.length > 100) {
     return res.status(400).json({ error: 'Search term too long' });
   }
   ```

请修复后重新提交测试。

后端 Agent 接受建议并修复，然后通知测试 Agent 重新运行测试。这种自主协作大幅减少了人工干预。

使用 tmux 并行监控

使用 tmux 分屏功能同时观察多个 Agent 的执行状态：

# 启动 tmux 会话
tmux new -s agent-teams

# 分割窗格（4 个 Agent + 1 个组长）
Ctrl+b, %  # 垂直分割
Ctrl+b, %  # 再次分割
Ctrl+b, "  # 水平分割
# ... 重复直到 5 个窗格

# 在每个窗格中启动对应的 Agent
# 窗格 1：组长
CLAUDE_CODE_AGENT_TEAM=lead claude

# 窗格 2-5：组员
CLAUDE_CODE_AGENT_TEAM=frontend claude
CLAUDE_CODE_AGENT_TEAM=backend claude
CLAUDE_CODE_AGENT_TEAM=database claude
CLAUDE_CODE_AGENT_TEAM=test claude

整合与部署

所有任务完成后，组长 Agent 负责整合代码并部署：

# 组长 Agent 执行整合
git merge frontend-branch main
git merge backend-branch main
git merge database-branch main

# 运行完整测试套件
npm run test
npm run test:e2e

# 部署到生产环境
docker-compose up -d
npm run deploy:prod

部署成功后，生成项目报告：

## 项目完成报告

**开发时长**: 45 分钟（传统方式约 8 小时）
**代码行数**: 1,247 行
**测试覆盖**: 87%
**Bug 数量**: 0（所有问题在审查阶段修复）

**团队贡献统计**:
- 前端 Agent: 423 行代码
- 后端 Agent: 512 行代码
- 数据库 Agent: 156 行代码
- 测试 Agent: 156 行测试用例