Files

yangqianqian 6a2632da70 baseline: Clover 独立仓库首次基线提交

将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。
当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包),
M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-16 11:30:22 +08:00

6.6 KiB

Raw Permalink Blame History

Clover 执行约束（板块5 · agent 开工铁律总册）

用途：开工后 agent 随时可查的唯一约束总册。散在 CLAUDE.md/PRD/角色卡的硬约束在此汇总，违反即返工。优先级：本册 = 架构方案v0.3 + CLAUDE.md 的执行态投影，冲突以架构方案v0.3为准。

0. 建法铁律（最高优先级·防"打补丁循环"）

2026-06-08 补：开工后出现"反复打补丁、报完成却离验收线很远"的问题。根因=横向建设（先造全部零件最后拼）+ "完成"定义错位。以下三条凌驾于一切施工节奏之上。

G1 · 纵切片优先，禁止横向铺零件

第一目标是用最丑的方式打通端到端一条龙：一个产品 → 一条文案 + 一张图 → 提审 → 组长过 → 下载一个达人素材包，北哥能从登录点到下载全程跑通。
这条"最小一条龙"没有真跑通之前，禁止去精修/加深任何单个功能模块（不许先把文案做到5轨、不许先把生图并发做到8张、不许先美化界面）。
先打通主动脉，再回头一段一段加深。难看不要紧，断掉才要命。

G2 · "完成"的唯一定义 = 验收清单某一项真的勾上了

禁止把"我写完这块代码/这个接口通了"当作"完成"上报。
每次说"完成"，必须对应到 验收清单.md 里具体哪一项打勾（如"1A第3项：task_id入队抓包确认无明文key ✅"）。
报告格式：完成了【验收清单X项】，证据是【可验证的事实】。说不出对应验收项 = 不算完成。

G3 · 验收清单当"每日持续门禁"，不是收尾才跑

验收清单.md 第一道线（1A生产链13项）从开工第一天就是进度标尺，每个阶段结束自问："这一步让我多勾上了哪一项？还是只是码更多了？"
一个阶段结束若一项验收都没新勾上 → 立即停下报 Lead，这是方向跑偏的早警信号（对接§3撞墙规则）。

判据：倩倩姐/北哥看进度，问的是"到端到端一条龙走通还差几步"，不是"还要补几个洞"。补洞式回答 = 踩中本节反模式。

1. 不可违反的红线（违反即返工）

#	红线	来源
R1	不动 banana/产品包/worker 源目录，只读复制重写（Hooks 已工具层拦截）	CLAUDE.md铁律
R2	不边盖边修，Clover 全新独立项目	CLAUDE.md铁律
R3	API Key 绝不进 Celery 参数/不落盘/不打日志，只传 task_id	基石B
R4	FERNET_KEY 走环境变量，绝不进代码库	基石B
R5	所有查询强制带 workspace_id；写操作+切workspace查 membership	基石C
R6	业务参数不写死（品类/数量/角度），看似枚举的→做成数据	基石A
R7	前端不展示 Token 余额、不做积分页	CLAUDE.md前端红线
R8	不做自动发布小红书，只到确认预览	CLAUDE.md
R9	不接 banana 假评分，eval_score 留 NULL	架构方案
R10	内容"评分高"≠"质量过关"，必须过北哥抽检才 human_passed	倩倩姐拍板
R11	新建/编辑文件不超 100 行	CLAUDE.md约束
R12	契约 type:object 不许留空，一级子字段必须定义	官网V1坑4

2. 北哥抽检 SOP（质量过关的人工闸）

机器门禁过 → 进抽检队列 → 北哥抽检 → 回写标准。这是"质量过关"的落地。

步骤	操作	输入	输出	执行者
1	机器层过滤	生成的文案/图	machine_passed 样本包	AIE（自动）
2	抽样打包	machine_passed 样本	抽检样本包（含五维分+角度标签）	clover-loop P4（自动）
3	北哥抽检	样本包	每条 approve/reject + 理由	北哥（人工）
4	标准回写	北哥的判断	更新违禁词库/可调prompt/打回原因	AIE（喂飞轮）
5	结晶	通过的标准	沉淀进产品档案 custom_prompt	Lead

抽检判据（北哥关注，AI 先标记）：

同质化：5 条文案是否雷同（正文/开头签名去重已机器做，北哥看"读起来像不像一个人写的复读机"）
跑偏：图是否改了产品包装/换了产品（机器锚点已防，北哥看细节）
像不像素人分享：是不是一眼假的硬广

抽检频率：开放测试初期每批都看（喂飞轮最密），AI 学会后降到抽样。

3. 撞墙与 Pivot 规则

逆向项目血泪：撞墙3次还在原地换参数 = 在错误的层做对的事。

同一层（同一个错误来源）连续失败 2 次 → 强制 Pivot：换思路/换层，不许再调参数。
Pivot 记入 clover-loop 状态机 pivots[]，说明换了什么层、为什么。
Pivot 后仍不过 → status=blocked，停循环，结构化报告请北哥/倩倩姐介入。
北哥不耐烦 / 连续否决同方向 = 路径选错了层的信号，立即 Pivot，不要再调一次参数。
- 第1次否决 = 这一版不行
- 第2次否决 = 假设可能错了
- 第3次否决 = 当前层不对，必须换层（不是再改措辞）

4. 文件与协作约束

新建文件 ≤ 100 行；超出先建框架再 Edit 补充。单次 Edit ≤ 100 行。
临时调试文件带 _tmp 后缀，任务完成由 QA agent 清理（Hooks 已提醒）。
P0 模块开工前必须有 plan，无 plan 不开工（Lead 检查项）。
每个工作阶段结束写 standup 自我披露（文件清单/TODO/已知bug/契约不一致）。
agent 任务完成立即 shutdown 省 token（Aggressive Cleanup）。
契约变更必须先通知所有受影响 agent 再改，不擅自改字段。
service 错误不许静默吞，至少打 error log。

5. 关键节点确认清单（必须停下来等人拍板）

承接北哥心法"关键节点确认，小事自解决，解决不了来问"。以下节点 agent 不许自作主张：

节点	谁拍板	为什么
API 契约冻结	Lead → 倩倩姐知会	地基，错了全返工
架构/技术栈偏离架构方案v0.3	倩倩姐	golden standard 不许 agent 推翻
内容质量标准（什么算好文案/好图）	北哥	质量责任在北哥，AI 不替判
违禁词库批量导入	北哥（合规标准）	合规红线
可调 prompt 的具体内容	北哥方案	同质化优化等北哥方案
1A/1B 验收是否通过	Lead 跑机器线 + 北哥认可	三道验收线
任何红线（§1）的破例	倩倩姐	红线即返工线

其余（命名/格式/默认值/等价方案选择）agent 自行决定并在 standup 说明，不必等。

6.6 KiB Raw Permalink Blame History Unescape Escape