---
description: 启动 Agent Team 完成多角色产品/功能交付
argument-hint: <产品或功能描述>
---

参考 `CLAUDE.md` "Team Mode" 节与 `.claude/standards/workflow.md`。

# 任务

$ARGUMENTS

# 执行指令

Create an agent team to deliver the task above. Team name 由你根据任务内容自动命名（驼峰式 + Team 后缀，例如 `LoginRevampTeam`）。

Spawn teammates **by subagent type name only** (do NOT use `@` file references — definitions are auto-loaded by Claude Code).

**Teammate 选择规则**：
- 默认 spawn 下表 5 个 teammate
- **如果任务消息含 `[teammates: A,B,C]` 标记行**（脚本入口会带），则**仅** spawn 标记中列出的 teammate；每个的 initial task 由你按 feature 描述与 PRD 上下文合理推断（参考下表的 initial task 模板）

| Teammate | Initial task 模板（默认 / 推断参考） |
|---|---|
| `product-lead` | 调用 `superpowers:brainstorming` 澄清需求，输出 PRD 草稿到 `docs/prd/<feature>-<YYYY-MM-DD>.md`，列出至少 3 个开放问题 |
| `tech-lead` | 检查 `docs/adr/` 是否覆盖本任务所需技术基线；已覆盖则合规检查并回报，未覆盖则起草新 ADR 大纲 |
| `frontend-dev` | 阅读 `src/` / `frontend/`（如存在）后输出页面骨架与状态管理切分计划 |
| `backend-dev` | 阅读 `backend/`（如存在）后输出 API 契约草案（路径、请求/响应 schema） |
| `qa-engineer` | 阅读 PRD 草稿后准备 E2E/UAT 测试策略框架（先不执行；SIT 由 dev 自跑，不在 qa 范围） |
| 其它 teammate | 按角色 description 与 PRD 推断一个可立即执行的初始任务 |

**Initial task 沉默契约（追加到每条初始任务消息末尾）**：

> 完成后只回 **1 句话**给 lead：`<状态> + <产物路径>`（例：`PRD 草稿已落 docs/prd/login-2026-05-18.md，3 个开放问题在 §8`）。不要在聊天区复述任务内容、不要列 next steps、不要贴 diff —— 细节落产物文件 / `progress/<role>.md`。

# 约束

1. **必须**是 agent team，不是 subagent。Spawn 完成后**显式确认**："This is an agent team, not subagents."
2. Lead 固定为 `product-lead`。
3. 报告每个 teammate 的 **name + agent ID**：必须用 **markdown 表格**输出，**1 行/teammate**，列 = `name | agent ID | initial task 一句话`。**禁止**为每个 teammate 写一段散文式介绍、禁止复述 initial task 全文、禁止预告"接下来 X 会 Y"。整段 spawn 汇报（确认句 + 表格）合计 ≤ 15 行。
4. Spawn 之后由 `product-lead` 接管协调，按 `.claude/standards/workflow.md` 推进交付链路（dev 自跑 Unit + SIT → code review（含 SIT Audit）→ E2E → UAT）。
5. 多个同类型实例并行时遵守 `.claude/standards/workflow.md` "Parallel Dispatch" 节（文件归属 + 临界区 + 完成报告列全文件）。
6. 显示模式由 `.claude/settings.json` 的 `teammateMode` 控制，不要在 spawn prompt 里指定 pane / tmux 行为。

# 任务规模过小怎么办

如果任务明显单角色就能完成（仅文案改动 / 单点 bugfix / 纯查询），不要建 team——直接告诉用户："本任务规模过小，建议改用 `请启动 <角色>` 的单角色 subagent 路径，无需启用 agent team。"

# 另一种路径：Agent View（独立并行执行）

> 适用 Claude Code v2.1.139+。本节不走 `.claude/rules/team-mode.md` 的 Agent Team 协议，因为没有 lead / mailbox / 共享 task list。

## 何时选这条路（而不是 Agent Team）

任务可拆成 **≥2 个互相独立的执行单元**、且满足以下**全部**条件：

- 子任务之间不需要中途讨论 / 互相质疑 / 共享发现（每个 worker 拿到 spec 就能独立完工）
- 已有 PRD 或明确 spec（不需要 product-lead 现场澄清）
- 每个子任务有清晰的交付物边界（独立 PR / 独立 feature 子目录 / 独立报告）

**典型场景**：基于已签字 PRD 的并行实现（backend API + frontend 页面 + SIT 用例）、批量代码审查（同时审 N 个 PR）、跨 repo 的同形修改（monorepo 多包同步升级）。

**反例**（继续走 Agent Team）：需求还在演化、需要 devil's advocate、teammate 间要交换中间结果、有跨 worker 的依赖等待。

## 启动方式

```bash
# 1. 派工（每条命令开一个独立 background session，自动 worktree 隔离）
claude --agent backend-dev    --bg "实现 <feature> 的 API：契约见 docs/prd/<feature>.md §3"
claude --agent frontend-dev   --bg "实现 <feature> 的页面：原型见 docs/design/<feature>/index.html"
claude --agent qa-engineer    --bg "为 <feature> 写 E2E 用例：AC 见 docs/prd/<feature>.md §4（SIT 由 dev 自跑，不在 qa 范围）"

# 2. 一屏看全局（PR 状态点自动追踪：黄=等审 / 绿=通过 / 紫=已 merge）
claude agents
```

面板里：`Space` peek、`Enter` attach、`Ctrl+X` 停 session（再按一次删除并清 worktree）、`←` 在空 prompt 上一键 background + 切回面板。

## 注意事项

- **配额按 session 算**：N 个并行 session = N 倍订阅消耗，跑前先掂量
- **机器睡眠会停**：醒来后 `claude respawn --all` 恢复
- **worktree 自动建在 `.claude/worktrees/`**：删 session 时一并清理，未提交改动会丢——重要工作先 `git push` 或 `git commit` 再删
- **Sub-agent / teammate 不在面板里列**：只列 top-level background session
- **不能替代 product-lead 协调**：本路径**不做** PRD 演化、不做 UAT 签字、不做跨 worker 冲突仲裁；这些仍需 `/agf-team-start` 走 Agent Team 路径
- **本路径不写 progress/<role>.md**：Self-Reporting Pattern（`.claude/standards/ac-lifecycle.md`）默认绑定 Agent Team；如需保留底稿，在每个 `--bg` 的 prompt 里显式要求 worker 在完成时 append 到 `progress/<role>.md`
- **`permissionMode: auto` / `bypassPermissions` 的 agent 不能直接 `--bg`**：[Claude Code 安全门](https://code.claude.com/docs/en/agent-view#permission-mode-and-settings)规定，未在交互模式接受过该 mode 之前，`--bg` 启动这两类 agent 会被拒绝。哪些 agent 落在这两类，以 `.claude/standards/team-roles.md` "Team Roles" 表的 `Permission` 列为准（不在本文复述名单，避免双写）。规避方法：先 `claude --agent <name>` 在交互模式跑一次接受弹窗，之后即可用 `--bg` 派工
- **`--bg` 启动的是 sub-agent 形态**：frontmatter 行为与 Agent Team 路径不同，详见 `.claude/standards/team-roles.md` 能力对照表

## 选哪条路：一句话决策表

| 场景信号 | 选 |
|---|---|
| 多 worker 要互相讨论 / 质疑 / 共享中间发现 | **Agent Team**（默认） |
| 需要 lead 实时协调 / 仲裁文件冲突 / 推进 UAT 签字 | **Agent Team** |
| 已有 spec，子任务独立可并行，只想看进度 + 自动收 PR | **Agent View** |
| 单角色任务 | 直接 `请启动 <角色>` 走 subagent，两条路径都不用 |
