跳转至

DLG-53 · MVP 启动：辅助工具 / 脚本 / 操作指南 / 协作规范

日期：2026-08-07 时长：约 1.5 小时 参与方：用户、听写（DT） 编号：DLG-20260807-53

一、用户需求

用户（SPO指令：

"请帮我启动mvp，提供所有的辅助工具，脚本，操作指南，协作规范。。。"

背景：团队共识 PPT 已于 DLG-51+ DLG-52 完成并发布；MVP 完成文档和线上部署完成后，用户希望立即进入 MVP Phase 0 实操落地，需要一次性给出所有辅助产物，把 MVP 实施方案（DOC-D00-M V1.0）落地为可操作的脚本、工具、一线操作规范。

二、工作过程

2.1 梳理 MVP 核心模块（基于 MVP实施方案.md）

重读 MVP V1.0 核心内容： - CPT-Lite 40 字段极简跟踪表 - QSV-Lite 15 字段极简报价表 - MDS-Lite 四库台账（WPL/CPL/SCL/BPL） - 8 阶段操作手册（L1~L8 每阶段：负责人/触发条件/核心动作/AI辅助/异常处理） - AI 协同工作规范（提炼→确认→入库→回传→记录） - 表单迭代机制（每周复盘→AI 迭代版本） - 四阶段演进路径（Phase 0 手工+AI → Phase 3 AI化）

2.2 盘点现有项目脚本

盘点 scripts/： 1. sync-docs-repo.ps1：公开文档仓同步 2. build-site.py：MkDocs 构建 3. deploy-site.ps1：Cloudflare Pages 部署 4. url_map.py：slug 映射 5. scripts/README.md V1.1

发现缺口： - ❌ MVP 导出 CSV 数据质量检查脚本 - ❌ 周报自动生成脚本（运营复盘用） - ❌ MVP 启动总览/辅助工具页面 - ❌ 一线随身版 Checklist - ❌ 纯前端报价计算器（不用起后端）

2.3 补齐 MVP 辅助脚本（2 个标准库 Python）

脚本 1：scripts/mvp-data-checker.py

功能： - --table cpt|qsv|wpl|cpl|scl|bpl 指定表类型 - 自动根据文件名猜测表类型（CPT/QSV） - 检查项： - 字段存在性（缺失列、额外列告警） - 逐行值校验：必填缺失 / 枚举非法 / 数值越界（NPS 0-10、工时 0.1-24h、金额 0-100000 HKD）/ order_id/quote_id 正则（ORD/QTE-YYYYMMDD-NNN） - 字段覆盖率统计 / Top 10 / 填充率<50% 字段告警 - CPT-Lite 业务摘要：订单数、阶段分布、完成率、NPS均值、工时均值、报价均值、线索来源、L6数据完整率 - 支持 --summary-only 和 --encoding 参数 - 退出码语义：0=全通过 / 1=参数错误 / 2=数据问题 - 纯标准库（csv/argparse/counter/re/datetime），零依赖

校验规则来源： - CPT-Lite 40 字段：MVP实施方案.md §3.2 - QSV-Lite 15 字段：MVP实施方案.md §3.3

脚本 2：scripts/mvp-weekly-report.py

功能： - 输入 --cpt CPT CSV + --qsv QSV CSV（可选） - 输出 6 章节 Markdown 周报： 1. 本周运营概览（7 指标表） 2. 阶段/线索/品类分布 3. 异常与风险单（异常状态/客诉/NPS≤6 低分层客户跟进清单） 4. 报价与品类洞察 5. 表单迭代建议（AI 草稿：采样率不足时自动提示、字段缺口） 6. 下周行动计划（OL/BO/TL/ML 各1项占位） - 默认输出路径：`发布/MVP周报-YYYYMMDD.md - 同样标准库零依赖

2.4 创建主交付物：发布/MVP启动辅助工具.html（总览页）

纯 HTML/CSS/JS + Mermaid CDN 单文件，可直接打开。章节：

  1. 🧭 快速导航（启动 5 步走） - 建表→台账→自动化→培训→首单
  2. 📋 §1 飞书多维表格字段清单（6 张表完整字段表）
  3. CPT-Lite 40 字段全表（阶段分类：GN / L1 / L2 / L3 / L4 / L5 / L6 / L7 / L8）
  4. QSV-Lite 15 字段
  5. MDS-Lite 四库台账字段速查
  6. 内嵌：mvp-data-checker.py 调用按钮提示
  7. 🧮 §2 MVP 报价计算器（纯前端）
  8. 8 参数输入（基础费/复杂度/楼宇/师傅等级/附加/折扣/封顶）
  9. 实时公式：subtotal = base × complexity × building × worker_level + extra → final = MIN( subtotal - discount, cap )
  10. 报价 JSON 草稿（含 note 封顶触发提示）
  11. 结果 HKD 千分位显示
  12. ✅ §3 8 阶段操作 Checklist（一线随身版）
  13. 8 张卡片，每个负责人 + 5-7 条 Checklist，对应 CPT-D L1~L8
  14. 🤝 §4 协作规范（MVP 期间严格执行）
  15. 工具使用规则 7 条（正确工具 vs ❌错误做法）
  16. 信息流 18 条（一线→上游 + 上游→一线）
  17. AI 协作规范 8 条（AI 辅助不替代、关键决策人把关、AI 产出须审查、AI 参与须标注）
  18. 数据与版本规则 5 条（唯一真实源、迭代版本号、50 字段上限、每周五导出、删字段 BO 确认）
  19. 🗺 §5 8 阶段流程图（Mermaid 实时渲染） - L1→L2→L3→L4→L5→L6→L7→L8，异常分支完整，CPT-D §2
  20. 🛠 §6 脚本使用速查 - 两脚本调用示例 + sync/build/deploy 复用说明
  21. 🚀 §7 上线首单 6 项 Checklist - 建表→台账→自动化→培训→脚本→首单

2.5 更新 scripts/README.md

脚本索引 V1.1→V1.2： - 脚本清单表新增 2 行（mvp-data-checker.py / mvp-weekly-report.py） - 新增 §5 MVP 辅助脚本 4 小节：5.1 适用范围 / 5.2 数据质量检查脚本调用 / 5.3 周报生成脚本 / 5.4 MVP 脚本协作流程（7 步：周一~周四录入→周五17:30导出→18:00 检查→18:10 周报生成→18:30 听写润色→19:00 群发→周一10:00 复盘迭代） - 修订记录：V1.2

三、产出物清单

# 产出物 路径 说明
1 数据质量检查脚本 scripts/mvp-data-checker.py MVP Phase 0 CSV 校验（CPT/QSV/WPL/CPL/SCL/BPL），460 行，纯标准库
2 周报自动生成脚本 scripts/mvp-weekly-report.py 6 章节 Markdown 周报生成，270 行，纯标准库
3 MVP 启动辅助工具总览页 发布/MVP启动辅助工具.html 8 大章节单文件，含字段清单、报价计算器、Checklist、协作规范、流程图、脚本速查、首单仪式
4 scripts/README 版本升级 scripts/README.md V1.2 新增 §5 MVP 辅助脚本详细使用说明 + 协作流程
5 工作日志 本文件 DLG-53 记录 MVP 启动全过程

四、验证与验证结果

语法验证： - ✅ python -c "import py_compile; py_compile.compile('scripts/mvp-data-checker.py', doraise=True); print('OK')" → OK - ✅ python -c "import py_compile; py_compile.compile('scripts/mvp-weekly-report.py', doraise=True); print('OK')" → OK

字段校验脚本的自测预期（空表场景，无 CSV 时）： - 两个脚本都已通过 --help 参数自检

五、关键决策

  1. 脚本零第三方依赖：mvp-*.py 只用标准库，避免 pip install 失败风险，一线 OL/TL 任何人可直接运行。
  2. MVP 总览页做成单文件 HTML：不用起后端、不用 MkDocs，双击即用，适合线下传播与培训投屏。
  3. 报价计算器内嵌 HTML 内联 JS：不依赖服务器，复制 URL 发团队群即可共享使用。
  4. *Checklist 采用卡片网格 38 张卡片 × 7 条：一线人员一眼看到自己 L1~L8。
  5. **协作规范 7+18+8+5 = 38 条：覆盖工具/信息流/AI/版本规则，全场景覆盖。
  6. **周报自动 6 章固定结构：听写每周五 18:30 准时基于此润色，结构一致便于历史对比。

六、待办事项（Next Actions）

# 事项 负责人 截止
N1 按 §1 字段清单实际创建飞书多维表格 WEAVELY-MVP（6 张表） OL 成文 2026-08-08
N2 WPL 录入 ≥3 位师傅、CPL ≥5 位客户、SCL ≥5 品类、BPL ≥5 楼宇（台账种子） OL/ML 2026-08-08
N3 配置飞书自动化：新订单提醒、阶段变更、超时预警 TL 司徒 2026-08-09
N4 全员培训 2 小时：8 阶段 Checklist + §4 协作规范 + 模拟走单 SPO 广 2026-08-09
N5 启动首单，跑通 L1→L8 全流程，运行 data-checker OL 2026-08-10
N6 生成首周（或首 N 单）周报：运行 mvp-weekly-report.py → 听写润色 → 发全员 TL/ML 首周周五 18:00
N7 表单迭代 V1.0→V1.1（基于首单字段缺口复盘） TL/PO 次周周一

七、附件与引用