agent-team

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 执行失败（超时、报错、文件未落盘）时：

1. 不中断整个 Wave；同 Wave 的其他 subagent 继续执行
2. 将失败信息写入项目 _status.json 的 agent_errors 字段：

"agent_errors": {
  "{wave_id}_{agent_role}": {
    "error": "{错误摘要，不超过 100 字}",
    "timestamp": "{ISO8601}",
    "retryable": true
  }
}

命名规则：key 为 wave{N}_{role}，例如 wave1_analyst、wave2_prd。

3. Wave 结束后向用户汇报结果：

Wave 1 完成（1 个 subagent 失败）：
  ✅ subagent-PM → 02-analysis-report/V{n}.md
  ❌ subagent-Analyst → 竞品数据获取超时（可重试）

继续 Wave 2？或重试失败项？
  继续 / 重试

--retry 参数

/ai-pm --team --retry=wave1：

1. 读 _status.json.agent_errors，筛选 key 以 wave1_ 开头且 retryable: true 的条目
2. 仅重跑失败的 subagent，已成功的 subagent 输出文件保留不变
3. 重跑成功后，清除 agent_errors 中对应条目
4. 重新执行后续 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 自动调度