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 自觉。

6 个事实

🧠 方法论骨架不可妥协 —— Agile + Scrum + TDD（见 §核心思想）
🏢 组织清晰 —— 14 位 AI 同事职责契约（见 §组织）
🔄 流程闭环 —— PRD → UAT 6 阶段门，失败不跳级（见 §流程）
🚀 并行度可控 —— Multi-instance Worker Pool（ADR-001）：≥2 同 type pending task → Dev / Reviewer / QA 三层自动 fan-out，PL 用 agf-matrix.sh fan-in
⚙️ 机制兜底 —— 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。

三层落地速记：TDD / AC / DoD / DoR / User Story（⚙️ 机制）· PO+SM = product-lead，14 角色 cross-functional（🏢 组织）· Sprint = feature 流 / async standup = progress + SendMessage / Retro = /agf-release-retro（🔄 流程）。完整心法清单 + Scrum 词汇替代映射见上方 §4.4 / §1.6 链接。

🏢 组织 / WHO

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

Scrum 三角色映射

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

14 位 AI 同事一览

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

能力基线（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 --> POOL{"≥2 同 type<br/>pending task?"}
    POOL -->|是| FANOUT["⚙️ Pool fan-out<br/>spawn type-1 / type-2 / ...<br/>ADR-001"]
    POOL -->|否| S3
    FANOUT --> S3["S3 TDD 实现<br/>red→green→refactor<br/>+ Unit + SIT 自跑"]
    S3 --> FANIN["agf-matrix.sh<br/>PL fan-in 聚合<br/>(pool 模式才用)"]
    FANIN --> S4["S4 Code Review<br/>+ SIT Audit<br/>verdict 三档"]
    S4 --> S5["S5 E2E<br/>chrome-devtools-mcp<br/>verdict 三档"]
    S5 --> S6["S6 UAT<br/>P0 case pass^2<br/>PL 业务签字"]
    S6 --> D([🎁 交付])
    S6 -.->|可选| POST["Post-Launch<br/>content + growth"]

    S4 -.block / Redo SIT.-> S3
    S5 -.Block.-> S3
    S6 -.request changes.-> S3

    style U fill:#3b82f6,color:#fff
    style S6 fill:#f97316,color:#fff
    style D fill:#22c55e,color:#fff
    style FANOUT fill:#7c3aed,color:#fff
    style FANIN fill:#7c3aed,color:#fff

详图（含子图 + 小程序变体 + 上线后链 + 阶段 × Hook + 阶段 × Skill + Pool 速查完整版）：team-capability-map.md §1.1-§1.7。

一个 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；≥2 同 type pending task → 自动 fan-out 成 Pool（实例命名 `<type>-N`）	代码 + `tests/sit/`
Async Standup	每完成一 Task → append `progress/<role>{-N}.md`（5 段：状态 / Skills / SIT 证据 [含 AC `[x]/[ ]` 内联] / 质量门 / 下一步）；Pool 模式下 PL 用 `agf-matrix.sh --type=progress` fan-in	`progress/*.md`
Code Review + SIT Audit	#009 双 verdict（代码 `approve` / `approve with changes` / `block` + SIT Audit `Pass` / `Pass with concerns` / `Redo SIT`）；Pool 模式 `-r<N>`	`docs/reviews/<feature>(-r<N>)-<date>.md`
Sprint Review (E2E + UAT)	#011 跑 E2E（verdict `Promote` / `Conditional promote` / `Block`）→ UAT（P0 case pass^2 / 连续 2 次都过才升业务签字 `approve` / `request changes`）；Pool 模式 `-e2e-q<N>` / `-uat-q<N>`	`docs/qa/<feature>-{e2e,uat}(-q<N>)-<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：

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

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

4 套 verdict 词表（code review / SIT Audit / QA 报告级 / UAT 业务签字，团队约定禁自创）详 workflow.md §Verdict 词表。

阶段门	失败 verdict	失败动作	回到
Code Review	`block`	PL 重派执行层修复	S3
SIT Audit	`Redo SIT`	PL 一并派回（与 code 修复合并）	S3（不进 E2E）
E2E	`Block` / `Conditional promote`	qa 出报告 → PL 重派	S3（不进 UAT）
UAT 业务签字	`request changes`	PL 重派	S3
P0 case pass^2	连续 2 次未都过	qa 不签字回 S3（`agf-writing-qa-report` 强制）	S3
Pool 单实例 fail	单 `-N` 实例阻塞	PL respawn 该实例（不影响其他实例继续）	该 `-N` 局部回退
Pool ≥50% fail	大面积失败	PL abort 整批 + PRD review	S1

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 防御（红线 + 提醒）

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

Release 纪律 + 撞硬阻断

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

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

📖 术语速查

协作动作（运行时高频）：派工/dispatch · fan-out/fan-in · pass^2 · escalate · halt/STOP ⛔ · verify-before-assert · push back · ghost mailbox · spec drift · sweep · mock-first —— 释义详 product-workflow.md §4.5。

状态指示符（禁自创）：✅ 完成 · ⚠️ 警告 · ❌ 失败 · 🔄 进行中 · ⏸ 暂停 · 💤 idle · ⛔ STOP —— 详 product-workflow.md §4.7。

⏱ 入职第一天 / Day 1

前置：Claude Code ≥ v2.1.154 + 启用 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（5 个，Scrum 仪式入口）

命令	Scrum 仪式
`/agf-team-start`	Sprint 启动
`/agf-uat`	Sprint Review（业务签字）
`/agf-team-stop`	Sprint 收尾（UAT 签字后关执行层 teammate）
`/agf-release-retro`	Sprint Retrospective（PATCH 自动 abort）
`/agf-tasks`	Sprint Backlog 视图

Skills（9 个项目级 + 2 个第三方 docx/pptx + superpowers 套件）

Skill	谁 / 何时
`agf-writing-prd`	#001 起 PRD（10 节 + AC 5 铁律 + 完成自检）
`agf-writing-adr`	#002 记录架构决策（强制备选 + 版本查证）
`agf-wiring-multi-llm-sdk`	#005 接入 DeepSeek/Doubao/Qwen/MiniMax
`agf-running-sit-tests`	执行层 dev 自跑 SIT
`agf-writing-qa-report`	#011 写 E2E/UAT 报告
`agf-running-release-retro`	#001 跑 MAJOR/MINOR retro
`agf-writing-docx-reports`	程序化生成中文 docx 报告（决议书 / 评审 / 投标书）
`agf-writing-pptx-reports`	程序化生成中文 pptx deck（制度 / 党政 / 宣贯）
`agf-writing-github-issue`	在仓库提 issue（含 QA 自动 path / 标签锁定）

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

Scripts（4 个 PL/maintainer 工具）

Script	谁 / 何时
`agf-tasks.sh`	PL 查看 task list 表格视图（slash `/agf-tasks` 内部调用）
`agf-matrix.sh`	PL Pool fan-in 聚合：`--type=progress\|review\|qa` 三模式，把 N 份 `<role>-N.md` / `-r<N>` / `-q<N>` 报告合并成一张表
`archive-progress.sh`	PL UAT 签字后归档 `progress/<role>{-N}.md` → `docs/qa/<feature>-process-log.md`（支持 pool 多实例合并）
`lint-all.sh`	全仓 bash/JSON/YAML lint 入口；pre-commit hook 链调

🔍 对比同类项目

	AppGenesisForge	通用 prompt 库	角色人格库	单 agent 工具链
方法论骨架	✅ Agile + Scrum + TDD（组织 / 流程 / 机制三层）	❌	❌	❌
组织	✅ 14 同事 + Scrum 角色映射	❌	⚠️ 仅角色列表	❌
流程	✅ PL + 6 阶段硬门槛	❌	⚠️ 仅示例	❌
机制（TDD 强制）	✅ commit 顺序 + skill + DoD	❌	❌	❌
机制（Hook 防御）	✅ 4 层	❌	❌	❌
Retrospective	✅ 7 步 + Owner+Due 强制	❌	❌	❌
国产 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
嵌入到已有仓库	`bash install-to-existing.sh ~/your-repo`（不覆盖你已有的 `CLAUDE.md`/`ADR-000`/`settings.json`）
看一个真实 feature 完整产物	`ls docs/training/samples/postcard-feature/` —— 含 PRD → ADR → Dispatch → Progress → Review → UAT → Retro → Release notes 全套（教学示意路径）
给反馈 / 提 PR	🐛 Issue · 🍴 PR
看每次 release 改了什么	📒 CHANGELOG

📂 内部资料

.claude/                agents · standards · skills · hooks · commands · scripts · rules
docs/                   product-workflow / team-capability-map / PRD·QA·ADR·Review·Retro 模板
docs/training/samples/ · evals/      端到端 worked example（postcard-feature）+ 角色 baseline JSONL
progress/               执行层 Self-Reporting 底稿（Async Daily Standup）init-team.sh            Day-1 体检（10 项检查 + 装 pre-commit hook）
install-to-existing.sh  一键迁移到已有仓库
CLAUDE.example.md       项目级 CLAUDE.md 模板（别混本仓库的 CLAUDE.md）

🗺️ Roadmap

已落地：逐版本明细见 CHANGELOG。

进行中（待发布）：

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

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

⭐ Star · 🍴 Fork · 🐛 Issue · 📒 CHANGELOG · 🇬🇧 English

Name		Name	Last commit message	Last commit date
Latest commit History 287 Commits
.claude		.claude
.github/workflows		.github/workflows
docs		docs
evals		evals
progress		progress
template		template
.gitignore		.gitignore
.mcp.json		.mcp.json
CHANGELOG.md		CHANGELOG.md
CLAUDE.example.md		CLAUDE.example.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
agf-team-start.sh		agf-team-start.sh
customize.sh		customize.sh
docker-compose.yml		docker-compose.yml
init-team.sh		init-team.sh
install-to-existing.sh		install-to-existing.sh

Folders and files

Latest commit

History

Repository files navigation

App Genesis Forge · AI 虚拟员工们

💡 是什么（结论先行）

核心结论（一句话）

6 个事实

适用边界

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

🏢 组织 / WHO

Scrum 三角色映射

14 位 AI 同事一览

🔄 流程 / HOW

端到端全景

一个 feature = 一个 Sprint

PRD → Task 拆分铁律

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

⚙️ 机制 / ENFORCEMENT

TDD 强制链路

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

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

Release 纪律 + 撞硬阻断

📖 术语速查

⏱ 入职第一天 / Day 1

🛠️ 自助服务台

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

Skills（9 个项目级 + 2 个第三方 docx/pptx + superpowers 套件）

Scripts（4 个 PL/maintainer 工具）

🔍 对比同类项目

✨ 总结

🚀 下一步

📂 内部资料

🗺️ Roadmap

📜 License & Acknowledgments

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 23

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages