6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
37 lines
3.4 KiB
Markdown
37 lines
3.4 KiB
Markdown
# 官网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空壳
|
||
- 启动包要提前备(不要启动当天临时生成)
|