# 00 · 闭环工作流总览

> 6 阶段 + 精美升级横切 × 门控清单 × 状态追踪 × 回路反馈

---

## 🎯 闭环图

```
                    ┌────────────────────────────────────────┐
                    │                                        │
                    │   [P6 质量交付]  ←──── REGRESSION      │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [⭐ P5+ 精美升级]←─ 20 条 checklist  │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [P5 分析渲染]  ←──── gap 发现         │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [P4 采集执行]  ←──── 补采矩阵         │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [P3 采集规划]            │           │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [P2 方法论设计]           │           │
                    │        ↑                   │           │
                    │        │                   │           │
                    │   [P1 需求摄入]  ←─── 需求变更          │
                    │                                        │
                    └────────────────────────────────────────┘
                                                  
                      ↓ 正向推进（默认路径）
                      ↑ 反向回滚（发现问题时）
```

核心思路：**前 3 阶段是准备（纸上）**，**后 3 阶段是交付（代码 + 数据 + 报告）**，**P5+ 精美升级是跨 P5/P6 的横切关注点**（把"能跑"的 60 分报告升级到"可发路演"的 95 分）。每个阶段都有**入口门控**（不通过不能进）+ **出口验收**（不达标不能出）。

---

## 📋 6 阶段 × 门控清单

### Phase 1 · 需求摄入 Requirement Intake

| 项 | 内容 |
|---|---|
| **目标** | 把客户/产品方的口头需求 → 结构化的 4 份 markdown |
| **输入** | 客户原话 / 产品资料 / 业务目标（收入、GMV、人群） |
| **输出** | `0.基础调研.md` + `1.场景的补充.md` |
| **门控** | ☐ 产品力有**可量化差异点**（真原料 / 特殊工艺 / OTC 批号）<br/>☐ **商业目标**明确（几年 × 多少钱）<br/>☐ 至少 **3 个核心使用场景**<br/>☐ 至少 **3 个典型用户画像** |
| **工具** | `templates/0.基础调研.template.md`<br/>`templates/1.场景的补充.template.md`<br/>`prompts/P1-kickoff.prompt.md` |
| **典型耗时** | 2-4 小时（AI 辅助）/ 1-2 天（人工） |

### Phase 2 · 方法论设计 Methodology Design

| 项 | 内容 |
|---|---|
| **目标** | 从业务目标 → **H1-H8 八大假设**（VOC 要验证的命题）+ 章节骨架 |
| **输入** | P1 的 2 份 markdown |
| **输出** | `2.VOC深度思路.md`（含章节骨架 + 假设定义 + 双视角框架） |
| **门控** | ☐ **H1-H8 每条假设**都有可证伪定义<br/>☐ **7-9 章节**骨架（含子章数量）<br/>☐ **KANO × JTBD × 场景四元素**至少各占 1 章<br/>☐ **竞品清单**（8-12 个）+ 三轴图谱 |
| **工具** | `templates/2.VOC深度思路.template.md`<br/>`prompts/P2-methodology.prompt.md` |
| **典型耗时** | 1-2 小时 |

### Phase 3 · 采集规划 Collection Planning

| 项 | 内容 |
|---|---|
| **目标** | 从 H1-H8 假设 → **具体关键词 × 平台 × 批次**矩阵 |
| **输入** | P2 的 VOC 思路文档 |
| **输出** | `3.采集矩阵.md`（30-50 关键词 × 2-3 批次 × 2-6 平台） |
| **门控** | ☐ 每条 H 假设都有 **≥ 3 个关键词**覆盖<br/>☐ **P0 / P1 / P2 三级**批次划分<br/>☐ 每批次可在 **30-40 分钟**内采完<br/>☐ **本品 + 头部竞品 + 长尾 + 场景**四象限齐全 |
| **工具** | `templates/3.采集矩阵.template.md`<br/>`prompts/P3-collection.prompt.md` |
| **典型耗时** | 1-2 小时 |

### Phase 4 · 采集执行 Collection Execution

| 项 | 内容 |
|---|---|
| **目标** | 真实 API 调用 + 数据归一化 + 重复去除 + 假设打标 |
| **输入** | P3 采集矩阵 |
| **输出** | `docs/<品类>/raw/xhs/*.json` + `douyin/*.json` + `_merged.json`（1500-8000 条统一格式） |
| **门控** | ☐ 每个 kw 至少 **40-100 条真实评论**（seed 不超 10%）<br/>☐ H1-H8 **每条假设 ≥ 100 条证据**<br/>☐ 总量 **≥ 2000 条**（10 亿盘） / **≥ 1500 条**（5000 万盘）<br/>☐ **audit.log** 无 ERR 未处理 |
| **工具** | `templates/collect.template.js`<br/>`prompts/P4-analysis.prompt.md` |
| **典型耗时** | 50-120 分钟（主要等 API + 重试） |

### Phase 5 · 分析渲染 Analysis + Rendering

| 项 | 内容 |
|---|---|
| **目标** | `_merged.json` → 8 章 × 28-42 子章 × HTML |
| **输入** | `_merged.json` |
| **输出** | `reports/<品类>-voc-insight-report.html`（400-750 KB） |
| **门控** | ☐ **0 个 Coming Soon 占位**<br/>☐ 每子章 **≥ 3 张 VOC 证据卡**<br/>☐ 每条证据带 **平台 / 昵称 / IP / ♥点赞 / 原文** 5 要素<br/>☐ 每个 slide 结尾有 **决策列表**（落地动作）<br/>☐ 无**跳题 VOC**（章节主题 × 证据内容必须一致）<br/>☐ 子章 **5 件套齐全**（SectionHead + VOC 卡 + 结构化组件 + DecisionList + data-slide-num） |
| **工具** | `templates/analyze.template.js`<br/>`templates/components.template.js`<br/>`templates/render.template.js`<br/>`templates/chapter.template.js`<br/>`prompts/P5-rendering.prompt.md` |
| **典型耗时** | 4-8 小时（8 章 × 30-60 分钟/章） |
| **出场水平** | 60-75 分（能跑，但视觉上还没达到交付标准）→ 进入 P5+ 精美升级 |

### ⭐ Phase 5+ · 精美升级 Aesthetic Upgrade（跨阶段 · 横切关注点）

| 项 | 内容 |
|---|---|
| **目标** | 把 P5 产出的 60-75 分报告升级到 **90+ 分（可直发投资路演 / 董事会）** |
| **输入** | P5 初版 HTML |
| **输出** | 同一个 HTML 文件（打磨版 · 视觉系统 + 交互 + 细节） |
| **三阶段** | **Stage 1** 结构升级（60→75）· SectionHead 三段式 + 视觉模块 ≥ 3 + 数字 Mono<br/>**Stage 2** 视觉升级（75→85）· BRAND 专属色板 + VOC 卡 3px 品类色左 border + InsightHero 渐变<br/>**Stage 3** 细节升级（85→95）· 键盘导航 + Matrix 第 4 象限高亮 + DecisionList 动词化 P0-P3 |
| **门控** | **必过 20 条**（见 `templates/aesthetic-checklist.template.md`）：<br/>☐ 视觉语言 1-7 **全过**（三层背景 / 三层灰阶 / Mono 数字 / 字重跨度 / 8px 网格 / 圆角统一 / 品类色唯一）<br/>☐ 结构布局 8-12 **全过**（100vh / Cover+Divider / Section 三段式 / strong 强调 / 模块 ≥ 3）<br/>☐ 组件质量 13-17 **≥ 4/5 过**（VOC 卡 border / flex 两端 / StatStrip Mono / Matrix 高亮 / DecisionList 动词化）<br/>☐ 交互交付 18-20 **全过**（键盘导航 / 单文件无依赖 / 体积 300-1200 KB） |
| **工具** | `07-beautiful-html-aesthetics.md`（主方法论）<br/>`templates/aesthetic-patterns.template.js`（20+ 视觉模式）<br/>`templates/aesthetic-checklist.template.md`（20 条验收）<br/>`prompts/P6-aesthetic-upgrade.prompt.md` |
| **典型耗时** | 2-4 小时（一次通刷 8 章） |

### Phase 6 · 质量 + 交付 Quality + Delivery

| 项 | 内容 |
|---|---|
| **目标** | 自动化审计 + 人工复审 + 执行摘要 + 交接 |
| **输入** | P5 的 HTML 报告 |
| **输出** | 审计报告 + `4.采集执行摘要.md` + 浏览器预览 |
| **门控** | ☐ `_audit-<品类>-voc.js` 全部绿色<br/>☐ HTML 大小 **≥ 400 KB**（内容饱满）<br/>☐ 大小 **≤ 800 KB**（不冗余）<br/>☐ 每章至少 **1 个决策矩阵 / 表格 / 图表**（不能全是文字卡）<br/>☐ 封面统计数字与 `_merged.json` 一致 |
| **工具** | `templates/audit.template.js`<br/>`templates/4.采集执行摘要.template.md` |
| **典型耗时** | 1-2 小时 |

---

## 🔁 反向回路（常见场景）

### 场景 A · P5 发现 VOC 不足
**症状**：某子章找不到足够证据 / evidence top=3 里有 2 条跳题  
**回路**：回到 P3 加关键词 → 跑 P4 `--batch=4 补采` → 回 P5 继续

### 场景 B · P6 审计发现假设覆盖 < 100
**症状**：H6 包装 VOC 只有 50 条  
**回路**：回到 P3 加包装相关关键词（包装、颜值、独立装）→ P4 重跑 → P5 重生成 → P6 重审

### 场景 C · 客户补充需求变更定位
**症状**：中途客户发现人群优先级需要调整  
**回路**：改 `1.场景的补充.md` → 改 `2.VOC深度思路.md` H2/H3 → 检查是否需要补采 → P5 重新渲染相关章节

### 场景 D · 发现某条关键 VOC 证据失真（纯表情 / 水评论）
**症状**：某 VOC 卡只有"[笑哭][笑哭]"  
**回路**：加强 `analyze.js` 的 `isSubstantive()` 过滤 → P5 重生成所有章节

### 场景 E · P5+ 精美审计红灯
**症状**：checklist 20 条过了 < 15 条（< 75 分）  
**回路**：看哪类失分 → 参照 `07-beautiful-html-aesthetics.md` 对应章节 → 从 `aesthetic-patterns.template.js` 复制对应视觉模式 → 重生成

**典型失分归因**：
- 失分在 1-7（视觉语言）→ 改 `components.js` 的 BRAND + CSS 变量
- 失分在 8-12（结构）→ 每章 `renderSub*` 补 SectionHead + 视觉模块
- 失分在 13-17（组件）→ 统一 VOC 卡 / StatStrip / Matrix 纪律
- 失分在 18-20（交互）→ 改 `render.js` 的 NAV_JS + 加 PageIndicator

---

## 📊 状态追踪（单项目）

建议在每个项目根目录维护一份 `STATUS.md`：

```markdown
# <品类> VOC 项目状态

| 阶段 | 状态 | 起始 | 完成 | 负责 |
|---|---|---|---|---|
| P1 需求摄入 | ✅ Done | 04-18 | 04-18 | AI |
| P2 方法论设计 | ✅ Done | 04-18 | 04-19 | AI |
| P3 采集规划 | ✅ Done | 04-19 | 04-19 | AI |
| P4 采集执行 | ✅ Done | 04-19 | 04-20 | AI |
| P5 分析渲染 | 🔄 60% | 04-20 | — | AI |
| ⭐ P5+ 精美升级 | ⏳ | — | — | — |
| P6 质量交付 | ⏳ | — | — | — |

## 当前阻塞
- 无

## 最近决策
- 2026-04-19 决定把决策链从"本人"升级为"家长×儿童双引擎"
- 2026-04-20 从 Batch 2 中发现 H6 包装假设覆盖不足，追加 Batch 3
```

---

## 🛑 红线（绝对不能踩）

1. **不得用 seed/模拟/mock 数据冒充真实 VOC** —— 凡是 `seedFallback` 必须在报告顶部标红提示
2. **不得在报告里出现"据说""听说""行业分析"等无证据表述** —— 每条结论必溯源
3. **不得跳过 P4 审计直接渲染** —— `audit.log` 有 ERR 必须处理
4. **不得在单个 chapter.js 超过 700 行** —— 超过就拆子章模块
5. **不得在 H1-H8 任一假设 < 100 条证据时交付** —— 不足就补采或放弃该假设
6. ⭐ **不得跳过 P5+ 精美升级直接交付** —— P5 初版只能到 60-75 分，必须过 20 条 aesthetic-checklist 才能进 P6
7. ⭐ **不得引入外部 CSS/JS 依赖** —— 所有 CDN 字体 / 图标库 / 图表库一律禁用，单文件 HTML 是交付纪律
8. ⭐ **不得让多个品类报告看起来像同一份改了色** —— BRAND 色板必须品类专属（避开竞品主色 + LAB 距离 ≥ 30）

---

## 🎁 最小可运行原型（MVP）

**任何新品类首次跑通必须确认**：
1. `--test` 单关键词能跑通 → 生成 1 份 JSON（10-20 条）
2. `--merge` 能合并到 `_merged.json`
3. `gen-<品类>.js` 能生成 **基础封面 + 至少 1 个章节**（即使只有 placeholder）
4. `reports/` 下 HTML 可在浏览器打开

**确认 MVP 通了再继续扩展采集矩阵和章节数量**。这是为了避免卡在某个 API 报错或者章节渲染 bug 上浪费整天。

---

## 📚 下一步

**按顺序精读**：
1. [`01-phase1-requirement-intake.md`](./01-phase1-requirement-intake.md) · 需求摄入
2. [`02-phase2-methodology-design.md`](./02-phase2-methodology-design.md) · 方法论设计
3. [`03-phase3-collection-planning.md`](./03-phase3-collection-planning.md) · 采集规划
4. [`04-phase4-collection-execution.md`](./04-phase4-collection-execution.md) · 采集执行
5. [`05-phase5-analysis-rendering.md`](./05-phase5-analysis-rendering.md) · 分析 + 渲染
6. [`06-phase6-quality-delivery.md`](./06-phase6-quality-delivery.md) · 质量 + 交付
7. ⭐ [`07-beautiful-html-aesthetics.md`](./07-beautiful-html-aesthetics.md) · 精美 HTML 方法论（跨阶段 P5/P6 横切）