| name | agent-team |
| description | 需求复杂、需要多角色并行协作时使用(通常由 ai-pm --team 自动调度,也可直接调用)。 当用户说「多代理模式」「并行执行」「需求很复杂需要团队协作」「--team模式」「多角色协同」时使用此技能。 |
| argument-hint | [需求描述] [--mode=serial|parallel|agile] [--roles=pm,architect,designer] |
| allowed-tools | Read Write Edit Bash(mkdir) Bash(ls) Bash(cat) Bash(grep) Bash(python3) Agent |
Agent Team - 多代理协作引擎
通常由 /ai-pm --team 自动调度。也支持直接调用 /agent-team [需求描述]。
代理团队构成
核心角色
| 代理 | 角色 | 主要职责 |
|---|
| orchestrator | 协调者 | 任务分解、代理调度、冲突解决 |
| product-manager | 产品经理 | 需求澄清、竞品分析、PRD产出 |
| architect | 架构师 | 架构设计、技术选型、可行性评估 |
| ui-designer | UI设计师 | 交互设计、原型产出、设计规范 |
| data-analyst | 数据分析师 | 数据洞察、指标设计、埋点方案 |
| tech-writer | 技术文档工程师 | 文档整合、格式规范、质量把控 |
现场调研专属角色
| 代理 | 角色 | 主要职责 |
|---|
| user-researcher | 用户研究员 | 访谈执行、行为观察、洞察分析 |
| requirement-synthesizer | 需求整合师 | 需求提取、信息整合、优先级排序 |
触发方式
| 方式 | 命令 | 说明 |
|---|
| ai-pm 自动调度(推荐) | /ai-pm --team "需求" | ai-pm 判断复杂度后自动调用本引擎 |
| 直接调用 | /agent-team "需求" | 跳过 ai-pm 主控,直接启动多代理 |
协作模式
| 参数 | 模式 | 适用场景 |
|---|
--mode=serial | 串行:PM → Architect → Designer → Writer | 复杂项目,各阶段有强依赖 |
--mode=parallel(默认) | 并行:独立子任务同时执行后汇总 | 时间紧迫,任务可拆分 |
--mode=agile | 敏捷:迭代式快速交付,多轮反馈 | 需求不明确,MVP探索 |
Orchestrator 执行协议(Wave 模式)
所有角色通过 Agent tool 真正并行执行,替代原有「模拟角色切换」方式。
Wave 执行流程
Wave 1(并行,无依赖):
使用 Agent tool 同时派发以下 subagent(根据需求选择):
Agent → subagent-PM
系统提示词:「你是资深产品经理,仅完成任务,不与用户交互」
任务:基于需求「{用户需求}」,完成需求分析
输出:{项目目录}/02-analysis-report/V{n}.md(文件夹制)
Agent → subagent-Analyst
系统提示词:「你是竞品分析师,仅完成任务,不与用户交互」
任务:基于需求「{用户需求}」,完成竞品研究
输出:{项目目录}/03-competitor-report/V{版本}.md
Agent → subagent-KB(可选,知识库有相关内容时启用)
系统提示词:「你是知识库检索员,仅完成任务,不与用户交互」
任务:搜索知识库中与「{需求关键词}」相关的经验
输出:{项目目录}/_tmp/kb-insight-{项目名}.md(项目内唯一名,跑前 rm;/tmp 通用名跨项目会串稿)
Wave 1 全部完成后,向用户汇报结果摘要。
Wave 2(依赖 Wave 1 输出):
派发 subagent-PRD 之前(主对话做,确定性,与 phase-5「🌱 扎根注入」同源):查 {项目目录}/05-prd/ai-md/_conventions.md——存在则把骨架 + 词表 + 黑名单作为「项目约定」块拼进下方任务 prompt,并落 05-prd/_logs/grounding-input.md;无约定包但有历史 PRD 则先按 phase-5 建包;0→1 项目跳过。
Agent → subagent-PRD
系统提示词:「你是 PRD 撰写专家,仅完成任务,不与用户交互」
任务:
读取:{项目目录}/02-analysis-report/ 最新 V
读取:{项目目录}/03-competitor-report/V{版本}.md
读取:{项目目录}/_tmp/kb-insight-{项目名}.md(如存在)
动笔前读:.claude/skills/ai-pm/references/pm-judgment-card.md(越界红线 / 责任分工 / §9 守门)
选模板 + 守骨架:先判 doctype 选模板(决策评审 → decision-review-template / 全员 → feishu-template+product_type),守 §一/二/三/六 承重骨架、不塌成 bullet(指针·判断卡 §6 二分 + phase-5 步骤 A.0/A.0.1,不复制逻辑);接 A.0.1 写 doctype 三处
项目约定块(如有):章节名/术语照约定用,发明新词必须显式标理由
篇幅与分层:按 phase-5「双层组织」分级定档(小补丁别硬撑附录壳、但 §一/二/三/六 骨架不丢)
输出:{项目目录}/05-prd/<当前 PRD 文件>(落盘后写 _status.json.active_prd)
Wave 3(依赖 Wave 2 输出,按需启动):
Agent → subagent-Review
系统提示词:「你是资深评审专家,仅完成任务,不与用户交互」
任务:
读取:{项目目录}/05-prd/<当前 PRD 文件>(由 _status.json.active_prd 指定)
执行精简版三角色评审(产品+前端开发+测试)
输出:{项目目录}/08-review-report-v1.md
启动规则:默认自动启动;若用户传入 --skip-review 则跳过。
模式映射
| 参数 | Wave 执行策略 |
|---|
--mode=serial | Wave 1: PM → Wave 2: PRD(读取PM输出)→ Wave 3: Review |
--mode=parallel(默认) | Wave 1: PM+Analyst 同时 → Wave 2: PRD → Wave 3: Review |
--mode=agile | Wave 1: PM+Analyst+KB → Wave 2: PRD(轻量版=省竞品/前置·骨架不省)→ 快速交付 |
serial 模式说明:Wave 1 仅派发 subagent-PM,Wave 2 的 PRD 不含竞品研究,适用于快速小需求。
agile「轻量版」说明:轻在省竞品研究 / 前置调研、多轮快迭代,不轻在骨架——PRD 仍走完整模板(§一/二/三/六 承重骨架必有,详见判断卡 §6 二分);"轻量版" ≠ bullet 版。
约束
- 每个 subagent 的提示词必须包含「不与用户交互」
- subagent 的所有输入(文件路径、项目目录)在 Agent tool 调用时传入,不能运行时询问
- subagent 产出必须落文件,主线程读文件做汇总,不依赖 subagent 的返回文本
Wave 容错规范
失败记录
当某 subagent 执行失败(超时、报错、文件未落盘)时:
- 不中断整个 Wave;同 Wave 的其他 subagent 继续执行
- 将失败信息写入项目
_status.json 的 agent_errors 字段:
"agent_errors": {
"{wave_id}_{agent_role}": {
"error": "{错误摘要,不超过 100 字}",
"timestamp": "{ISO8601}",
"retryable": true
}
}
命名规则:key 为 wave{N}_{role},例如 wave1_analyst、wave2_prd。
- Wave 结束后向用户汇报结果:
Wave 1 完成(1 个 subagent 失败):
✅ subagent-PM → 02-analysis-report/V{n}.md
❌ subagent-Analyst → 竞品数据获取超时(可重试)
继续 Wave 2?或重试失败项?
继续 / 重试
--retry 参数
/ai-pm --team --retry=wave1:
- 读
_status.json.agent_errors,筛选 key 以 wave1_ 开头且 retryable: true 的条目
- 仅重跑失败的 subagent,已成功的 subagent 输出文件保留不变
- 重跑成功后,清除
agent_errors 中对应条目
- 重新执行后续 Wave(依赖被修复输出的 Wave)
限制:--retry 只能重跑有错误记录的 Wave,不支持强制重跑已成功的 Wave。
任务分解与角色分配
| 任务类型 | 所需角色 | 推荐模式 |
|---|
| 需求分析 | PM + Analyst | 并行 |
| 产品设计 | PM + Designer | 串行 |
| 技术方案 | Architect + PM | 串行 |
| 完整项目 | 全体角色 | 串行/敏捷 |
| 数据洞察 | Analyst | 并行 |
| 现场调研(单客户) | Researcher + Synthesizer + PM | 串行 |
| 现场调研(多客户) | 多Researcher + Synthesizer + PM | 并行 |
命令参考
| 命令 | 功能 |
|---|
/agent-team "需求" | 启动完整团队处理需求 |
/agent-team --mode=serial "需求" | 串行模式 |
/agent-team --mode=parallel "需求" | 并行模式(默认) |
/agent-team --mode=agile "需求" | 敏捷模式 |
/agent-team --roles=pm,architect "需求" | 仅启用指定角色 |
/agent-team --skip-review "需求" | 跳过评审阶段 |
/ai-pm --team --retry=wave1 | 重跑 Wave 1 中失败的 subagent(保留已成功输出) |
/ai-pm --team --retry=wave2 | 重跑 Wave 2 中失败的 subagent |
/ai-pm --team "需求" | 推荐方式:经由 ai-pm 自动调度 |