# Team Roles and Capability Baseline

## Team Roles

| Role | Agent Name | Model | Color | Permission | Focus |
|---|---|---|---|---|---|
| Product Lead | `product-lead` | opus | orange | acceptEdits | 需求挖掘、PRD、任务分配、团队协调、验收 |
| Tech Lead | `tech-lead` | opus | blue | acceptEdits | 架构基线、技术选型、架构风险评审（条件触发顾问） |
| UI/UX Designer | `uiux-designer` | sonnet | purple | acceptEdits | 界面设计、交互流程、体验优化 |
| Frontend Dev | `frontend-dev` | sonnet | cyan | acceptEdits | UI 组件、页面、API 对接 |
| Backend Dev | `backend-dev` | sonnet | green | acceptEdits | REST API、数据库、服务端逻辑 |
| AI Agent Dev | `ai-agent-dev` | opus | pink | acceptEdits | LLM 集成、Prompt 工程、RAG |
| Code Reviewer | `code-reviewer` | sonnet | yellow | auto | 代码质量、安全审计 → `docs/reviews/` |
| QA Engineer | `qa-engineer` | sonnet | red | acceptEdits | E2E / UAT 测试执行、质量验证（集成层由 dev 自跑） |
| ML Engineer | `ml-engineer` | sonnet | lime | acceptEdits | 多模态模型集成、推理服务接入、图像处理 Pipeline |
| MiniApp Dev | `miniapp-dev` | sonnet | teal | acceptEdits | 微信小程序开发，默认原生，Taro 兜底 |
| MiniApp Code Reviewer | `miniapp-code-reviewer` | haiku | amber | auto | 小程序代码审查、审核合规、包体积评估 → `docs/reviews/`（haiku 由 cost-budget.md 路由：审核规则结构化，code-reviewer 兜底深度判断）|
| MiniApp QA Engineer | `miniapp-qa-engineer` | sonnet | rose | acceptEdits | 小程序 E2E / UAT 测试执行（集成层由 miniapp-dev 自跑） |
| Content Writer | `content-writer` | sonnet | violet | acceptEdits | Release notes / blog / 用户案例 / 知识沉淀 → `docs/content/` |
| Growth Analyst | `growth-analyst` | sonnet | indigo | acceptEdits | 北极星 / OMTM / A/B 实验设计与报告 → `docs/growth/` |

### Agent Tools

本节是角色 **工具集** 与 **预加载 skills** 的唯一团队级能力基线。
若 agent frontmatter、能力图谱或角色说明与本节冲突，以本文件为准，并同步修正冲突处。

> **Frontmatter 字段在不同路径的能力**（影响 spawn 后的实际行为）：
>
> | 字段 | sub-agent 路径 | `claude --agent` headless / `--bg` | Agent Team teammate 路径 |
> |---|---|---|---|
> | `tools` / `disallowedTools` | ✅ 生效 | ✅ 生效（自 2.1.119） | ✅ 生效；team 协调工具（`SendMessage` / Task*）即使被排除也始终可用 |
> | `permissionMode` | ✅ 生效 | ✅ 生效（自 2.1.119） | ❌ 忽略，teammate 继承 lead 模式 |
> | `skills` | ✅ 启动时预加载 | ✅ 启动时预加载 | ❌ **不生效**，teammate 仅按 description 关键词匹配或 `/skill-name` 显式调起，与普通 session 一致 |
> | `mcpServers` | ✅ 生效 | ✅ 生效 | ❌ **不生效**，teammate 从项目 / 用户 settings 加载 MCP，与普通 session 一致 |
> | per-agent `hooks:` | ⚠️ 在 team 路径不可靠 | ⚠️ 在 team 路径不可靠 | ❌ 不可靠，所有 hook 统一注册到 `.claude/settings.json` |
>
> **所有路径都生效的硬约束**：`settings.json` 的 `permissions.allow/deny`、agent `tools` 列表、`.claude/hooks/` 中央注册的 hook。
>
> 文档锚点：[`skills` / `mcpServers` 在 teammate 路径被忽略](https://code.claude.com/docs/en/agent-teams#use-subagent-definitions-for-teammates)；[`permissionMode` 与 headless 行为](https://code.claude.com/docs/en/sub-agents#supported-frontmatter-fields)。
>
> **实操影响**：本表后文「Plugin Skills（启动时预加载）」列只在 sub-agent 与 headless `--agent` 路径自动生效；走 `/agf-team-start` 的 Agent Team 路径下，teammate 必须在 spawn prompt 里显式提到 skill 名（如"使用 `agf-wiring-multi-llm-sdk` 接入 DeepSeek"）或依赖 description 关键词触发，否则不会被预加载。`qa-engineer` 的 `chrome-devtools` MCP 同理。
>
> Subagent 通过 `Skill` 工具发现项目 / 用户 / plugin skill 在 2.1.133 之前存在 bug，已修复——本表的 `Plugin Skills` 列在所有路径都可被对应 agent 直接 `Skill({skill: "..."})` 调起，无需绕路 Read SKILL.md 文件。

**通用工具底座**（全员默认拥有）：`Glob, Grep, Read, Write, Edit, Bash, SendMessage, TaskGet, TaskUpdate, TaskList, Skill`

下表只列出每个 agent 在通用底座之上的**调整**（增减或限制），以及预加载的 plugin skills。

| Agent | 工具调整 | Plugin Skills（启动时预加载） |
|---|---|---|
| `product-lead` | + WebFetch, WebSearch, TaskCreate | `superpowers:brainstorming`, `superpowers:writing-plans`, `superpowers:using-git-worktrees`, `superpowers:requesting-code-review`, `superpowers:receiving-code-review`, `superpowers:finishing-a-development-branch` |
| `tech-lead` | + WebFetch, WebSearch | `superpowers:brainstorming`, `superpowers:writing-plans`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:requesting-code-review`, `superpowers:receiving-code-review` |
| `uiux-designer` | + WebFetch | `frontend-design:frontend-design` |
| `frontend-dev` | + WebFetch | `frontend-design:frontend-design`, `feature-dev:feature-dev`, `agf-running-sit-tests`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:receiving-code-review` |
| `backend-dev` | （仅通用底座） | `code-simplifier:code-simplifier`, `feature-dev:feature-dev`, `agf-wiring-multi-llm-sdk`, `agf-running-sit-tests`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:receiving-code-review` |
| `ai-agent-dev` | + WebFetch, WebSearch, TaskCreate | `feature-dev:feature-dev`, `agf-wiring-multi-llm-sdk`, `agf-running-sit-tests`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:receiving-code-review` |
| `code-reviewer` | − Edit；Write 限 `docs/reviews/`（review-only） | `code-review:code-review`, `code-simplifier:code-simplifier`, `simplify`（仅 Phase 1+2 review，不跑 Phase 3 fix）, `agf-running-sit-tests`（reviewer 不跑 SIT，audit 时参考 SIT 范围 / 评估 dev SIT 结论是否合理） |
| `qa-engineer` | + `mcpServers: chrome-devtools`（plugin 提供，E2E 浏览器测试用） | `chrome-devtools-mcp:chrome-devtools`, `agf-writing-qa-report`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion` |
| `ml-engineer` | + WebFetch, WebSearch | `agf-wiring-multi-llm-sdk`, `agf-running-sit-tests`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:receiving-code-review` |
| `miniapp-dev` | + WebFetch | `feature-dev:feature-dev`, `agf-running-sit-tests`, `superpowers:test-driven-development`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion`, `superpowers:receiving-code-review` |
| `miniapp-code-reviewer` | − Edit；Write 限 `docs/reviews/`（review-only） | `code-review:code-review`, `code-simplifier:code-simplifier`, `simplify`（仅 Phase 1+2 review，不跑 Phase 3 fix）, `agf-running-sit-tests`（reviewer 不跑 SIT，audit 时参考 SIT 范围 / 评估 dev SIT 结论是否合理） |
| `miniapp-qa-engineer` | （仅通用底座） | `agf-writing-qa-report`, `superpowers:systematic-debugging`, `superpowers:verification-before-completion` |
| `content-writer` | + WebFetch, WebSearch | `superpowers:brainstorming` |
| `growth-analyst` | + WebFetch, WebSearch | `superpowers:brainstorming`, `superpowers:writing-plans` |

通用工具底座 + 其他 plugin skills 均来自 Claude Code 内置或官方 plugin marketplace。`qa-engineer` 的 `chrome-devtools` MCP server 由官方 plugin `chrome-devtools-mcp`（v0.22.0+）提供，用户首次接手模板需 `/plugin install chrome-devtools-mcp` 安装；其余角色无第三方依赖，可直接分发复用。
