baseline: Clover 独立仓库首次基线提交
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
58
开工引导.md
Normal file
58
开工引导.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# Clover 开工引导(新窗口第一份读这个)
|
||||
|
||||
> 这是开工窗口的入口卡。倩倩姐重开窗口、工作目录切到本目录(Clover/)后,把下面"开工第一句"贴给我即可。
|
||||
> 原则:靠文件不靠记忆——准备阶段所有决策都已落盘,新窗口读文件即可接上状态。
|
||||
|
||||
## 一、开工第一句(直接贴给 Claude Code)
|
||||
|
||||
```
|
||||
先读完本目录的 开工引导.md 全文(含生文生图通道配置),再读 ../progress.md 恢复项目状态,
|
||||
然后读 启动包/Agent编排开工prompt.md §3,按那份 goal 模式 prompt 启用 agent team 正式开工。
|
||||
开工前先跑编排prompt §1 validate 清单 + 本卡§二环境自检。配 AI 通道环境变量照本卡§三·补。
|
||||
```
|
||||
|
||||
## 二、新窗口开工前自检(30秒确认环境就绪)
|
||||
|
||||
- [ ] 工作目录 = 本目录(Clover/),不是上层
|
||||
- [ ] 本目录有 .claude/(门禁+rules+clover-loop 已铺,6文件)
|
||||
- [ ] `jq -r '.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS' .claude/settings.json` 返回 1
|
||||
- [ ] 全局 ~/.claude/settings.json 的 base_url = apiports.com(已修,子会话能连通)
|
||||
|
||||
## 三、关键事实(开工窗口必须知道,全已落盘细节见 progress.md)
|
||||
|
||||
- **模型**:全员 opus 4.8(倩倩姐拍板,质量优先不省钱)
|
||||
- **门禁已是真硬的**:之前 stdin 传参 bug 已修,实测能拦改 worker/banana/偷key/危险命令
|
||||
- **API中转已修**:废弃的 lvis.lol → apiports.com,子会话验证回"通了"
|
||||
- **5角色全栈并行·契约优先**:Lead先冻 启动包/API契约.md,BE/FE/AIE 再并行
|
||||
- **7个停下等倩倩姐拍板的点**:契约冻结/架构选型/质量标准/违禁词/可调prompt/验收/破红线
|
||||
- **铁律**:banana(`O2中间件平台/banana`)、worker(`万牛会L1准备/worker`)、产品包 = 只读复制不修改;key绝不进Celery;FERNET_KEY走环境变量
|
||||
|
||||
## 三·补 生文生图 AI 通道配置(倩倩姐2026-06-08拍板,开工配环境变量照此)
|
||||
|
||||
> 复用大卫 xhs-tool 同款双通道方案(`大卫/小红书系统图片定制/xhs-tool/.env`)。主备对调:apiports 为主、codeproxy 为备。
|
||||
> 🔴 key 绝不写进代码库/不进Celery,只配在环境变量;本卡只记脱敏指纹。
|
||||
|
||||
| 角色 | 站 url | key(脱敏,明文问倩倩姐或从大卫.env取) | 模型 |
|
||||
|------|--------|------------------|------|
|
||||
| **主通道** | `https://www.apiports.com`(出图端点 `/v1/api/generate`) | `CASH-lsIz…hKGp`(29位) | 出图 gpt-image-2 |
|
||||
| **备用通道** | `https://codeproxy.dev/v1` | `sk-4ba…0149`(67位) | 出图 gpt-image-2 |
|
||||
|
||||
- **生文 + 生图都走这套**,主用 apiports,备用 codeproxy(IMAGE_PROVIDER_PRIMARY/FALLBACK 配置,不写死代码)
|
||||
- **图片分析(gpt-5.5)两个站都能调,倩倩姐已验证** → 标杆分析/视觉理解不需要额外单独的视觉key
|
||||
- 出图模型统一 `gpt-image-2`(实测真实名,"image2"只是俗称);视觉 `gpt-5.5`
|
||||
- ⚠️ gpt-image-2 实测出过 502 → 开工必补"生图通道重试退避"(PRD-后端§已记)
|
||||
- 注意:此处 apiports 是**生图/生文通道**,与对话API的 apiports(全局settings那把CASH-8…du2G)是不同的key、不同用途,别混
|
||||
|
||||
## 四、读图顺序(新窗口按需深入)
|
||||
|
||||
1. `../progress.md` — 全过程+所有决策(最重要)
|
||||
2. `Clover架构方案.md` — v0.3 金标准(造什么)
|
||||
3. `启动包/API契约.md` — 唯一冻结契约(怎么对接)
|
||||
4. `启动包/Agent编排开工prompt.md` — 怎么拉起 agent team
|
||||
5. `启动包/角色卡/01~05` — 5个AI各自的岗位说明书
|
||||
6. `启动包/执行约束.md` — 12红线+关键节点
|
||||
7. `启动包/验收清单.md` — 三道验收线
|
||||
|
||||
## 五、本窗口(准备窗口)的角色
|
||||
|
||||
本窗口负责"准备+体检+决策",不写产品代码。开工后查"当初为啥这么定"看本窗口对话史 + progress.md;查"代码怎么来的"看开工窗口。
|
||||
Reference in New Issue
Block a user