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 批号） ☐ 商业目标明确（几年 × 多少钱） ☐ 至少 3 个核心使用场景 ☐ 至少 3 个典型用户画像
工具	`templates/0.基础调研.template.md` `templates/1.场景的补充.template.md` `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 每条假设都有可证伪定义 ☐ 7-9 章节骨架（含子章数量） ☐ KANO × JTBD × 场景四元素至少各占 1 章 ☐ 竞品清单（8-12 个）+ 三轴图谱
工具	`templates/2.VOC深度思路.template.md` `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 个关键词覆盖 ☐ P0 / P1 / P2 三级批次划分 ☐ 每批次可在 30-40 分钟内采完 ☐ 本品 + 头部竞品 + 长尾 + 场景四象限齐全
工具	`templates/3.采集矩阵.template.md` `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%） ☐ H1-H8 每条假设 ≥ 100 条证据 ☐ 总量 ≥ 2000 条（10 亿盘） / ≥ 1500 条（5000 万盘） ☐ audit.log 无 ERR 未处理
工具	`templates/collect.template.js` `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 占位 ☐ 每子章 ≥ 3 张 VOC 证据卡 ☐ 每条证据带平台 / 昵称 / IP / ♥点赞 / 原文 5 要素 ☐ 每个 slide 结尾有决策列表（落地动作） ☐ 无跳题 VOC（章节主题 × 证据内容必须一致） ☐ 子章 5 件套齐全（SectionHead + VOC 卡 + 结构化组件 + DecisionList + data-slide-num）
工具	`templates/analyze.template.js` `templates/components.template.js` `templates/render.template.js` `templates/chapter.template.js` `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 Stage 2 视觉升级（75→85）· BRAND 专属色板 + VOC 卡 3px 品类色左 border + InsightHero 渐变 Stage 3 细节升级（85→95）· 键盘导航 + Matrix 第 4 象限高亮 + DecisionList 动词化 P0-P3
门控	必过 20 条（见 `templates/aesthetic-checklist.template.md`）： ☐ 视觉语言 1-7 全过（三层背景 / 三层灰阶 / Mono 数字 / 字重跨度 / 8px 网格 / 圆角统一 / 品类色唯一） ☐ 结构布局 8-12 全过（100vh / Cover+Divider / Section 三段式 / strong 强调 / 模块 ≥ 3） ☐ 组件质量 13-17 ≥ 4/5 过（VOC 卡 border / flex 两端 / StatStrip Mono / Matrix 高亮 / DecisionList 动词化） ☐ 交互交付 18-20 全过（键盘导航 / 单文件无依赖 / 体积 300-1200 KB）
工具	`07-beautiful-html-aesthetics.md`（主方法论） `templates/aesthetic-patterns.template.js`（20+ 视觉模式） `templates/aesthetic-checklist.template.md`（20 条验收） `prompts/P6-aesthetic-upgrade.prompt.md`
典型耗时	2-4 小时（一次通刷 8 章）

Phase 6 · 质量 + 交付 Quality + Delivery

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

# <品类> 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

🛑 红线（绝对不能踩）

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

🎁 最小可运行原型（MVP）

任何新品类首次跑通必须确认：

--test 单关键词能跑通 → 生成 1 份 JSON（10-20 条）
--merge 能合并到 _merged.json
gen-<品类>.js 能生成 基础封面 + 至少 1 个章节（即使只有 placeholder）
reports/ 下 HTML 可在浏览器打开

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

📚 下一步

按顺序精读：

01-phase1-requirement-intake.md · 需求摄入
02-phase2-methodology-design.md · 方法论设计
03-phase3-collection-planning.md · 采集规划
04-phase4-collection-execution.md · 采集执行
05-phase5-analysis-rendering.md · 分析 + 渲染
06-phase6-quality-delivery.md · 质量 + 交付
⭐ 07-beautiful-html-aesthetics.md · 精美 HTML 方法论（跨阶段 P5/P6 横切）

00-workflow-overview.md 13 KB Постоянная ссылка История Исходник