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