# AppGenesisForge — 角色能力图谱

## 1. 端到端管道总览（全景）

> 本节把**角色 + 阶段门 + hook 触发点 + skill 强制调用 + 失败回路 + 并行派发 + 小程序分支 + 上线后链路**叠加在一张图上。其他章节是局部视角：§2 角色消息流、§3 通信关系网络、§4-§7 角色能力详情。**只想看一张图就理解整个团队 → 看本节**。

### 1.1 主流程图（用户提需求 → UAT 签字 → 可选上线后产物）

```mermaid
flowchart TD
    USER([👤 用户提需求])
    SE{主 Claude<br/>Session Entry 判断}

    subgraph S1 [📍 阶段 1: 需求澄清 — product-lead]
        BS[🧠 skill: brainstorming<br/>模糊/多选项时强制]
        PRD[(📄 PRD<br/>docs/prd/feature-YYYY-MM-DD.md<br/>10 节结构 / skill: agf-writing-prd)]
        WP[📋 skill: writing-plans<br/>≥3 AC 或跨角色时强制]
    end

    subgraph S2 [📍 阶段 2: 任务派发 — product-lead]
        TC[TaskCreate<br/>6 段 schema<br/>hook: validate-task-schema]
        PD{≥2 execution<br/>teammate?}
        WT[skill: using-git-worktrees<br/>worktree 强制隔离]
    end

    subgraph S3 [📍 阶段 3: 实现 — 执行层]
        UX[🟣 uiux-designer<br/>spec.md + index.html]
        FE[🩵 frontend-dev]
        BE[🟢 backend-dev]
        AI[🩷 ai-agent-dev]
        ML[🟩 ml-engineer]
        MD["🟦 miniapp-dev<br/>(小程序分支替换 FE)"]
        TL[🔵 tech-lead<br/>条件触发顾问]
    end

    subgraph S3X [实现期内强制]
        TDD[skill: TDD<br/>新功能/bugfix 写实现前]
        VBA[verify-before-assert<br/>grep 实证基线]
        SIT_DEV[skill: agf-running-sit-tests<br/>dev 自跑 SIT<br/>Unit 完成后、code-review 前]
        VBC[skill: verification-before-completion<br/>报完成前]
        PROG[(progress/role.md<br/>含 SIT 证据段<br/>hook: check-progress-file)]
    end

    DONE[💬 SendMessage to PL<br/>+ AC 自验摘要]

    subgraph S4 [📍 阶段 4: 评审 + 两级测试阶段门]
        CR{🟡 code-reviewer<br/>含 SIT Audit<br/>→ docs/reviews/<br/>verdict 三档}
        E2E{🔴 qa-engineer E2E<br/>chrome-devtools-mcp}
        UAT[(🔴 UAT 报告<br/>docs/qa/feature-uat.md)]
        PLSIGN[🟠 PL 业务签字<br/>对照 PRD AC 逐条]
    end

    subgraph S5 [📍 阶段 5: 收尾归档 + 交付]
        FIN[skill: finishing-a-development-branch]
        ARCH[bash archive-progress.sh<br/>progress/ → docs/qa/]
        DELIVER([🎁 交付用户])
    end

    subgraph S6 [📍 阶段 6: 上线后产物链 — 可选]
        CW[🟪 content-writer<br/>release notes 24h 内]
        GA[🟫 growth-analyst<br/>A/B 实验 7-14d<br/>埋点字段经 PL 中转回 backend-dev]
    end

    USER --> SE
    SE -->|"模糊/多选项"| BS
    SE -->|"明确需求"| PRD
    BS --> PRD
    PRD --> WP
    WP --> TC
    TC --> PD
    PD -->|是| WT
    PD -->|否| S3
    WT --> S3
    TL -.->|架构咨询| S3
    S3 --> S3X
    S3X --> PROG
    PROG --> DONE
    DONE --> CR
    CR -->|"approve / approve with changes (含 SIT Audit ✅/⚠️)"| E2E
    E2E -->|pass| UAT
    UAT --> PLSIGN
    PLSIGN -->|approve| FIN
    FIN --> ARCH
    ARCH --> DELIVER
    DELIVER -.->|可选触发| CW
    DELIVER -.->|可选触发| GA

    CR -.->|"request changes / Redo SIT"| S3
    E2E -.->|fail| S3
    PLSIGN -.->|"fail / request changes"| S3

    style USER fill:#3b82f6,color:#fff
    style PRD fill:#fef3c7,stroke:#f59e0b
    style UAT fill:#fef3c7,stroke:#f59e0b
    style PROG fill:#fef3c7,stroke:#f59e0b
    style SIT_DEV fill:#fef3c7,stroke:#f59e0b
    style PLSIGN fill:#f97316,color:#fff
    style DELIVER fill:#22c55e,color:#fff
    style TL fill:#3b82f6,color:#fff
```

**视觉约定**：

- 圆角胶囊 `([...])` = 起点/终点；矩形 `[...]` = 阶段动作；圆柱 `[(...)]` = 持久工件
- 菱形 `{...}` = 决策点 / 阶段门
- 实线 = happy path；虚线 = 失败回路 / 可选触发
- `subgraph` 框 = 阶段分组（S1..S6）；橙色高亮 = product-lead 关键签字点

### 1.2 阶段 × Hook 触发点

| 触发时机 | Hook | 行为 | 阻断/告警 |
|---|---|---|---|
| 任何 Bash 调用 | `block-dangerous-bash` | 拦截 `rm -rf` / `DROP TABLE` / `git push --force` / `git reset --hard` | 🛑 硬阻断 |
| 用户 prompt 提交 | `scan-secrets` | 扫 10+ 厂商密钥 + PEM/SSH/PuTTY/BIP39 | 🛑 硬阻断 |
| WebFetch/WebSearch/Read/Bash 输出 | `sanitize-tool-output` | 检测外部内容里的 prompt-injection 指令 | ⚠️ 软告警 |
| `git commit`（pre-commit） | `scan-commit` | 对 staged diff 跑同套 secret 正则 | 🛑 硬阻断 |
| `TaskCreate` 时 | `validate-task-schema` | 6 段 schema 缺段（任务描述/类型/上下文/上游产物/AC/预期产物） | 🛑 硬阻断 |
| `SubagentStop` / `TeammateIdle`（执行层） | `check-progress-file` | `progress/<role>.md` 不存在或无条目 | 🛑 硬阻断 |
| `TeammateIdle` | `teammate-keepalive` | task list 还有 pending 时 idle | 🛑 阻止 idle |
| `PreToolUse`（任意工具） | `skill-suggester` | 按 `skill-rules.json` 软建议匹配的 skill | ⚠️ 提示 |

### 1.3 阶段 × Skill 强制调用

| 阶段 | 谁调 | Skill | 跳过条件 |
|---|---|---|---|
| 接到模糊/多选项需求 | product-lead | `superpowers:brainstorming` | 用户已给明确 PRD / 单点 bugfix |
| 写 PRD | product-lead | `agf-writing-prd` | — |
| 实施计划（≥3 AC / 跨角色） | product-lead | `superpowers:writing-plans` | 单角色 / 单 AC |
| 并行派 ≥2 execution teammate | product-lead | `superpowers:using-git-worktrees` | 单实例派发、纯只读 reviewer 并行 |
| 写 ADR | tech-lead | `agf-writing-adr` | — |
| 接入 LLM SDK | ai-agent-dev / backend-dev / ml-engineer | `agf-wiring-multi-llm-sdk` | — |
| 实现新功能 / bugfix 前 | 执行层 5 个角色 | `superpowers:test-driven-development` | 重构 / 文档 / 配置类任务 |
| 遇 bug / 测试失败 | 执行层 + qa | `superpowers:systematic-debugging` | 新功能正常流程 |
| 报完成前 | 执行层 + qa | `superpowers:verification-before-completion` | 中间汇报（progress 阻塞条目除外） |
| 触发 code-reviewer 前 | product-lead | `superpowers:requesting-code-review` | 文档类任务 |
| 跑 SIT（Unit 完成后、code-review 前） | 5 个执行层 dev（frontend-dev / backend-dev / ai-agent-dev / ml-engineer / miniapp-dev） | `agf-running-sit-tests` | 文档类 / 配置类任务（无集成层覆盖） |
| 写 E2E / UAT 报告 | qa-engineer / miniapp-qa-engineer | `agf-writing-qa-report` | — |
| code review 时 audit SIT 证据 | code-reviewer / miniapp-code-reviewer | 按 [`code-reviewer.md` `## SIT Audit` 节](../.claude/agents/code-reviewer.md)（4 项检查 + 3 档 verdict） | — |
| 收审查 / UAT 打回 | product-lead / 执行层 | `superpowers:receiving-code-review` | — |
| UAT 签字 + 归档 progress 后整合 | product-lead | `superpowers:finishing-a-development-branch` | 模板 internal commit |

### 1.4 小程序变体（替换主链路部分角色）

主图阶段 S3-S4 在小程序场景下做以下替换，其余阶段不变：

| 主链路角色 | 小程序变体 | 关键差异 |
|---|---|---|
| `uiux-designer`（默认 Web 模式） | `uiux-designer`（**MiniApp Mode**） | 产出 WeUI 规范 + 小程序原型，路径 `docs/design/[feature]-miniapp/` |
| `frontend-dev` | `miniapp-dev` | 默认原生 WXML/WXSS/JS，Taro 仅在 3 类触发场景使用 |
| `code-reviewer` | `miniapp-code-reviewer` | 审 `wx.*` API + 包体积 + 审核红线 + 隐私协议 |
| `qa-engineer` | `miniapp-qa-engineer` | 体验版二维码（E2E）+ 真机扫码（UAT）；SIT 由 `miniapp-dev` 在 DevTools 模拟器自跑 |

`backend-dev` / `ai-agent-dev` / `ml-engineer` / `product-lead` / `tech-lead` / `content-writer` / `growth-analyst` 不变（API 层和上线后产物两端共用）。详见 [`.claude/standards/miniapp.md`](../.claude/standards/miniapp.md)。

### 1.5 失败回路汇总

| 阶段门 | 失败动作 | 回到哪里 |
|---|---|---|
| code review verdict = `request changes` | PL 重派执行层修复 | S3 实现 |
| SIT Audit verdict = `❌ Redo SIT`（reviewer 在 code review 内同步出） | PL 重派执行层补 SIT（与 code 修复一并） | S3 实现（不进 E2E） |
| E2E fail | qa 出报告 → PL 重派执行层 | S3 实现（不进 UAT） |
| UAT 业务签字 = `request changes` | PL 重派执行层 | S3 实现 |

任一阶段失败 → **不跳级**，回到 S3 重做 → 重走完整后续阶段门。**code-reviewer / qa-engineer 永远不直接修源码**。

### 1.6 Scrum 词汇 ↔ 本项目载体（feature 流变体）

> 详细决策与替代理由见 [`docs/product-workflow.md §4.4`](./product-workflow.md#44-agile--scrum-心法采用清单--词汇替代)。本表是"运行时载体"速查：每个 Scrum 概念在本项目对应哪个文件 / 工件 / 仪式。

| Scrum 概念 | 本项目载体 | 关键约束 |
|---|---|---|
| **Sprint**（1-4 周定时迭代） | 一个 feature 的 PRD → UAT 签字闭环 | 无定时窗，由 effort tier (Small/Medium/Large) 估边界；连续异步 |
| **Product Backlog** | `docs/prd/` 目录里 Status=Draft/Review 的 PRD 文件 | git-trackable；Status 字段维护优先级队列 |
| **Sprint Backlog** | `~/.claude/tasks/<team>/*.json`（Agent Teams runtime task list） | 由 product-lead 通过 `TaskCreate` / `TaskUpdate` 维护；`/agf-tasks` 查看 |
| **Increment** | UAT 通过 + product-lead 业务签字 + 归档 `progress/*.md` → `docs/qa/<feature>-process-log.md` | 见 [`product-lead.md` Step 5](../.claude/agents/product-lead.md) |
| **Product Owner** | `product-lead`（PO 职责：PRD / 优先级 / UAT 签字） | 见 [`product-lead.md`](../.claude/agents/product-lead.md) |
| **Scrum Master** | `product-lead`（合并 SM 职责：流程编排 / skill 调用 enforce / hook 兜底监督 / retro 主持） | agent 无人类利益冲突，PO+SM 合并合理 |
| **Development Team** | 执行层 5 dev（frontend / backend / ai-agent / ml / miniapp）+ 1 designer + 2 reviewer + 2 qa | cross-functional；dev 自跑 Unit + SIT |
| **Daily Standup** | `progress/<role>.md` 持久化条目 + SendMessage 完成报告 | async；`check-progress-file.sh` hook 兜底 |
| **Sprint Planning** | `superpowers:brainstorming` → `superpowers:writing-plans`（异步串行） | PL Step 0 强制；plans 格式见 [`plans-format.md`](../.claude/standards/plans-format.md) |
| **Sprint Review** | UAT 签字仪式（业务方对照 PRD AC 逐条接受）+ MAJOR/MINOR `/agf-release-retro` 中的 §1 进度回顾 | qa-engineer 出报告 + product-lead 签字 |
| **Sprint Retrospective** | `/agf-release-retro vX.Y.Z`（MAJOR/MINOR 强制，PATCH 跳过）→ `docs/reviews/retro-vX.Y.Z-YYYY-MM-DD.md` | 7 步 skill + §5 Action Items Owner+Due 强制 + §0 上一轮闭环 |
| **Definition of Done** | [`ac-lifecycle.md`](../.claude/standards/ac-lifecycle.md) 9 项 DoD（含 TDD red-green-refactor 顺序 + Unit + SIT + AC 自验 + progress 落档） | `check-progress-file.sh` hook + `code-reviewer` SIT Audit 双兜底 |
| **Definition of Ready** | `superpowers:brainstorming` 完成 + AC ≤30s 可验证 + Open Questions 有 Owner | product-lead 铁律 1+2 |
| **Acceptance Criteria** | PRD §4 AC 表（P0/P1 优先级，AC 必须可独立验证） | 任务派单必须摘录 AC 原文（`validate-task-schema.sh` hook 兜底）|
| **Refinement / Grooming** | `superpowers:brainstorming` + `writing-plans` 串行调用（异步精炼，不需会议） | 见 [`superpowers.md`](../.claude/standards/superpowers.md) |
| **Story Points / Velocity** | `Estimated effort tier: Small/Medium/Large`（绑 [`cost-budget.md`](../.claude/standards/cost-budget.md) token 档位）；Velocity 不统计，用 release retro AI 闭环替代 | 见 [`product-workflow.md §4.4`](./product-workflow.md#44-agile--scrum-心法采用清单--词汇替代) |

> 注：本表对应 Scrum 词汇但不重写 Scrum——**模板默认不采用 Scrum 全套词汇**，仅保证心法落地。具体项目可在自己的 `docs/glossary.md` 借用 Sprint / Backlog 等术语，与本表不冲突。

---

## 2. 角色协作消息流

```mermaid
flowchart TD
    USER(["👤 用户"])
    PL["🟠 product-lead\nopus · orange\n需求 / 分配 / 验收"]
    TL["🔵 tech-lead\nopus · blue\n架构 / 技术顾问（条件触发）"]
    UX["🟣 uiux-designer\nsonnet · purple\nWeb + MiniApp 设计 / 交互"]
    FE["🩵 frontend-dev\nsonnet · cyan\nUI 组件 / 页面"]
    BE["🟢 backend-dev\nsonnet · green\nAPI / 数据库"]
    AI["🩷 ai-agent-dev\nopus · pink\nLLM / RAG / Agent"]
    CR["🟡 code-reviewer\nsonnet · yellow\n代码质量 / 安全"]
    QA["🔴 qa-engineer\nsonnet · red\nE2E / UAT 执行 + 报告"]
    ML["🟩 ml-engineer\nsonnet · lime\n多模态 / 推理服务 / 文生图·文生视频"]
    MD["🟦 miniapp-dev\nsonnet · teal\n小程序开发 / 原生 / Taro"]
    MCR["🟧 miniapp-code-reviewer\nsonnet · amber\n小程序审查 / 审核合规"]
    MQA["🌷 miniapp-qa-engineer\nsonnet · rose\n小程序 E2E / UAT"]
    CW["🟪 content-writer\nsonnet · violet\nrelease notes / blog / 案例"]
    GA["🟫 growth-analyst\nsonnet · indigo\n指标 / A/B 实验 / 漏斗"]

    USER -->|"用户需求"| PL
    PL -.->|"技术可行性咨询"| TL
    TL -.->|"方案 / 风险 / 工作量"| PL
    PL -->|"设计任务 + 用户旅程"| UX
    PL -->|"工程任务 + 验收标准"| FE
    PL -->|"工程任务 + 验收标准"| BE
    PL -->|"工程任务 + 验收标准"| AI
    PL -->|"工程任务 + 验收标准"| ML
    ML -->|"推理 API 需求"| BE
    ML -->|"完成报告"| PL
    UX -->|"设计标注"| FE
    FE <-->|"API 契约"| BE
    AI -->|"AI API 需求"| BE
    FE -->|"完成报告"| PL
    BE -->|"完成报告"| PL
    AI -->|"完成报告"| PL
    UX -->|"完成报告"| PL
    PL -->|"审查请求"| CR
    CR -->|"审查结果"| PL
    CR -.->|"架构问题"| TL
    CR -.->|"架构风险通知"| PL
    PL -->|"E2E / UAT 任务"| QA
    QA -->|"测试报告"| PL
    PL -->|"小程序工程任务"| MD
    PL -->|"小程序审查请求"| MCR
    PL -->|"小程序 E2E / UAT"| MQA
    UX -->|"miniapp 设计交付 (MiniApp Mode)"| MD
    MD -->|"API 契约"| BE
    MD -->|"完成报告"| PL
    MCR -->|"审查结果"| PL
    MCR -.->|"架构问题"| TL
    MD -.->|"架构咨询"| TL
    MQA -->|"测试报告"| PL
    PL -->|"内容任务 (UAT 后)"| CW
    CW -->|"草稿 / release notes"| PL
    PL -->|"指标 / 实验任务"| GA
    GA -->|"实验报告 / 建议"| PL
    GA <-.->|"埋点字段对齐"| BE
    PL -->|"交付结果"| USER

    style PL fill:#f97316,color:#fff
    style TL fill:#3b82f6,color:#fff
    style UX fill:#a855f7,color:#fff
    style FE fill:#06b6d4,color:#fff
    style BE fill:#22c55e,color:#fff
    style AI fill:#ec4899,color:#fff
    style CR fill:#eab308,color:#fff
    style QA fill:#ef4444,color:#fff
    style ML fill:#84cc16,color:#fff
    style MD fill:#14b8a6,color:#fff
    style MCR fill:#f59e0b,color:#fff
    style MQA fill:#f43f5e,color:#fff
    style CW fill:#a78bfa,color:#fff
    style GA fill:#6366f1,color:#fff
```

---

## 3. 通信关系网络

```mermaid
graph LR
    PL["product-lead 🟠"]
    TL["tech-lead 🔵"]
    UX["uiux-designer 🟣"]
    FE["frontend-dev 🩵"]
    BE["backend-dev 🟢"]
    AI["ai-agent-dev 🩷"]
    CR["code-reviewer 🟡"]
    QA["qa-engineer 🔴"]
    ML["ml-engineer 🟩"]
    MD["miniapp-dev 🟦"]
    MCR["miniapp-code-reviewer 🟧"]
    MQA["miniapp-qa-engineer 🌷"]
    CW["content-writer 🟪"]
    GA["growth-analyst 🟫"]

    PL -.->|"技术咨询"| TL
    TL -.->|"技术方案/风险"| PL
    PL -->|"设计任务"| UX
    PL -->|"前端任务"| FE
    PL -->|"后端任务"| BE
    PL -->|"AI任务"| AI
    PL -->|"ML任务"| ML
    PL -->|"审查请求"| CR
    PL -->|"E2E / UAT 任务"| QA
    UX -->|"设计标注"| FE
    UX -.->|"设计规范路径"| QA
    UX -->|"完成报告"| PL
    FE -->|"API契约"| BE
    BE -->|"API契约"| FE
    AI -->|"AI API需求"| BE
    ML -->|"推理 API需求"| BE
    FE -->|"完成报告"| PL
    BE -->|"完成报告"| PL
    AI -->|"完成报告"| PL
    ML -->|"完成报告"| PL
    CR -->|"审查结果"| PL
    CR -.->|"架构问题"| TL
    CR -.->|"架构风险通知"| PL
    QA -->|"测试报告"| PL
    FE -.->|"技术求助"| TL
    BE -.->|"技术求助"| TL
    AI -.->|"架构审查"| TL
    ML -.->|"推理选型咨询"| TL
    PL -->|"小程序开发"| MD
    PL -->|"小程序审查"| MCR
    PL -->|"小程序 E2E / UAT"| MQA
    UX -->|"miniapp 设计 (MiniApp Mode)"| MD
    MD -->|"API契约"| BE
    MD -->|"完成报告"| PL
    MCR -->|"审查结果"| PL
    MQA -->|"测试报告"| PL
    MD -.->|"架构咨询"| TL
    MCR -.->|"架构问题"| TL
    PL -->|"内容任务"| CW
    CW -->|"草稿"| PL
    PL -->|"指标 / 实验"| GA
    GA -->|"报告 / 建议"| PL
    GA -.->|"埋点字段"| BE
    BE -.->|"事件 schema"| GA

    style PL fill:#f97316,color:#fff
    style TL fill:#3b82f6,color:#fff
    style UX fill:#a855f7,color:#fff
    style FE fill:#06b6d4,color:#fff
    style BE fill:#22c55e,color:#fff
    style AI fill:#ec4899,color:#fff
    style CR fill:#eab308,color:#fff
    style QA fill:#ef4444,color:#fff
    style ML fill:#84cc16,color:#fff
    style MD fill:#14b8a6,color:#fff
    style MCR fill:#f59e0b,color:#fff
    style MQA fill:#f43f5e,color:#fff
    style CW fill:#a78bfa,color:#fff
    style GA fill:#6366f1,color:#fff
```

> 实线 = 主链路；虚线 = 按需咨询

---

> 本文档用于帮助理解团队角色分工、协作关系和模板声明的能力边界。
> 实际运行时可用的 permission mode、tools、skills 与外部能力，以 `.claude/standards/team-roles.md`、各 agent frontmatter 和当前运行环境为准。

## 4. 角色能力对比

| 能力维度 | product-lead | tech-lead | uiux-designer | frontend-dev | backend-dev | ai-agent-dev | code-reviewer | qa-engineer | ml-engineer |
|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| **Model** | opus | opus | sonnet | sonnet | sonnet | opus | sonnet | sonnet | sonnet |
| **Color** | 🟠 orange | 🔵 blue | 🟣 purple | 🩵 cyan | 🟢 green | 🩷 pink | 🟡 yellow | 🔴 red | 🟩 lime |
| **Permission** | acceptEdits | acceptEdits | acceptEdits | acceptEdits | acceptEdits | acceptEdits | auto（review-only，Write 仅限 docs/reviews/） | acceptEdits | acceptEdits |
| **可写文件** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅（仅 docs/reviews/） | ✅ | ✅ |
| **WebSearch** | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ✅ |
| **WebFetch** | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ✅ |
| **TaskCreate** | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
| **TeamCreate** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **SendMessage** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

### MiniApp 角色能力（独立子表）

> 微信小程序设计由 `uiux-designer` 在 MiniApp Mode 下完成（见 `agents/uiux-designer.md` 末尾节），故不重复列入子表。下表只列 3 个 miniapp 专项角色。

| 能力维度 | miniapp-dev | miniapp-code-reviewer | miniapp-qa-engineer |
|---|:---:|:---:|:---:|
| **Model** | sonnet | haiku（cost-budget.md 路由）| sonnet |
| **Color** | 🟦 teal | 🟧 amber | 🌷 rose |
| **Permission** | acceptEdits | auto（review-only，Write 仅限 docs/reviews/） | acceptEdits |
| **可写文件** | ✅ | ✅（仅 docs/reviews/） | ✅ |
| **WebSearch** | ❌ | ❌ | ❌ |
| **WebFetch** | ✅ | ❌ | ❌ |
| **TaskCreate** | ❌ | ❌ | ❌ |
| **TeamCreate** | ❌ | ❌ | ❌ |
| **SendMessage** | ✅ | ✅ | ✅ |

### Post-Launch 角色能力（独立子表）

> Feature 上线后才介入的两位：内容产出与数据分析。不直接参与代码交付链路。

| 能力维度 | content-writer | growth-analyst |
|---|:---:|:---:|
| **Model** | sonnet | sonnet |
| **Color** | 🟪 violet | 🟫 indigo |
| **Permission** | acceptEdits | acceptEdits |
| **可写文件** | ✅（默认 `docs/content/`） | ✅（默认 `docs/growth/`） |
| **WebSearch** | ✅ | ✅ |
| **WebFetch** | ✅ | ✅ |
| **TaskCreate** | ❌ | ❌ |
| **TeamCreate** | ❌ | ❌ |
| **SendMessage** | ✅ | ✅ |

---

## 5. 能力来源说明

| 类别 | 是否属于团队基线 | 权威来源 | 说明 |
|---|---|---|---|
| Claude Code 内置工具 | 是 | `.claude/standards/team-roles.md` | 例如 `Read`、`WebFetch`、`WebSearch`、`SendMessage`、`Task*`；具体到各角色能否使用，以 `team-roles.md` 和 agent frontmatter 为准 |
| Plugin Skills | 是 | `.claude/standards/team-roles.md` + 各 agent frontmatter | 例如 `frontend-design`、`feature-dev`、`code-review`、`chrome-devtools-mcp`、`superpowers`；是否预加载、归属哪些角色，以权威来源为准 |
| 第三方 MCP / 外部集成 | 否 | 当前运行环境 | 不属于团队模板基线。若运行环境已连接 Figma、MiniMax 等外部能力，可按当前 session 实际可用工具使用，但不能视为模板固有能力 |

---

## 6. Plugin Skills 归属

| Plugin | 调用方式 | 归属角色 | 使用场景 |
|---|---|---|---|
| frontend-design | `/frontend-design:*` | uiux-designer, frontend-dev | 组件设计规范、可访问性建议（uiux-designer 同时支持 MiniApp Mode） |
| feature-dev | `/feature-dev:feature-dev` | frontend-dev, backend-dev, ai-agent-dev, miniapp-dev | 快速搭建功能骨架 |
| code-review | `/code-review:*` | code-reviewer, miniapp-code-reviewer | 结构化审查框架 |
| code-simplifier | `/code-simplifier:*` | code-reviewer, backend-dev, miniapp-code-reviewer | 复杂度评估、简洁性建议 |
| chrome-devtools-mcp | `/chrome-devtools-mcp:*` | qa-engineer | E2E 浏览器测试（需连接） |
| superpowers | `/superpowers:*` | product-lead, tech-lead, frontend-dev, backend-dev, ai-agent-dev, qa-engineer, ml-engineer, miniapp-dev, miniapp-qa-engineer, content-writer, growth-analyst | 需求澄清、实现前检查、系统化调试、完成前验证、审查闭环 |

### 项目自有 Skills 归属

> 路径：`.claude/skills/<name>/SKILL.md`；通过 agent frontmatter `skills:` 在角色启动时预加载。

| Skill | 归属角色 | 使用场景 |
|---|---|---|
| agf-wiring-multi-llm-sdk | ai-agent-dev, backend-dev, ml-engineer | DeepSeek/Doubao/Qwen/MiniMax 多厂商接入、OpenAI 兼容适配、fallback 与成本守护 |
| agf-running-sit-tests | frontend-dev, backend-dev, ai-agent-dev, ml-engineer, miniapp-dev（5 dev 自跑 SIT）；reviewer 角色 audit 时参考 | SIT 范围、环境准备、AC 驱动的集成 walk、证据落 `progress/<role>.md` |
| agf-writing-qa-report | qa-engineer, miniapp-qa-engineer | 写 E2E / UAT 报告时的骨架 + 证据质量条 + verdict 标准（SIT 不在覆盖范围） |
| agf-writing-prd | product-lead | PRD 10-section 结构 + AC 质量条 + 完成前自检 |
| agf-writing-adr | tech-lead | ADR 结构 + 强制备选 + 版本查证 |
| agf-running-release-retro | product-lead | MAJOR / MINOR 释出后的发布复盘（PATCH 跳过） |

**外部集成说明**：当前团队模板不将任何第三方 MCP 视为能力基线；若运行环境已连接 Figma、MiniMax 等外部能力，以当前 session 实际可用工具为准。

---

## 7. 核心职责速查

> **"主要输出"列是标签视图，仅供速览**。每个角色完整的产出契约（path / template / must）唯一来源是各 agent 文件的 `## Output Conventions` 节——`product-lead` 派单时填的"预期产物"字段必须对照该节，hook `validate-task-schema.sh` 强制 6 段 schema。

| 角色 | 三个关键词 | 主要输出 |
|---|---|---|
| **product-lead** | 需求挖掘 · 流程编排 · 验收交付 | PRD、任务单、交付报告 |
| **tech-lead** | 架构基线 · 技术选型 · 架构风险评审（条件触发） | 技术方案、ADR、风险预警 |
| **uiux-designer** | Web + MiniApp 设计 · 交互流程 · 静态 HTML 原型 | Web 设计规范 + 原型；MiniApp Mode 下产出 WeUI 规范 + 小程序原型 |
| **frontend-dev** | UI 组件 · 页面实现 · API 对接 | React/Vue 组件、页面、状态管理；Unit + SIT 自跑（`frontend/tests/sit/*`，证据进 `progress/<role>.md`） |
| **backend-dev** | REST API · 数据库 · 业务逻辑 | API 端点、数据库迁移、中间件；Unit + SIT 自跑（`backend/tests/sit/*`，证据进 `progress/<role>.md`） |
| **ai-agent-dev** | LLM 集成 · Prompt 工程 · RAG | Agent 工作流、Prompt、RAG 管道；Unit + SIT 自跑（含 prompt + RAG 集成层证据进 `progress/<role>.md`） |
| **code-reviewer** | 代码质量 · 安全审计 · SIT Audit | 审查报告（critical/warning/suggestion）+ `## SIT Audit` 节（✅ Pass / ⚠️ Pass with concerns / ❌ Redo SIT） |
| **qa-engineer** | E2E + UAT 执行 · 质量保障 | E2E / UAT 测试用例与报告、验证证据（SIT 由 dev 自跑、reviewer audit，不在 qa 范围） |
| **ml-engineer** | 模型集成 · 推理服务 · 多模态 Pipeline | 推理 API 封装、文生图/文生视频管道、模型评估报告；Unit + SIT 自跑（推理链路集成证据进 `progress/<role>.md`） |
| **miniapp-dev** | 小程序开发 · 原生 · Taro 兜底 | 微信小程序页面/组件、wx.* API 集成、组件单测；Unit + SIT 自跑（DevTools 模拟器 + 集成证据进 `progress/<role>.md`） |
| **miniapp-code-reviewer** | 代码审查 · 审核合规 · 包体积 · SIT Audit | 审查报告（critical/important/minor）+ 审核红线检查表 + `## SIT Audit` 节 |
| **miniapp-qa-engineer** | 真机 E2E / UAT · 审核前置检查 | E2E / UAT 测试报告、审核合规结论（SIT 由 miniapp-dev 自跑、reviewer audit） |
| **content-writer** | release notes · blog · 用户案例 | `docs/content/release-notes/*` + `docs/content/blog/*` + 案例研究 |
| **growth-analyst** | 北极星指标 · A/B 实验 · 漏斗分析 | `docs/growth/experiments/*`（实验设计 + 报告）+ 指标定义 |
