6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
官网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条做法
- 先做PRD多轮交叉验证再启动：4个独立agent从完整性/可行性/风险/时间盒压测PRD，提前发现"yaml不存在/agent文件不存在"等第一天就卡死的红线
- Agent角色卡5要素：必读文档+强制+禁止+工作流程+协作协议；禁止项要极具体("❌api/*.js不能import infrastructure/"而非"不要写坏代码")
- Integration-lead当天做契约偏离全量扫描：扫所有调用点产出结构化偏离清单+决策
- 每个agent写"自我披露"standup：当天写文件清单/TODO/已知bug/契约不一致处→后续接手知道当前状态，PM不用猜
- Stop Hook强制跑验证：每次cc停止自动跑测试，不允许"我觉得对了"就算完
- 技术栈在CLAUDE.md写死且说明"为什么"：不只"用什么"还有"为什么不用Redis/ORM"+PRD章节引用→agent遇到能自查不另提方案
⚠️ 必须优化的6个坑
- 坑:PRD和可执行脚手架有时间差(yaml/agent文件/hooks都是启动当天临时生成，第一天下午才能有保护地开发) → 优化:PRD分两层=设计层PRD + 启动包(bootstrap kit:yaml初稿/agent文件/hooks/plan)，启动前一天备好，启动日直接validate不是生成
- 坑:业务方向开发中途大转变(第10天从诊断站翻盘到引流站，大量返工；验证报告验了PRD质量没验方向对不对) → 优化:PRD验证加一轮"业务假设验证"，开工前用最小原型/访谈确认核心假设。Clover此坑已规避:7洞已做完业务存活验证
- 坑:DB约束与业务代码不同步+静默失败(CHECK约束拒绝新值，service的try-catch静默吞错，接口返200但没入库) → 优化:①service错误不能静默至少打error log ②DB枚举约束要有对应代码侧常量文件，schema变更lint能检测
- 坑:Agent"假设字段"联调时爆炸(yaml里type:object留空，前后端各自假设嵌套结构) → 优化:契约里type:object不能留空，冻结前所有嵌套object一级子字段必须定义；yaml里type:object没properties=契约未完成不许冻结
- 坑:临时调试文件堆积(6个test__tmp.js留仓库) → 优化:Stop Hook检查_tmp*文件打提醒；CLAUDE.md规定调试脚本带_tmp后缀+task完成由QA agent清理
- 坑: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空壳
- 启动包要提前备(不要启动当天临时生成)