# 官网V1 Agent Team 实战经验萃取（Clover开工参考）

> 来源：2026-06-05 派Explore agent考察 `/Users/qiyu/Documents/企业培训项目/官网V1/`
> 用途：Clover用agent team开工前，吸收官网V1的成功做法、规避其踩过的坑

## 官网V1概况
企业AI官网(奇域AI)，Vanilla JS前端+Node/Express后端+PostgreSQL，多agent自主开发，真跑通主链路。
PRD 4.7万字21章；6个agent角色卡；三层约束(CLAUDE.md+rules+hooks)；16个集成测试6/1验证14/14通过。

## ✅ 值得保留的6条做法
1. **先做PRD多轮交叉验证再启动**：4个独立agent从完整性/可行性/风险/时间盒压测PRD，提前发现"yaml不存在/agent文件不存在"等第一天就卡死的红线
2. **Agent角色卡5要素**：必读文档+强制+禁止+工作流程+协作协议；禁止项要极具体("❌api/*.js不能import infrastructure/"而非"不要写坏代码")
3. **Integration-lead当天做契约偏离全量扫描**：扫所有调用点产出结构化偏离清单+决策
4. **每个agent写"自我披露"standup**：当天写文件清单/TODO/已知bug/契约不一致处→后续接手知道当前状态，PM不用猜
5. **Stop Hook强制跑验证**：每次cc停止自动跑测试，不允许"我觉得对了"就算完
6. **技术栈在CLAUDE.md写死且说明"为什么"**：不只"用什么"还有"为什么不用Redis/ORM"+PRD章节引用→agent遇到能自查不另提方案

## ⚠️ 必须优化的6个坑
1. **坑:PRD和可执行脚手架有时间差**(yaml/agent文件/hooks都是启动当天临时生成，第一天下午才能有保护地开发)
   → 优化:PRD分两层=设计层PRD + 启动包(bootstrap kit:yaml初稿/agent文件/hooks/plan)，启动前一天备好，启动日直接validate不是生成
2. **坑:业务方向开发中途大转变**(第10天从诊断站翻盘到引流站，大量返工；验证报告验了PRD质量没验方向对不对)
   → 优化:PRD验证加一轮"业务假设验证"，开工前用最小原型/访谈确认核心假设。**Clover此坑已规避**:7洞已做完业务存活验证
3. **坑:DB约束与业务代码不同步+静默失败**(CHECK约束拒绝新值，service的try-catch静默吞错，接口返200但没入库)
   → 优化:①service错误不能静默至少打error log ②DB枚举约束要有对应代码侧常量文件，schema变更lint能检测
4. **坑:Agent"假设字段"联调时爆炸**(yaml里type:object留空，前后端各自假设嵌套结构)
   → 优化:契约里type:object不能留空，冻结前所有嵌套object一级子字段必须定义；yaml里type:object没properties=契约未完成不许冻结
5. **坑:临时调试文件堆积**(6个test_*_tmp.js留仓库)
   → 优化:Stop Hook检查*_tmp*文件打提醒；CLAUDE.md规定调试脚本带_tmp后缀+task完成由QA agent清理
6. **坑:Plan文件不完整**(要求8个实际5个，没plan的模块恰是后来出问题多的)
   → 优化:plan的"写完+approve"成为integration-lead检查项；standup报"未plan的P0模块"清单

## 对Clover的直接启示
- 官网V1的"三层约束(CLAUDE.md+rules+hooks)+角色卡5要素+standup自我披露+Stop Hook验证"整套机制 → Clover直接继承
- 官网V1最大的坑(方向中途变) → Clover靠7洞验证已规避，这是我们的优势
- 官网V1的契约留白坑 → Clover的PRD必须把接口字段定义全，不留type:object空壳
- 启动包要提前备(不要启动当天临时生成)
