# App Genesis Forge · AI 虚拟员工们

> **Code the Origin, Forge the App.**
> 14 个 AI 同事 · Agile + Scrum + TDD 骨架 · 一晚上交付一个 feature · 一个浏览器 tab 看完全程。

[![GitHub Template](https://img.shields.io/badge/GitHub-Template-2ea44f?logo=github)](https://github.com/pcliangx/AppGenesisForge/generate)
[![Release](https://img.shields.io/github/v/release/pcliangx/AppGenesisForge)](https://github.com/pcliangx/AppGenesisForge/releases)
[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-%E2%89%A5%20v2.1.130-orange?logo=anthropic)](https://claude.com/claude-code)
[![Methodology](https://img.shields.io/badge/methodology-Agile%20Scrum%20%2B%20TDD-9b59b6)](#-核心思想agile--scrum--tdd不可妥协)
[![Agents](https://img.shields.io/badge/agents-14-9b59b6?logo=robotframework&logoColor=white)](.claude/agents/)
[![Commands](https://img.shields.io/badge/commands-4-3498db)](.claude/commands/)
[![Skills](https://img.shields.io/badge/skills-6-1abc9c)](.claude/skills/)
[![LLM](https://img.shields.io/badge/LLM-DeepSeek%20%7C%20Doubao%20%7C%20Qwen%20%7C%20MiniMax-ff6b6b)](.claude/skills/agf-wiring-multi-llm-sdk/)
[![WeChat](https://img.shields.io/badge/WeChat-MiniProgram-07c160?logo=wechat&logoColor=white)](.claude/standards/miniapp.md)
[![Hooks](https://img.shields.io/badge/hooks-4%20layers-2c3e50?logo=shieldsdotio&logoColor=white)](.claude/standards/security.md)
[![Stars](https://img.shields.io/github/stars/pcliangx/AppGenesisForge?style=social)](https://github.com/pcliangx/AppGenesisForge/stargazers)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/pcliangx/AppGenesisForge/pulls)

**简体中文** · [English](README.en.md) · [日本語](README.ja.md)

> 📖 **阅读路径（总-分-总）**：
> - **总（结论 + 心法）** ── [💡 结论](#-是什么结论先行) → [🧠 核心思想](#-核心思想agile--scrum--tdd不可妥协)
> - **分（3 支柱 + 上手）** ── [🏢 组织](#-组织--who) → [🔄 流程](#-流程--how) → [⚙️ 机制](#-机制--enforcement) → [⏱ 入门](#-入职第一天--day-1) → [🛠️ 工具](#-自助服务台)
> - **总（收尾）** ── [🔍 对比](#-对比同类项目) → [✨ 总结](#-总结)

---

## 💡 是什么（结论先行）

**AppGenesisForge** 是基于 [Claude Code Agent Teams](https://code.claude.com/docs/en/agent-teams) 构建的 **AI 团队脚手架**——不是 prompt 收藏，不是角色人格库，而是一支**以 Agile + Scrum + TDD 为骨架、带流程、带规范、带验收闭环的 AI 虚拟团队**。

### 核心结论（一句话）

> **把 Agile + Scrum + TDD 心法嵌进 skill / hook / DoD 三层 enforcement 路径，不靠 agent 自觉。**

### 5 个事实

- **🧠 方法论骨架不可妥协** —— Agile + Scrum + TDD（[见 §核心思想](#-核心思想agile--scrum--tdd不可妥协)）
- **🏢 组织清晰** —— 14 位 AI 同事职责契约（[见 §组织](#-组织--who)）
- **🔄 流程闭环** —— PRD → UAT 6 阶段门，失败不跳级（[见 §流程](#-流程--how)）
- **⚙️ 机制兜底** —— skill 强制 / hook 阻断 / DoD checklist 三层（[见 §机制](#-机制--enforcement)）
- **🇨🇳 国产生态** —— DeepSeek / Doubao / Qwen / MiniMax + 微信小程序（[见 §工具](#-自助服务台)）

### 适用边界

✅ **适合**：React + FastAPI + Postgres · AI Agent / RAG / 多模态 · 微信小程序（原生 + Taro 兜底）· 完整 PRD → UAT 闭环

❌ **不适合**：iOS / Android 原生 · 桌面 GUI · 大模型训练

> 📝 **当前后端默认 Python（FastAPI + SQLAlchemy + Alembic）**，前端默认 React + Vite。**可扩展到 Java / Go / Rust** 等其他后端栈——OpenAI 兼容 LLM 接入 / Agile + Scrum + TDD 心法 / 4 层 hook 防御 / 14 同事职责契约都不挑语言，需 `tech-lead` 重写 [`ADR-000`](.claude/skills/agf-writing-adr/SKILL.md) + 替换 [`backend-dev`](.claude/agents/backend-dev.md) / [`testing.md`](.claude/standards/testing.md) / `agf-wiring-multi-llm-sdk` 中的 Python 代码范例。

---

## 🧠 核心思想：Agile + Scrum + TDD（不可妥协）

AI agent 协作有两个天然短板：**上下文易丢失 + 过度自信**。Scrum 阶段门 + Agile 迭代反馈 + TDD 先红后绿，是用纪律对抗这两点的成熟解法。本项目把纪律**通过组织 + 流程 + 机制三层落地**——本节先讲心法 WHAT/WHY，后三节讲三层 HOW。

完整决策见 [`product-workflow.md §4.4`](./docs/product-workflow.md#44-agile--scrum-心法采用清单--词汇替代) + [`team-capability-map.md §1.6`](./docs/team-capability-map.md#16-scrum-词汇--本项目载体feature-流变体)。

### 心法清单（全部强制 / 三层落地）

| 心法 / Scrum 概念 | 本项目载体 | 落点 |
|---|---|---|
| **TDD red-green-refactor** | `superpowers:test-driven-development` + DoD red→green→refactor 顺序 | ⚙️ 机制 |
| **AC (Acceptance Criteria)** | PRD §4 表（P0/P1）+ 派单摘录 AC 原文 | 🔄 流程 + ⚙️ 机制 |
| **DoD (Definition of Done)** | [`ac-lifecycle.md`](.claude/standards/ac-lifecycle.md) 9 项 checklist | ⚙️ 机制 |
| **DoR (Definition of Ready)** | `brainstorming` 完成 + AC ≤30s 可验证 + Open Q 有 Owner | 🔄 流程 |
| **User Story (INVEST)** | PRD §3 表 + US↔AC ID 双向引用 | 🔄 流程 |
| **Product Owner + Scrum Master** | `product-lead`（合并 PO+SM）| 🏢 组织 |
| **Dev Team (cross-functional)** | 5 dev + 1 Designer + 2 Reviewer + 2 QA + 2 Post-launch = 12 + PL/TL = 14 | 🏢 组织 |
| **Sprint** | 一个 feature = PRD → UAT 签字闭环 | 🔄 流程 |
| **Sprint Planning** | `superpowers:writing-plans`（异步）| 🔄 流程 |
| **Daily Standup** | `progress/<role>.md` + SendMessage（async）| ⚙️ 机制 |
| **Sprint Review** | UAT 业务签字 | 🔄 流程 |
| **Sprint Retrospective** | `/agf-release-retro vX.Y.Z`（MAJOR/MINOR 强制）| 🔄 流程 |

### Scrum 词 → 项目载体（替代映射）

| Scrum 词汇 | 本项目替代 | 理由 |
|---|---|---|
| **Sprint**（定时迭代）| Feature 流 | Agent Team 连续异步，无 sync 节奏 |
| **Product Backlog** | `docs/prd/` 里 Status=Draft/Review 的 PRD | 文件化、git-trackable |
| **Sprint Backlog** | `~/.claude/tasks/<team>/*.json` | PL 用 `TaskCreate/Update` 维护，`/agf-tasks` 查看 |
| **Story Points** | PRD `Estimated effort tier: S/M/L` | 绑 token 预算档位，比抽象 points 更精确 |
| **Velocity / Burndown** | 不统计 | 无定时迭代 → velocity 无意义；≥3 retro 后强制评估 cycle time 趋势 |
| **Daily Standup** | `progress/<role>.md` + SendMessage | async standup + hook 兜底 |

---

## 🏢 组织 / WHO

> Agile/Scrum 三角色映射 + 14 位 AI 同事职责。**自管理、cross-functional**——dev 自跑 Unit + SIT，Reviewer 不动源码，QA 不签业务字。

### Scrum 三角色映射

| Scrum 角色 | 本项目载体 | 备注 |
|---|---|---|
| **Product Owner** | [`product-lead`](.claude/agents/product-lead.md) | PRD / 优先级 P0/P1 / UAT 业务签字 |
| **Scrum Master** | `product-lead`（合并 PO+SM）| 流程编排 / skill 调用 enforce / retro 主持。agent 无人类利益冲突，合并合理 |
| **Development Team** | 12 个执行/评审/QA/Post-launch 角色（见下表）| 自管理；dev 自跑 Unit + SIT |
| **技术顾问**（非 Scrum 角色）| [`tech-lead`](.claude/agents/tech-lead.md) | 仅缺基线 / 新选型 / 架构风险升级时介入 |

### 14 位 AI 同事一览

| # | Agent | 性格 + 职责 |
|---|---|---|
| 🟠 001 | [`product-lead`](.claude/agents/product-lead.md) | **PO + SM** — 不写代码只签字。PRD / 派任务 / UAT 签字 / retro 主持 |
| 🔵 002 | [`tech-lead`](.claude/agents/tech-lead.md) | 技术老兵 — 没备选方案的 ADR 等于没决策。仅缺基线/新选型/架构风险时介入 |
| 🟢 003 | [`frontend-dev`](.claude/agents/frontend-dev.md) | 组件即契约 — React+Vite + Unit + SIT 自跑 |
| 🟢 004 | [`backend-dev`](.claude/agents/backend-dev.md) | schema 迁移有 PTSD — FastAPI / SQLAlchemy + Unit + SIT 自跑 |
| 🟢 005 | [`ai-agent-dev`](.claude/agents/ai-agent-dev.md) | Prompts 是代码 — LLM / RAG / Agent + Unit + SIT 自跑 |
| 🟢 006 | [`ml-engineer`](.claude/agents/ml-engineer.md) | 质量-延迟-成本三角 — 多模态推理 + Unit + SIT 自跑 |
| 🟢 007 | [`uiux-designer`](.claude/agents/uiux-designer.md) | spec.md + index.html 双交付 + AC 覆盖表 |
| 🟢 008 | [`miniapp-dev`](.claude/agents/miniapp-dev.md) | 原生优先 Taro 兜底 — setData 256KB 是硬墙 |
| 🟡 009 | [`code-reviewer`](.claude/agents/code-reviewer.md) | 永远只写 docs/reviews/ — 代码 review + SIT Audit（4 项 + 3 档 verdict）|
| 🟡 010 | [`miniapp-code-reviewer`](.claude/agents/miniapp-code-reviewer.md) | 审核红线零容忍 — wx.* + 包体积 + 隐私协议 + SIT Audit |
| 🔴 011 | [`qa-engineer`](.claude/agents/qa-engineer.md) | Verdict 默认 ❌ — 没 curl/截图/DB diff 不升 Pass。E2E + UAT |
| 🔴 012 | [`miniapp-qa-engineer`](.claude/agents/miniapp-qa-engineer.md) | E2E 没真机扫码就不签字 |
| 🟪 013 | [`content-writer`](.claude/agents/content-writer.md) | 形容词换数字、钩子在第一句 — release notes / blog |
| 🟪 014 | [`growth-analyst`](.claude/agents/growth-analyst.md) | 指标先于直觉 — 北极星 / OMTM / A/B 实验 |

能力基线（model / tools / 预加载 skills）见 [`team-roles.md`](.claude/standards/team-roles.md)；端到端消息流见 [`team-capability-map.md §2`](./docs/team-capability-map.md)。

---

## 🔄 流程 / HOW

> 一个 feature 从需求到交付的完整链路。**6 阶段门递进 + 失败不跳级**。

### 端到端全景

```mermaid
flowchart LR
    U([👤 用户]) --> S1["S1 需求澄清<br/>brainstorming → PRD"]
    S1 --> S2["S2 派单<br/>6 段 schema + AC 摘录"]
    S2 --> S3["S3 TDD 实现<br/>red→green→refactor<br/>+ Unit + SIT 自跑"]
    S3 --> S4["S4 Code Review<br/>+ SIT Audit"]
    S4 --> S5["S5 E2E<br/>chrome-devtools-mcp"]
    S5 --> S6["S6 UAT<br/>PL 业务签字"]
    S6 --> D([🎁 交付])
    S6 -.->|可选| POST["Post-Launch<br/>content + growth"]

    S4 -.失败.-> S3
    S5 -.失败.-> S3
    S6 -.失败.-> S3

    style U fill:#3b82f6,color:#fff
    style S6 fill:#f97316,color:#fff
    style D fill:#22c55e,color:#fff
```

详图（含子图 + 小程序变体 + 上线后链 + 阶段 × Hook + 阶段 × Skill 完整版）：[`team-capability-map.md §1.1-§1.6`](./docs/team-capability-map.md)。

### 一个 feature = 一个 Sprint

| Sprint 阶段 | 谁 + 做什么 | 产物 |
|---|---|---|
| **Planning** | #001 `brainstorming` 澄清 → PRD → `writing-plans` 计划 | `docs/prd/<feature>-<date>.md`（10 节 / AC P0/P1）|
| **Design** | #007 spec.md + 自包含 HTML 原型 + **AC 覆盖表** | `docs/design/<feature>/{spec.md,index.html}` |
| **TDD 实现** | #003 + #004 并行（独立 worktree）→ red → green → refactor | 代码 + `tests/sit/` |
| **Async Standup** | 每完成一 Task → append `progress/<role>.md`（验证命令 + 真实输出 + AC 自验）| `progress/*.md` |
| **Code Review + SIT Audit** | #009 双 verdict（代码 approve/changes/block + Audit ✅/⚠️/❌）| `docs/reviews/<feature>-<date>.md` |
| **Sprint Review (E2E + UAT)** | #011 跑 E2E → UAT（业务方对照 PRD AC 逐条签字）| `docs/qa/<feature>-{e2e,uat}-<date>.md` |
| **签字 + 归档** | #001 业务签字 → `archive-progress.sh` 归档 progress | `docs/qa/<feature>-process-log.md` |
| **Retrospective**（MAJOR/MINOR）| #001 `/agf-release-retro vX.Y.Z`（7 步 + §5 Owner+Due 强制）| `docs/reviews/retro-vX.Y.Z-<date>.md` |

### PRD → Task 拆分铁律

详 [`product-workflow.md §3.3`](./docs/product-workflow.md#33-拆分规则硬性条款)：

- 1 User Story = 1~N Task，**按角色边界切**（FE/BE/AI/ML），不按 AC 切；每 Task 至少 1 条 AC，摘录到 SendMessage
- Task 粒度 = 一次会话内闭环完成（实现 + Unit + AC 自验）
- AC 是叶子，不可再拆——觉得太大就拆"可观察结果"

### 失败回路（任一阶段失败 → 不跳级，回 S3 重做）

| 阶段门 | 失败动作 | 回到 |
|---|---|---|
| code review = `request changes` | PL 重派执行层修复 | S3 |
| SIT Audit = `❌ Redo SIT` | PL 一并派回（与 code 修复合并）| S3（不进 E2E）|
| E2E fail | qa 出报告 → PL 重派 | S3（不进 UAT）|
| UAT = `request changes` | PL 重派 | S3 |

**code-reviewer / qa-engineer 永远不直接修源码**。

---

## ⚙️ 机制 / ENFORCEMENT

> 把 Agile + Scrum + TDD 心法**嵌进 skill / hook / DoD 三层 enforcement** —— 不靠 agent 自觉。

### TDD 强制链路

```mermaid
flowchart LR
    PL([🟠 PL 派单<br/>新功能 / bugfix]) --> HOOK["validate-task-schema<br/>6 段齐全"]
    HOOK --> SKILL["调 skill<br/>test-driven-development"]
    SKILL --> RED["🔴 red<br/>写失败 test<br/>commit: test:"]
    RED --> GREEN["🟢 green<br/>最少实现让测试绿<br/>commit: feat: / fix:"]
    GREEN --> REFACTOR["🔵 refactor<br/>保持绿整理代码<br/>commit: refactor:"]
    REFACTOR --> PR["PR commit history<br/>first test 早于 first impl"]
    PR --> CR["code-reviewer<br/>顺序检查"]
    CR --> PASS([✅ 进入<br/>code review + SIT Audit])

    REFACTOR -.可多轮迭代.-> RED
    CR -.违规 = block.-> RED

    style PL fill:#f97316,color:#fff
    style PASS fill:#22c55e,color:#fff
```

**跳过条件**：纯重构 / 文档 / 配置任务可跳过 TDD 顺序（[`ac-lifecycle.md` DoD line 81–85](.claude/standards/ac-lifecycle.md)）。

### 4 层 Hook 防御（红线 + 提醒）

| 层 | 触发 | 行为 |
|---|---|---|
| 🚫 | 危险命令：`rm -rf` / `DROP TABLE` / `git push --force` / `git reset --hard` | 硬阻断 |
| 🚫 | 密钥泄漏：10 家厂商 token + PEM/SSH/PuTTY/BIP39 助记词 | 硬阻断 |
| 🚫 | prompt-injection 指令（外部内容里夹带）| 软告警 |
| 🚫 | commit 前再扫 staged diff | 硬阻断（防 Edit/Write 绕过 prompt）|
| 💡 | teammate 想 idle 但 task list 还有 pending | 提醒留下干完 |
| 💡 | 执行层 idle 前没写 `progress/<role>.md` | 阻断（**Daily Standup 兜底**）|
| 💡 | `TaskCreate` 6 段 schema 缺段 | 阻断（**AC 摘录强制**）|
| 💡 | 开干前看一眼匹配的 skill | 提醒（没用过就喊）|

### 阶段 × Hook × Skill 触发点（合并视图）

| 阶段 | Hook（🛑 硬阻断 / ⚠️ 软告警）| Skill（强制 / 推荐）|
|---|---|---|
| **prompt 提交** | 🛑 `scan-secrets`（10+ 厂商密钥 + PEM/SSH/BIP39）<br/>⚠️ `skill-suggester` | — |
| **S1 需求 + PRD** | — | `brainstorming`（模糊/多选项强制）<br/>`agf-writing-prd` |
| **S2 派单** | 🛑 `validate-task-schema`（6 段齐 + AC 摘录）| `writing-plans`（≥3 AC/跨角色）<br/>`using-git-worktrees`（≥2 dev 并行强制）|
| **S3 实现期工具调用** | 🛑 `block-dangerous-bash`<br/>　Bash：`rm -rf` / `DROP TABLE` / `push --force` / `reset --hard`<br/>⚠️ `sanitize-tool-output`<br/>　WebFetch/WebSearch/Read/Bash 输出的 prompt-injection 告警 | `test-driven-development` 强制（新功能/bugfix）<br/>`agf-running-sit-tests`（Unit 后）<br/>`systematic-debugging`（遇 bug）<br/>`verification-before-completion`（报完成前）|
| **S3 退出/idle** | 🛑 `check-progress-file`（无 progress 条目阻断）<br/>🛑 `teammate-keepalive`（pending 时阻 idle）| — |
| **git commit** | 🛑 `scan-commit`（staged diff 同套 secret 正则）| — |
| **S4 review** | — | `requesting-code-review`（触发前）<br/>`receiving-code-review`（被打回时）|
| **S5/S6 测试** | — | `agf-writing-qa-report`（E2E/UAT 报告）|
| **release 后**<br/>（MAJOR/MINOR）| — | `agf-running-release-retro`（PATCH 自动 abort）|

### Release 纪律 + 撞硬阻断

**Release 纪律**：MAJOR/MINOR 必须同会话内打 tag + tag annotation 列 tagged-along commits + **必须**跑 `/agf-release-retro`。详 [`versioning.md`](.claude/standards/versioning.md)。

**撞到硬阻断** → **No Equivalent Bypass**（不得寻找等价绕过，必须 SendMessage PL 等授权）。详 [`security.md`](.claude/standards/security.md)。

### 📖 术语速查

**协作动作**（运行时高频，详 [`product-workflow.md §4.5`](./docs/product-workflow.md#45-协作动作collaboration-actions)）：

| 术语 | 含义 |
|---|---|
| **派工 / dispatch** | PL 通过 SendMessage 把 Task 分配给执行层（6 段 + AC 摘录）|
| **escalate** | 向上级请决策（执行层→PL→user；reviewer→tech-lead 升级架构风险）|
| **halt / STOP ⛔** | hook 阻断 / 测试 fail / spec drift 触发；停手并 SendMessage 报告，不私自绕过 |
| **verify-before-assert** | 报"完成"之前必须实跑验证，不空口宣布 |
| **push back** | 接到 review 反馈后基于实测有理据反对 |
| **ghost mailbox** | 往不存在或已销毁的 mailbox 派工 |
| **spec drift** | 文档/PRD/spec 中的契约与实际代码或数据库不一致 |
| **sweep** | PL 主动 git log + task list + mailbox 全扫一遍 |
| **mock-first** | 前端先用 mock 数据实现 UI，等 backend 就绪后切真接口 |

**状态指示符**（团队约定，禁自创）：

| 符号 | 含义 | 典型出现位置 |
|---|---|---|
| ✅ | 完成 / 通过 | AC 自验、Code Review verdict、UAT 签字 |
| ⚠️ | 警告 / 偏差 | AC 自验有偏差、Code Review Warning |
| ❌ | 失败 / 不通过 | 测试失败、Code Review request changes |
| 🔄 | 进行中 | Task 状态、长任务进度 |
| ⏸ | 暂停 / pending | 等待外部依赖 / 等待澄清 |
| 💤 | idle / standby | teammate 待命中 |
| ⛔ | STOP / halt | 紧急停机（hook 阻断 / spec drift / 测试 fail）|

---

## ⏱ 入职第一天 / Day 1

**前置**：Claude Code ≥ v2.1.130 + 启用 Agent Teams（`init-team.sh` 自动校验）。

```bash
# 新项目脚手架
gh repo create my-app --template pcliangx/AppGenesisForge --private
cd my-app && bash init-team.sh

# 嵌入已有仓库（一键迁移；不覆盖已有 CLAUDE.md / ADR-000 / settings.json）
bash install-to-existing.sh ~/path/to/your-existing-repo

# 直接试跑
/agf-team-start <你的第一个 feature>
```

完整清单 + 前置知识 + 常见踩坑见 [`docs/FIRST_RUN.md`](./docs/FIRST_RUN.md)。⚠️ 别直接复制本仓库的 `CLAUDE.md`——脚手架交付的是 `CLAUDE.example.md`。

---

## 🛠️ 自助服务台

### Slash Commands（4 个，Scrum 仪式入口）

| 命令 | Scrum 仪式 |
|---|---|
| [`/agf-team-start`](.claude/commands/agf-team-start.md) | Sprint 启动 |
| [`/agf-uat`](.claude/commands/agf-uat.md) | Sprint Review（业务签字） |
| [`/agf-release-retro`](.claude/commands/agf-release-retro.md) | Sprint Retrospective（PATCH 自动 abort） |
| [`/agf-tasks`](.claude/commands/agf-tasks.md) | Sprint Backlog 视图 |

### Skills（6 个项目级 + superpowers 套件）

| Skill | 谁 / 何时 |
|---|---|
| [`agf-writing-prd`](.claude/skills/agf-writing-prd/) | #001 起 PRD（10 节 + AC 5 铁律 + 完成自检）|
| [`agf-writing-adr`](.claude/skills/agf-writing-adr/) | #002 记录架构决策（强制备选 + 版本查证）|
| [`agf-wiring-multi-llm-sdk`](.claude/skills/agf-wiring-multi-llm-sdk/) | #005 接入 DeepSeek/Doubao/Qwen/MiniMax |
| [`agf-running-sit-tests`](.claude/skills/agf-running-sit-tests/) | 执行层 dev 自跑 SIT |
| [`agf-writing-qa-report`](.claude/skills/agf-writing-qa-report/) | #011 写 E2E/UAT 报告 |
| [`agf-running-release-retro`](.claude/skills/agf-running-release-retro/) | #001 跑 MAJOR/MINOR retro |

**Superpowers 套件**（全员可调）：`brainstorming` / `writing-plans` / `test-driven-development` / `systematic-debugging` / `verification-before-completion` / `requesting-code-review` / `receiving-code-review` / `using-git-worktrees`——强制点见 [`superpowers.md`](.claude/standards/superpowers.md)。

### 📊 实时观察台 / Team Dashboard

跑 `agf-team-start` 时另开终端：`cd tools/team-dashboard && ./start.sh` → `http://localhost:5173/`。三栏 UI：**Tasks** 实时状态 · **Timeline** transcript 消息流 · **Artifacts** docs/ 变化。零侵入只读 SSE。详 [`tools/team-dashboard/README.md`](tools/team-dashboard/README.md)。

---

## 🔍 对比同类项目

|  | **AppGenesisForge** | 通用 prompt 库 | 角色人格库 | 单 agent 工具链 |
|---|---|---|---|---|
| **方法论骨架** | ✅ Agile + Scrum + TDD（组织 / 流程 / 机制 三层） | ❌ | ❌ | ❌ |
| **组织** | ✅ 14 同事 + Scrum 角色映射 | ❌ | ⚠️ 仅角色列表 | ❌ |
| **流程** | ✅ PL + 6 阶段硬门槛 | ❌ | ⚠️ 仅示例 | ❌ |
| **机制（TDD 强制）** | ✅ commit 顺序 + skill + DoD | ❌ | ❌ | ❌ |
| **机制（Hook 防御）** | ✅ 4 层 | ❌ | ❌ | ❌ |
| **Retrospective** | ✅ 7 步 + Owner+Due 强制 | ❌ | ❌ | ❌ |
| **实时观察** | ✅ team-dashboard 零侵入 | ❌ | ❌ | ❌ |
| **下游迁移** | ✅ install-to-existing | ✅ 复制 | ⚠️ fork | ⚠️ |
| **国产 LLM** | ✅ DeepSeek/Doubao/Qwen/MiniMax | ❌ | ❌ | 取决于 |

---

## ✨ 总结

回看一遍：

- **是什么**：14 个 AI 同事 + Agile + Scrum + TDD 流程 + 4 层 hook 防御的脚手架
- **为什么独特**：把 Agile + Scrum + TDD 心法**嵌进 组织 + 流程 + 机制 三层落地**，不靠 agent 自觉
- **怎么用**：`/agf-team-start <feature>` → 14 同事按 Sprint 流程跑完 → 一个 tab 看完
- **对你的价值**：一晚上交付一个 feature；产物落盘可追溯；阶段门跳级签字 = 失职

> **核心取舍**：*把 Agile + Scrum + TDD 嵌进 enforcement 路径而不是写在 wiki 里*——这套体系最重要的设计取舍。一线团队反复试错沉淀的纪律：早期版本 PL 抢着写代码、Reviewer 比 Dev 还激进、QA 给不出证据，每一道 hook、每一份规范、每一个 skill，都来自一次真实的踩坑。

### 🚀 下一步

| 你想 | 怎么做 |
|---|---|
| **试跑一个全新项目** | `gh repo create --template pcliangx/AppGenesisForge` → [⏱ Day 1](#-入职第一天--day-1) |
| **嵌入到已有仓库** | `bash install-to-existing.sh ~/your-repo`（不覆盖你已有的 `CLAUDE.md`/`ADR-000`/`settings.json`）|
| **看一个真实 feature 完整产物** | `ls examples/login-feature/` —— 含 PRD → Design → Review → UAT → Release notes → Experiment 全套 |
| **给反馈 / 提 PR** | [🐛 Issue](https://github.com/pcliangx/AppGenesisForge/issues) · [🍴 PR](https://github.com/pcliangx/AppGenesisForge/pulls) |
| **看每次 release 改了什么** | [📒 CHANGELOG](CHANGELOG.md) |

### 📂 内部资料

```text
.claude/                14 agents · 14 standards · 6 skills · 8 hooks · 4 commands · 2 scripts · 2 rules
docs/                   product-workflow / team-capability-map / PRD·QA·ADR·Review·Retro 模板
examples/ · evals/      端到端 worked example + 角色 baseline JSONL
progress/               执行层 Self-Reporting 底稿（Async Daily Standup）
tools/team-dashboard/   单任务只读 web 看板（零侵入）
init-team.sh            Day-1 体检（10 项检查 + 装 pre-commit hook）
install-to-existing.sh  一键迁移到已有仓库
CLAUDE.example.md       项目级 CLAUDE.md 模板（别混本仓库的 CLAUDE.md）
```

### 🗺️ Roadmap

**已落地**：

| Release | 内容 |
|---|---|
| Foundation | 4 国产 LLM 接入 · 微信小程序三件套 · 4 层 hook 默认防御 · Self-Reporting Pattern · agent 命名空间稳态 |
| **v1.6.0** | team-dashboard 零侵入观察台 + `install-to-existing.sh` 一键迁移 |
| **v1.7.0** | code-reviewer 引入 `/simplify` Phase 1+2 review |
| **v2.0.0** | H3 后期工作流：SIT 责任 dev 自跑 → code-reviewer audit |
| **v3.0.0** | 移除 cost audit feature（连续两次空转 = 误纪律）|
| **v3.1.0** | **Agile + Scrum + TDD enforcement 完整**（skill / hook / DoD 三层兜底）+ README rewrite + 文档 traceability |

**进行中**：

- [ ] 更多 skill：测试用例 / commit message / release notes
- [ ] 更多 eval baseline 角色 JSONL
- [ ] CI/CD：`init-team.sh` 接 GitHub Actions
- [ ] feature cycle time 趋势可视化（≥3 retro 后启用）

---

## 📜 License & Acknowledgments

MIT — 自由商用。结构灵感参考 [The Agency](https://github.com/msitarzewski/agency-agents)。

---

<div align="center">

**14 个 AI 同事 · Agile + Scrum + TDD（组织 / 流程 / 机制 三层落地）· 一晚上交付一个 feature**

[⭐ Star](https://github.com/pcliangx/AppGenesisForge) · [🍴 Fork](https://github.com/pcliangx/AppGenesisForge/fork) · [🐛 Issue](https://github.com/pcliangx/AppGenesisForge/issues) · [📒 CHANGELOG](CHANGELOG.md) · [🇬🇧 English](README.en.md) · [🇯🇵 日本語](README.ja.md)

</div>
