Claude Code Agent Teams 使用指南#

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Create a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.

{
  "teammateMode": "tmux"
}

# 让特定队友停止工作
Ask the researcher teammate to shut down

# 等待所有队友完成
Wait for your teammates to complete their tasks before proceeding

# 清理团队
Clean up the team

创建一个 agent team 来开发「商品盘点」功能：

- 队友A（数据层）：负责 OSModel 实体类/请求模型/枚举 + OSDAL 数据访问层
  文件范围：OSModel/Entities/、OSModel/Requests/、OSModel/Enums/、OSDAL/

- 队友B（业务层）：负责 OSInterface 接口定义 + OSBLL 业务逻辑层
  文件范围：OSInterface/、OSBLL/

- 队友C（API层）：负责 OSAPI Controller + 路由配置
  文件范围：OSAPI/Controllers/

- 队友D（测试）：负责 Tests 单元测试 + 集成测试
  文件范围：Tests/UnitTests/、Tests/IntegrationTests/

- 队友E（文档，可选）：负责接口文档 + 开发文档
  文件范围：doc/接口文档/、doc/开发文档/

创建一个 agent team 来开发商品盘点功能，参考项目的分层架构（OSAPI/OSBLL/OSDAL/OSInterface/OSModel）。
请先阅读 CLAUDE.md 了解项目规范，再阅读 doc/进销存设计文档/非油品盘点/ 下的设计文档。

- 队友A：负责 OSModel（实体类、请求模型、枚举）和 OSDAL（数据访问层），参考现有的 InboundOrderDAL 风格
- 队友B：负责 OSInterface（接口定义）和 OSBLL（业务逻辑），参考现有的 InboundOrderBLL 风格
- 队友C：负责 OSAPI Controller，参考现有的 GoodsInboundOrderController 风格
- 队友D：负责编写单元测试和集成测试，参考 Tests/UnitTests/ 和 Tests/IntegrationTests/ 的风格

Use Sonnet for each teammate.

创建一个 agent team 来给所有 DAL 层添加操作日志记录：

- 队友A：负责 商品管理 + 分类 + SKU拆装 模块
  文件：GoodsBaseInfoDAL.cs、CategoryDAL.cs、SkuPackageRelationDAL.cs

- 队友B：负责 采购 + 入库 + 库存 模块
  文件：PurchaseOrderDAL.cs、InboundOrderDAL.cs、GoodsInventoryStockDAL.cs、InventoryBatchDAL.cs

- 队友C：负责 销售 + 团购 + 调价 模块
  文件：GoodsPriceDAL.cs、PriceAdjustmentDAL.cs、WholesaleOrderDAL.cs

- 队友D：负责 仓库 + 计量单位 + 供应商 模块
  文件：WarehouseDAL.cs、MeasurementUnitDAL.cs、GoodsSupplierRelationDAL.cs

创建一个 agent team 来调查库存扣减不准确的问题：

- 队友A（入口追踪）：从 Controller → BLL → DAL 追踪请求处理流程
  重点文件：GoodsInventorySalesController.cs → SalesDeductionBLL.cs → GoodsInventoryStockDAL.cs

- 队友B（数据验证）：通过 MCP 查数据库，检查 inventory_stock / batches / transactions 数据一致性
  重点：对比 goods_inventory_stock 余额与 goods_inventory_transactions 流水合计是否一致

- 队友C（并发与边界分析）：检查事务隔离级别、锁机制、MQ 消费幂等性、负库存回填逻辑
  重点文件：NegativeInventoryFillDAL.cs、InventoryTransactionDAL.cs、GoodsMQ.cs

创建一个 agent team 来设计「退货管理」功能的完整方案：

- 队友A（产品设计）：运行 /erp-product-manager 产出 PRD，然后运行 /technical-architect 产出技术分析文档
- 队友B（原型设计）：运行 /prototype-ui-designer 根据业务需求生成前端原型页面
- 队友C（任务拆解）：等队友A完成后，运行 /dev-task-breakdown 产出开发任务拆解文档

创建一个 agent team 来进行发版前质量检查：

- 队友A（单元测试）：运行 Tests/UnitTests/ 下所有测试，修复失败用例，关注 BLL/DAL 逻辑正确性
- 队友B（集成测试）：运行 Tests/IntegrationTests/ 下所有测试，验证端到端业务流程
- 队友C（数据库验证）：通过 MCP 连接数据库，验证关键表的数据完整性和一致性
  重点检查：goods_inventory_stock、goods_inventory_batches、goods_inventory_transactions

用户 → 调用 /erp-product-manager → 产出 PRD
     → 调用 /technical-architect → 产出技术文档
     → 调用 /dev-task-breakdown  → 产出任务拆解
     → 调用 /dev-pipeline-orchestrator → 生成代码
     → 调用 /prototype-ui-designer → 生成原型

Team Lead（你） ──┬── 队友A（独立实例）──→ 并行干活
                  ├── 队友B（独立实例）──→ 并行干活
                  ├── 队友C（独立实例）──→ 并行干活
                  └── 队友D（独立实例）──→ 并行干活
                         ↕ 队友之间可以直接沟通

PRD(20分钟) → 技术文档(15分钟) → 任务拆解(15分钟) → 代码生成(30分钟)
总耗时：约 80 分钟

Agent Teams 方式：
队友A：PRD ──→ 技术文档 ──┐
队友B：原型设计 ──────────┤──→ 队友C：任务拆解 → 代码生成
总耗时：约 50 分钟（节省 30 分钟）

PRD 文档（5000+ 字）
+ 技术分析文档（5000+ 字）
+ 任务拆解文档（3000+ 字）
+ Model 层代码
+ DAL 层代码
+ Interface 层代码
+ BLL 层代码
+ Controller 层代码
+ 测试代码
= 上下文严重膨胀，后期生成质量下降

场景：开发「商品盘点」功能

Team Lead 创建团队：

队友A（产品线）：                              ┐
  → 调用 /erp-product-manager 写 PRD          │ 同时进行
  → 调用 /technical-architect 写技术文档       │
                                               │
队友B（原型线）：                              │
  → 调用 /prototype-ui-designer 画原型页面     ┘

队友C（开发线）：等 A 完成后
  → 调用 /dev-task-breakdown 拆任务
  → 调用 /dev-pipeline-orchestrator 生成代码

队友D（质量线）：等 C 完成后
  → 审查代码质量
  → 通过 MCP 验证数据库

你的任务是什么？
│
├── 标准化流水线任务（PRD → 技术文档 → 代码）
│   └── ✅ 用 Skills 工作流即可
│
├── 简单 CRUD 开发（分类、仓库、计量单位）
│   └── ✅ 用单 Agent + Subagent 即可
│
├── 复杂新功能开发（涉及 3 层以上联动）
│   └── ✅ 用 Agent Teams，队友按层分工
│
├── 跨模块批量修改 / 重构
│   └── ✅ 用 Agent Teams，队友按模块分组
│
├── 复杂 Bug 调查
│   └── ✅ 用 Agent Teams，竞争性假设
│
├── 代码评审 / 质量检查
│   └── ✅ 用 Agent Teams，多角度并行审查
│
└── 复杂功能的完整生命周期（产品设计 + 开发 + 测试）
    └── ✅ 用 Agent Teams + Skills 组合