agent-teams

name	agent-teams
description	Path D parallel execution with Lead-Teammate architecture and context handoff

Agent Teams (Path D)

工具

工具	类型	用法	调用方式
Agent Teams API	Claude Code	并行执行	env: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
skill/worktrees	VibeCoding Skill	隔离分支	E 阶段自动加载
skill/tdd	VibeCoding Skill	每个 teammate 强制 TDD	自动
cunzhi MCP	MCP	Lead gates	cunzhi.confirm(TEAM_PLAN / TEAM_DONE)
commit-commands	Plugin	各 teammate 提交规范	自动: git commit 时
Superpowers subagent-driven-dev	Plugin Skill	teammate 内部子任务	自动

架构

Lead Agent (主会话)
  ├─ R→D→P→C          ← Lead 独立完成
  ├─ cunzhi [TEAM_PLAN] ← 寸止: 确认分工
  ├─ Teammate A         ← 独立窗口, 模块 A
  ├─ Teammate B         ← 独立窗口, 模块 B
  └─ Lead: V→Rev       ← 合并后审查

Teammate 上下文传递

Teammates 继承 CLAUDE.md 和 settings.json，但不继承 .ai_state。 Lead 分配时必须传入:

# Lead 分配模板 (每个 Teammate)
---
## 你的任务
[从 plan.md 截取该 teammate 负责的 TASK 列表]

## 项目约定
[从 conventions.md 完整复制]

## 目标文件范围
[该 teammate 可以修改的文件/目录列表]

## 分支
feature/vibe-{id}-{module}

## 完成标准
- 所有 TASK 的 RED-GREEN-REFACTOR 完成
- 测试覆盖率 ≥85%
- 无 TypeScript any
- commit 后推送到子分支
---

何时用 Teams vs Subagent

	Subagent	Agent Teams
粒度	单任务 (2-5min)	模块级 (数小时)
上下文	共享主会话	各自独立
适用	Path B/C E 阶段	Path D
工具	Superpowers subagent-driven-dev	Claude Code Agent Teams

不需要互通 → subagent。需要协调 → Teams。

Git 策略

加载 skill/worktrees:

Lead:  feature/vibe-{id}-main
  ├─ Teammate: feature/vibe-{id}-frontend
  ├─ Teammate: feature/vibe-{id}-backend
  └─ Teammate: feature/vibe-{id}-tests
合并顺序: tests → backend → frontend → main
冲突处理: Lead 手动解决 + cunzhi 确认

降级

Agent Teams 失败 → Path C 顺序执行。记录原因到 decisions.md。 Codex CLI: Path D 自动降级 Path C (无 Agent Teams 支持)。