Code the Origin, Forge the App. 14 个 AI 同事 · 一套流程 · 一晚上交付一个 feature。
简体中文 · English
基于 Claude Code Agent Teams（实验性特性，配合 .claude/agents/ 复用 sub-agent 定义）构建——不是 prompt 收藏，也不是角色人格清单，而是一支带流程、带规范、带验收闭环的 AI 团队脚手架，源自一线团队对"AI 协作能不能真的可交付"的反复试错。
- 🎯 角色边界硬约束：14 位同事各管一摊，PL 不抢代码、Reviewer 不动源码、QA 不签业务字
- 🧠 人格 + 铁律：每位都带战疤式 vibe（"对 schema 迁移有 PTSD"）+ 不可绕过的铁律
- 📋 PRD → UAT 全链路：每个 feature 必经
code review → SIT → E2E → UAT阶段门槛，产物落盘docs/ - 🛡️ 默认安全：4 层 hook 防御（危险命令 / 密钥 / 注入 / commit）开箱即用
- 🇨🇳 国产生态：DeepSeek / Doubao / Qwen / MiniMax + 微信小程序三件套 + 月度成本治理
一句话：把"AI 团队"从演员名册升级为一条会签字、会拒绝、会留证据的工厂流水线。
我们替你招了 14 个 AI 同事 —— 一个不抢功的产品经理、一个只在关键时刻出现的技术顾问、六个并行干活的工程师、两个专挑刺的评审、两个证据驱动的 QA，再加一个写发布说明的内容同事和一个看指标的增长同事。他们不睡觉、不抢提交、不绕过流程，所有协作动作和产物路径都写在黑板上。
这不是一份 prompt 收藏，是一支带流程、带规范、带验收闭环的 AI 团队。v3.0.0 把 agent 命名回滚到无前缀（real-world Agent Teams 路由 bug 反推），skills + commands 仍带 agf- 前缀 —— 见 CHANGELOG.md。
适合谁来用：React + FastAPI + Postgres 全栈业务 · AI Agent / RAG / 多模态推理（DeepSeek / Doubao / Qwen / MiniMax）· 微信小程序（原生 + Taro 兜底）· 完整产品迭代闭环。
不适合：iOS / Android 原生 · 桌面 GUI · 大模型训练 · Java / Go / Rust 主线（需 tech-lead 重写 ADR-000）。
前置条件：Claude Code ≥ v2.1.32 且已启用 Agent Teams（
.claude/settings.json自带CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1flag，init-team.sh会校验）。未安装 Claude Code 见 官方安装文档。
gh repo create my-app --template pcliangx/AppGenesisForge --private
cd my-app
bash init-team.shinit-team.sh 跑 10 项校验（Claude Code 版本 / hook 回归 / JSON 合法性 / 必备文件 / git 状态），并自动安装 git pre-commit hook。
bash init-team.sh
⚠️ 不要复制本仓库的CLAUDE.md—— 那是 AppGenesisForge 自己的项目说明，不是模板。
📋 需要复制的文件清单（点开看）
.claude/（含 agents / standards / skills / hooks / rules / commands / settings.json / FIRST_RUN.md）CLAUDE.example.md→ 改名为CLAUDE.md并填项目内容CHANGELOG.md、init-team.sh、evals/docs/team-capability-map.md（角色通信图 + 能力对照）、docs/product-workflow.md（产品交付工作流 + 术语词典）、docs/PROJECT-PLAN.md（项目级 task 看板）docs/prd/_TEMPLATE.md、docs/reviews/_TEMPLATE.md、docs/qa/_TEMPLATE.md
/agf-team-start <你的第一个 feature>
完整 10 步 Day-1 清单 + 常见踩坑见 .claude/FIRST_RUN.md。
flowchart TD
U([User])
PL[product-lead<br/>orchestrator · opus]
TL[tech-lead<br/>conditional · opus]
EXE[Execution Layer<br/>frontend-dev · backend-dev<br/>ai-agent-dev · ml-engineer<br/>uiux-designer · miniapp-dev]
CR[code-reviewer<br/>review-only]
QA[qa-engineer<br/>SIT → E2E → UAT]
POST[Post-Launch<br/>content-writer · growth-analyst]
U -->|requirement| PL
PL -.->|architecture Q| TL
TL -.->|ADR / risk| PL
PL -->|tasks + AC| EXE
EXE -->|completion| PL
PL -->|review| CR
CR -->|verdict| PL
PL -->|tests| QA
QA -->|report| PL
PL -->|delivery| U
PL -.->|content / metrics| POST
POST -.->|notes / experiment report| PL
style PL fill:#f97316,color:#fff
style TL fill:#3b82f6,color:#fff
style EXE fill:#22c55e,color:#fff
style CR fill:#eab308,color:#fff
style QA fill:#ef4444,color:#fff
style POST fill:#a78bfa,color:#fff
完整 14 角色协作图（含 miniapp-* 三件套与 post-launch 双子岗）见 docs/team-capability-map.md；产物流转与术语词典见 docs/product-workflow.md。
颜色 = 分工：🟠 编排 · 🔵 架构 · 🟢 执行 · 🟡 评审 · 🔴 QA · 🟪 上线后
| # | Agent · 性格 | 岗位职责 | 找他时机 |
|---|---|---|---|
| 🟠 001 | product-lead不写代码只签字——模糊需求一律打回，AC 不可测就不放行。 |
唯一编排者；PRD / 派任务 / UAT 签字 | feature 入口 / 多角色协调 / UAT |
| 🔵 002 | tech-lead平时不出现的技术老兵——没备选方案的 ADR 等于没决策。 |
技术顾问；ADR 与 Tech Stack 基线 | 缺基线 / 新选型 / 架构风险（仅此 3 种） |
| 🟢 003 | frontend-dev组件即契约——dev server 跑过才敢说完成。 |
React + Vite 实现、API 对接 | UI 组件、样式、前端 bug |
| 🟢 004 | backend-dev对 schema 迁移有 PTSD——没回滚方案就先不改。 |
FastAPI / SQLAlchemy / Alembic | REST API、数据库迁移、认证中间件 |
| 🟢 005 | ai-agent-devPrompts 是代码——改 prompt 也得跑回归测试。 |
LLM 集成、Prompt 工程、Agent | RAG、tool calling、guardrails |
| 🟢 006 | ml-engineer质量-延迟-成本三角永不偏——只用现成 API，不自建推理。 |
多模态推理、图像 / 视频 pipeline | 豆包 / 可灵 / MiniMax Video 接入 |
| 🟢 007 | uiux-designerspec.md + index.html 双交付——浏览器打开能用才算设计完成。 |
UI/UX + 静态 HTML 原型 | 界面布局、原型评审、MiniApp 设计兜底 |
| 🟢 008 | miniapp-dev原生优先 Taro 兜底——setData 256KB 是硬墙。 |
微信小程序（原生 / Taro 兜底） | 页面 / wx.* API / 网络请求 |
| 🟡 009 | code-reviewer永远只写 docs/reviews/——三缺一的 finding 自己打回重写。 |
代码审查、安全审计、质量评估 | PR 审查、安全漏洞、最佳实践巡检 |
| 🟡 010 | miniapp-code-reviewer审核红线零容忍——wx.* + 包体积 + 隐私协议三条线必查。 |
小程序审查（审核合规 + 包体积） | wx.* / setData / 主分包体积 |
| 🔴 011 | qa-engineerVerdict 默认 ❌ Block——没 curl/截图/DB diff 不升级到 Pass。 |
SIT / E2E / UAT 全链路 | 系统集成测试、AC 验证 |
| 🔴 012 | miniapp-qa-engineer模拟器只测 SIT——E2E 没真机扫码就不签字。 |
小程序模拟器 + 真机测试 | 真机回归、隐私协议合规、提审前置 |
| 🟪 013 | content-writer面向真实读者写——不堆术语不上感叹号，钩子放在第一句话。 |
release notes / blog / 用户案例 | UAT 通过后写发布说明、上线博客 |
| 🟪 014 | growth-analyst指标先于直觉——没北极星不上实验，没置信度不下结论。 |
北极星 / OMTM / A/B 实验 / 漏斗分析 | 需要指标定义、实验设计、上线后效果验证 |
单一来源：能力基线（工具 / skills / 推荐 mode）见 .claude/standards/team-roles.md；通信图与并行规则见 docs/team-capability-map.md。
下面是这家公司一周里最常见的三种工单。
工单：/agf-team-start 新增团队邀请流程
#001 起 PRD → #007 出 HTML 原型 → #003 + #004 并行实现 → #009 审 PR → #011 跑 SIT/E2E/UAT → #001 签字。
结果：单条 slash 命令落地完整 feature，PRD / 设计 / 代码 / 评审 / 测试报告全部按 .claude/rules/repo-layout.md 归档到 docs/。
工单：/agf-team-start 接入 DeepSeek + Doubao 双供应商，带 fallback
#002 起 ADR → #005 按 skill agf-wiring-multi-llm-sdk 实现 OpenAI-compatible adapter → #009 审密钥处理与 fallback 逻辑 → #011 跑成本 + 延迟基线。
结果：env 变量切换即可换厂商，cost guardrail 内置，符合 cost-budget.md 阈值。
工单：/agf-team-start 商品详情页小程序
#007（MiniApp Mode）出原型 → #008 实现 → #010 审 wx.* API + 包体积 → #012 真机回归 + 隐私协议 → #001 提审。
结果：审核红线、setData 性能、主分包体积全过；附带提审前合规清单。
其他工单（单角色 bugfix / 月度成本审计 / ADR 漂移巡检 / 依赖审计）见下方 🛠️ 自助服务台。
在这里上班有 4 条红线 和 3 个温柔提醒，员工自己绕不过去（你也别试）。
- 🚫 红线：危险命令（
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 —— 留下，干完再走
- 💡 提醒：TaskCreate / TaskUpdate 之后 —— 同步一下
PROJECT-PLAN.md - 💡 提醒：开干之前 —— 看一眼匹配的 skill 有没有
完整防御链路见 .claude/standards/security.md；跨项目通用规范在 .claude/standards/，详见入口 index.md。
📋 完整 hooks 表（7 个：4 防御 + 3 workflow）
| 类型 | Hook | 作用 |
|---|---|---|
| 🛡️ 防御 | block-dangerous-bash |
硬阻断 rm -rf / DROP TABLE / git push --force / git reset --hard |
| 🛡️ 防御 | scan-secrets |
硬阻断 AWS/GitHub/OpenAI/Anthropic/Google/Slack/DeepSeek/Doubao/Qwen/MiniMax 等密钥 + PEM/SSH/PuTTY/BIP39 |
| 🛡️ 防御 | sanitize-tool-output |
软告警外部内容里的 prompt-injection 指令 |
| 🛡️ 防御 | scan-commit (git pre-commit) |
commit 前再扫一遍，防 Edit/Write 绕过 prompt 检查 |
| ⚙️ workflow | teammate-keepalive |
task list 还有 pending 时阻止 teammate 提前 idle |
| ⚙️ workflow | plan-sync-check |
TaskCreate/TaskUpdate 后提醒同步 PROJECT-PLAN.md |
| ⚙️ workflow | skill-suggester |
按 skill-rules.json 软建议匹配的 skill |
不用每件事都开会 —— 4 个 slash command + 5 个 skill 覆盖了大部分日常操作。
| 命令 | 用途 |
|---|---|
/agf-team-start |
启动多角色 Team Mode 完成 feature |
/agf-usage |
跑内置 /usage 并把会话成本追加到月度审计 |
/agf-sit |
触发 #011 对指定 feature 跑 SIT |
/agf-uat |
#001 + #011 联跑 UAT |
| Skill | 谁会用 / 何时用 |
|---|---|
agf-writing-prd |
#001 起 PRD 时强制使用 |
agf-writing-adr |
#002 记录架构决策时使用 |
agf-running-sit-tests |
任何执行 SIT 的同事必看 |
agf-writing-sit-report |
#011 写测试报告必用 |
agf-wiring-multi-llm-sdk |
#005 接入 DeepSeek / Doubao / Qwen / MiniMax 必看 |
.claude/ 14 agents · 12 standards · 5 skills · 7 hooks · 4 commands
docs/ 产品工作流 / 团队能力图 / PRD/QA/ADR/Review 模板
examples/ 端到端 worked example（PRD → ADR → Review → SIT → UAT 全链路）
evals/ 5 个角色的 baseline 断言用例
init-team.sh Day-1 验证脚本（10 项检查 + 自动装 git pre-commit）
CLAUDE.example.md 项目级 CLAUDE.md 模板
CHANGELOG.md v1 → v2 完整迁移表
📂 完整目录树（点开看）
.claude/
├── agents/ 14 角色定义（9 通用 + 3 miniapp-* + 2 post-launch）
├── standards/ 12 套团队规范（角色 / 工作流 / 测试 / 安全 / 观测 / 成本 / 文档 / 编码 / superpowers / AC / 小程序 / 版本）
├── skills/ 5 个项目 skill
├── hooks/ 7 个 hook（4 防御 + 3 workflow）
├── rules/ path-scoped 规则：repo-layout.md / team-mode.md
├── commands/ 4 个 slash command
├── settings.json Agent Teams flag / permissions / hooks 注册
└── FIRST_RUN.md Day-1 完整 10 步 + 常见踩坑
docs/
├── team-capability-map.md 14 角色能力对照 + 协作 Mermaid 图
├── product-workflow.md 产品交付工作流 + 全量术语词典
├── PROJECT-PLAN.md 项目级 task 看板（#001 实时维护）
├── prd/_TEMPLATE.md PRD 模板（配合 skill agf-writing-prd）
├── reviews/_TEMPLATE.md Code Review 模板 + 月度 cost / 季度 eval 漂移记录
├── qa/_TEMPLATE.md QA 报告模板（配合 skill agf-writing-sit-report）
└── adr/ 架构决策记录（含 ADR-000 + skill agf-writing-adr）
evals/run.sh JSONL lint + 季度漂移巡检生成器
.github/workflows/ Claude Code GitHub Action 模板（默认未启用）
- 新项目：
gh repo create my-app --template pcliangx/AppGenesisForge --private，跑bash init-team.sh - 嵌入已有仓库：见上方 入职第一天 · Option 2
- 接手历史项目：让
tech-lead扫描代码识别现状基线（不是从零选型），输出 ADR-000；合规约束 / 内部约定补到CLAUDE.md
- v2.0.0 完整
agf-命名空间迁移 - 多 LLM SDK 接入：DeepSeek / Doubao / Qwen / MiniMax
- 微信小程序三件套：dev + reviewer + qa
- Hook 四层防御 + 月度成本审计 + 周度 ADR 漂移
- 更多 skill：写测试用例、写 commit message、写 release notes
- 更多 eval baseline：补齐剩余角色的 JSONL 用例
- CI/CD：把
init-team.sh接到 GitHub Actions - 视频教程：从 0 跑通一条完整 feature 链路
市面上"AI 多角色"开源项目不少。AppGenesisForge 不是它们的替代，而是补另一个坐标——把"角色"嵌进可运行的工厂流水线。
| AppGenesisForge | 通用 prompt 库 | 角色人格库（如 The Agency） | 单 agent 工具链 | |
|---|---|---|---|---|
| 形态 | 可运行的 AI 团队脚手架 | 单点 prompt 收藏 | 角色人格菜单（fork-and-pick） | 单 agent + 通用工具 |
| 编排 | ✅ 强编排：PL 单 lead + code review → SIT → E2E → UAT 硬门槛 |
❌ 无 | ❌ 无 | |
| 安全 hook | ✅ 4 层（危险命令 / 密钥 / 注入 / commit） | ❌ | ❌ | ❌ |
| 成本治理 | ✅ 月度审计 + 预算阈值 + /agf-usage |
❌ | ❌ | ❌ |
| 文档纪律 | ✅ PRD / ADR / SIT / UAT 单一来源 | ❌ | ❌ | |
| 角色广度 | 14（工程交付 + 内容 + 增长 + 小程序） | — | 100+（覆盖业务横向广，但无编排） | 1 |
| 国产 LLM 适配 | ✅ DeepSeek / Doubao / Qwen / MiniMax + skill | ❌ | ❌ | 取决于 |
| 跨平台分发 | ✅ 任何 LLM | ✅ 11 个 IDE | ✅ | |
| 典型用户 | 想"今晚交付一个 feature 并签字"的团队 | 想试单点能力 | 想 fork 角色人格做集成 | 个人开发者 |
怎么选：
- 想要"角色多但不要流程"——选各种角色人格库Agent
- 想要"单点 prompt 即用即走"——任意 prompt collection
- 想要"一支真的能交付的 AI 团队"——App Genesis Forge
MIT License — 自由商用，欢迎署名。
这套模板来自一线团队对"如何让 AI 协作真正可交付"的反复试错：早期版本 PM 抢着写代码、Reviewer 比 Dev 还激进、QA 给不出证据 —— 每一道 hook、每一份规范、每一个 skill，都来自一次真实的踩坑。结构灵感参考自 The Agency。
14 个 AI 同事 · 一套流程 · 一晚上交付一个 feature
⭐ Star · 🍴 Fork · 🐛 Issue · 📒 CHANGELOG · 🇬🇧 English