App Genesis Forge · AI 虚拟员工们

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

简体中文 · English · 日本語

📖 阅读路径（总-分-总）：

• 总（结论 + 心法） ── 💡 结论 → 🧠 核心思想
• 分（3 支柱 + 上手） ── 🏢 组织 → 🔄 流程 → ⚙️ 机制 → ⏱ 入门 → 🛠️ 工具
• 总（收尾） ── 🔍 对比 → ✨ 总结

💡 是什么（结论先行）

AppGenesisForge 是基于 Claude Code Agent Teams 构建的 AI 团队脚手架——不是 prompt 收藏，不是角色人格库，而是一支以 Agile + Scrum + TDD 为骨架、带流程、带规范、带验收闭环的 AI 虚拟团队。

核心结论（一句话）

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

5 个事实

• 🧠 方法论骨架不可妥协 —— Agile + Scrum + TDD（见 §核心思想）
• 🏢 组织清晰 —— 14 位 AI 同事职责契约（见 §组织）
• 🔄 流程闭环 —— PRD → UAT 6 阶段门，失败不跳级（见 §流程）
• ⚙️ 机制兜底 —— skill 强制 / hook 阻断 / DoD checklist 三层（见 §机制）
• 🇨🇳 国产生态 —— 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 + 替换 backend-dev / testing.md / agf-wiring-multi-llm-sdk 中的 Python 代码范例。

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

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

完整决策见 product-workflow.md §4.4 + team-capability-map.md §1.6。

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

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

🏢 组织 / WHO

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

Scrum 三角色映射

14 位 AI 同事一览

能力基线（model / tools / 预加载 skills）见 team-roles.md；端到端消息流见 team-capability-map.md §2。

🔄 流程 / HOW

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

端到端全景

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。

一个 feature = 一个 Sprint

PRD → Task 拆分铁律

详 product-workflow.md §3.3：

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

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

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

⚙️ 机制 / ENFORCEMENT

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

TDD 强制链路

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）。

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

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

Release 纪律 + 撞硬阻断

Release 纪律：MAJOR/MINOR 必须同会话内打 tag + tag annotation 列 tagged-along commits + 必须跑 /agf-release-retro。详 versioning.md。

撞到硬阻断 → No Equivalent Bypass（不得寻找等价绕过，必须 SendMessage PL 等授权）。详 security.md。

📖 术语速查

协作动作（运行时高频，详 product-workflow.md §4.5）：

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

⏱ 入职第一天 / Day 1

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

# 新项目脚手架
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。⚠️ 别直接复制本仓库的 CLAUDE.md——脚手架交付的是 CLAUDE.example.md。

🛠️ 自助服务台

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

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

Superpowers 套件（全员可调）：brainstorming / writing-plans / test-driven-development / systematic-debugging / verification-before-completion / requesting-code-review / receiving-code-review / using-git-worktrees——强制点见 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。

🔍 对比同类项目

✨ 总结

回看一遍：

• 是什么：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，都来自一次真实的踩坑。

🚀 下一步

📂 内部资料

.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

已落地：

进行中：

• 更多 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。