售前大师 V1.0
一站式产出售前全流程交付物：售前方案书 → 产品PRD → 技术分析文档 → 流程图(draw.io) → 原型设计(HTML) → 标准版人天评估(Excel) → 报价清单(Excel) → 极简版一体化评估+报价(Excel) → 投标/标书响应（可选）。技能根据用户输入的业务背景、需求与已有材料，按规范格式生成全套可交付文件，并通过 scripts/ 脚本与 references/ 模板保证产出确定、格式稳定、跨会话可复现。
一、适用范围与边界（避免与其他 Skill 误用）
本 Skill 专攻交付物成套产出（含商务报价与人天评估）。若用户只需单点产物，优先用对应专项 Skill，避免重复劳动：
| 相似 Skill | 适用边界 | 何时用本 Skill 而非它 |
|---|---|---|
ori-ai-product-design |
产品原型 / 数据看板 / PPT 方案 | 需要连带商务报价、人天评估、方案书成套交付时 |
原型转PRD |
模糊需求 → PRD + 视觉原型 | 已有较清晰需求、要补技术方案/报价/流程图全套时 |
prd-to-design-doc |
PRD → 设计需求文档 + 流程图 | 需要继续产出人天评估、报价清单、投标材料时 |
一句话判断：只要需求里出现"报价/人天/投标/成套交付/背调/竞品分析"任一关键词，用本 Skill。
二、依赖与环境
| 依赖 | 用途 | 备注 |
|---|---|---|
Python 3（managed）+ openpyxl |
生成所有 .xlsx 交付物 |
脚本在 managed venv 运行；若未安装：python -m pip install openpyxl |
| draw.io / diagrams.net | 打开阶段4产出的 .drawio |
直接粘贴 XML 即可 |
| 原生 HTML/CSS/JS（无框架） | 阶段5原型 | 单文件，浏览器直接打开 |
| 无头浏览器（如 Playwright / Chromium headless） | 原型 0 JS 报错校验 | 每次原型产出后必跑（见阶段5与交付） |
运行脚本的统一约定：所有 .py 读取一个 JSON 数据文件（由本技能从 PRD 抽取后生成），输出 .xlsx 到当前工作目录。脚本内置 DEMO 数据，不传参也能跑通，便于先验证再替换。
# 标准版人天评估（11列分角色）
python scripts/gen_standard_estimate.py data_standard.json
# 极简版一体化（人天+报价+架构说明）
python scripts/gen_simple_estimate.py data_simple.json
# 报价清单（3 Sheet，基于标准版人天 JSON）
python scripts/gen_quote.py data_quote.json
三、能力矩阵（10 个能力）
| 能力 | 产出物 | 说明 | 适用场景 |
|---|---|---|---|
| 售前方案书 | .md |
面向客户决策层的整体解决方案 | 任何项目 |
| 产品PRD | .md |
详细功能定义、业务规则、数据模型 | 中大型项目 |
| 技术分析文档 | .md |
分层架构、核心设计、部署、风险 | 任何项目 |
| 流程图 | .drawio |
业务流程/系统架构/时序/部署/E-R | 可视化方案 |
| 原型设计 | .html |
单文件交互原型（Web+H5） | 客户演示 |
| 人天评估（标准版） | .xlsx |
11列：序号/模块/一级功能/二级功能/描述/设计/前端/后端/测试/总计/备注 | 中大型项目（20+人天），需角色拆分 |
| 报价清单 | .xlsx |
3 Sheet：报价清单 / 人天评估明细 / 交付清单 | 基于标准版人天评估生成 |
| 极简版一体化 | .xlsx |
一体化：阶段分组人天评估 + 报价 + 架构说明 | 小项目（<20人天），极简交付（替代 S6+S7） |
| 投标/标书响应 ★新增 | .md |
技术偏离表、RFP 应答、实施方案、竞品对比 | 招投标场景 |
| 公司背调报告 ★新增 | .html |
公司概况+业务版图+市场定位+竞品公司清单+对我方售前策略启示 | 投标准备/客户背调/竞品分析（用户提供公司名即触发） |
四、工作流程总览（含决策树与取数契约）
技能按"需求澄清 → 逐阶段产出 → 统一打包"执行。阶段间存在依赖，通常顺序推进，但按需跳过/局部补充。
需求澄清
├─ 是否仅补充某阶段？── 是 → 读取已有材料，仅补缺失阶段（跳过其余）
├─ 是否小项目(<20人天)且要极简？── 是 → 走 S8（跳过 S6/S7 标准版）
├─ 是否只需报价？── 是 → 有标准人天则 S7；否则先 S6 再 S7
├─ 是否投标场景？── 是 → 额外走 S9
├─ 是否提供了公司名要求背调/竞品分析？── 是 → 走 S10（独立产出背调报告，可先于 S1~S9 作为决策输入）
└─ 否则：S1 → S2 → S3 → S4 → S5 → S6 → S7 → (S9?) → (S10?) → 打包
阶段取数契约（每个阶段消费上一阶段的什么）
| 阶段 | 主要输入来源 | 抽取内容 |
|---|---|---|
| S1 方案书 | 用户需求 / 背景 | 行业、痛点、核心模块、ROI |
| S2 PRD | S1 + 用户需求 | 功能模块树、业务规则、数据实体 |
| S3 技术分析 | S2 PRD | 模块→技术实现、技术栈、部署、风险 |
| S4 流程图 | S2 + S3 | 角色/系统边界、流程节点、数据关系 |
| S5 原型 | S2 PRD | 页面清单、字段、交互 |
| S6 标准人天 | S2 PRD 功能模块 + S3 技术选型 | 工作项拆分、角色人天 |
| S7 报价 | S6 标准版人天 | 人天×单价、折扣、交付清单 |
| S8 极简版 | S2 PRD（轻量） | 阶段分组工作项、复用策略 |
| S9 投标 | S1~S3 + 招标文件 | 偏离项、应答、竞品对比 |
| S10 公司背调 | 用户提供的公司名 | 概况/业务/市场/竞品清单/售前启示（独立产出，也可作为 S1~S9 的决策输入） |
阶段0：需求澄清与材料收集（先假设，后标注）
目标：获取足够信息启动生产，但不反复追问。
阻断性信息（缺失会导致全盘重算，才提问）
- 项目类型：Web 系统 / AI-Agent 平台 / 数据中台 / 其他（决定技术栈与角色映射）
- 是否需要商务交付：要报价/人天吗？要标准版还是极简版？
- 预算量级 / 人天单价：如已知（如 ¥500/人天），直接用于报价
- 公司背调场景（★新增）：用户要求背调/竞品分析时，公司名称是必填阻断项。未提供公司名必须主动询问（如"请告诉我需要背调的公司全称，中英文均可"），不得自行编造。
可合理假设并在交付物顶部标注【假设】的项
- 项目名称（可用"XX行业智能平台"占位）
- 业务背景、目标客户画像
- 技术栈（默认：Web 用 Spring Boot + Vue；AI 用 Python + 大模型网关）
- 部署模式（默认私有化/云，二选一标注）
- 数据安全合规等级
> 原则：先用假设产出第一版，在每份文档开头用 > 【假设】xxx 标注；用户反馈后再局部修订，不整份重跑。
阶段1：售前方案书（.md）
结构：1.项目背景与需求分析 2.总体解决方案（架构概览+能力矩阵+差异化） 3.产品功能说明 4.技术方案总览 5.实施路径 6.服务与支持 7.商务概览（可选：交付物清单+人天总览）。
✅ 验收清单
- [ ] 含文档控制（版本/日期/编写人）
- [ ] 突出"差异化"与"ROI"两个卖点
- [ ] 有竞品对比（若有竞品信息）
- [ ] 篇幅 300–800 行（约 10–20 页）
阶段2：产品PRD（.md）
结构：1.文档控制（版本/日期/变更记录） 2.产品概述 3.功能架构 4.详细功能定义（按模块：功能列表/输入→处理→输出/业务规则/前后置条件/UI初描） 5.非功能性需求 6.数据模型 7.集成需求。
✅ 验收清单
- [ ] 每个功能模块含业务规则与约束
- [ ] 非功能性需求（性能/安全/可用性/扩展性）齐全
- [ ] 数据模型覆盖核心实体与字段
阶段3：技术分析文档（.md）
结构：1.文档概述 2.总体技术架构（分层+选型理由） 3.核心模块设计 4.数据架构 5.接口设计 6.部署架构 7.安全合规 8.风险分析与应对。
✅ 验收清单
- [ ] 技术选型有"为什么选"的决策逻辑，非仅列结果
- [ ] 数据安全/合规覆盖（客户数据、录音等敏感场景必写）
- [ ] 风险分析务实，不回避困难
阶段4：流程图设计（.drawio）
生成 draw.io XML。类型：业务流程图 / 系统架构图 / 时序图 / 部署架构图 / E-R 图。直接复用 references/sample_arch.drawio 骨架，改文字与连线即可，避免从零写 XML 出错。
绘制规范：泳道用 Swimlane；流程步骤用 Rectangle（圆角=开始/结束，直角=处理）；判断用菱形；箭头表方向。
颜色约定：蓝 #4A90D9 系统/平台能力；绿 #5CB85C 人工操作；橙 #F0AD4E 外部/第三方；灰 #D0D0D0 基础设施。
✅ 验收清单
- [ ] XML 可直接粘贴 diagrams.net 打开
- [ ] 关键路径与分支逻辑完整
- [ ] 颜色/泳道符合约定
阶段5：原型设计（.html）
单文件交互原型（Web+H5 双端）。复用 references/prototype_skeleton.html 骨架（含 function(id, el) Tab 切换范式、唯一 ID 前缀、模拟数据）。
技术规范：单文件（CSS/JS 内嵌）；Tab 切换用 function(id, el) 显式传参避免 event.target 冲突；ID 加模块前缀防冲突；Web(>1024px)/H5(<768px) 响应式；真实感模拟数据。
✅ 验收清单
- [ ] 核心页面（首页/核心功能）细化完整
- [ ] 基础交互（Tab/弹窗/表单校验）可用
- [ ] 无头浏览器跑通，0 JS 报错（必做，见交付）
- [ ] 文件 ≤ 2000 行，超则拆分
阶段6：标准版人天评估（.xlsx，分角色）
用脚本确定性生成：python scripts/gen_standard_estimate.py data_standard.json。JSON 结构见脚本头部注释。
11列表头：序号 | 模块 | 一级功能 | 二级功能 | 描述 | 设计 | 前端开发 | 后端开发 | 测试 | 总计 | 备注。
格式：模块标题行（合并、浅蓝 #D6E4F0、深蓝字 #1F4E79 加粗）→ 明细行（填人天）→ 模块小计行 → 角色汇总行（设计/前端/后端/测试/公共/总计）。
人天参考标准：
- 标准 CRUD：设计 0.5~1 + 前端 1~2 + 后端 1~3 + 测试 0.5~1
- 复杂逻辑：设计 1~2 + 前端 1~3 + 后端 2~5 + 测试 1~2
- AI/算法：设计 1~2 + 前端 0.5~1 + 后端 3~8 + 测试 1~2
- 数据对接/API：设计 0.5~1 + 前端 0~1 + 后端 1~4 + 测试 0.5~1
- 基础设施/架构：设计 1~3 + 前端 0~0.5 + 后端 2~5 + 测试 0.5~1
- 项目管理/公共：项目总人天 5%~10%
角色映射适配（★新增）：
| 项目类型 | 角色映射 |
|---------|---------|
| Web 系统 | 设计 / 前端 / 后端 / 测试 |
| AI-Agent 平台 | 算法/Prompt 工程（归入"后端/设计"列，备注说明）/ 前端 / 测试 |
| 纯数据/报表 | 数据开发（后端列）/ 前端 / 测试 |
✅ 验收清单
- [ ] 11 列表头与模板一致
- [ ] 模块标题/小计/汇总行配色与合并正确
- [ ] 合计数据（行总计=各角色和；角色汇总=各模块和）无误
阶段7：报价清单（.xlsx，3 Sheet）
用脚本确定性生成：python scripts/gen_quote.py data_quote.json。仅挂标准版人天（S6），不挂极简版。
- Sheet1 报价清单：序号 | 费用项 | 计算方式 | 金额(¥) | 折扣后(¥) | 说明。含软件开发费、部署实施费、技术文档费、培训费；必有报价小计、首期优惠（折扣）、最终报价（含税）。
- Sheet2 人天评估明细：由标准版人天 JSON 复用生成（浅蓝阶段标题、深蓝表头）。
- Sheet3 交付清单：序号 | 交付项 | 格式 | 说明（安装包/脚本/手册/指南/运维/培训/维保）。
配色：阶段标题 #D6E4F0/#1F4E79；表头 #1F4E79 白字；小计 #E8F0FE；优惠行 #FFF3CD 红字；最终报价 #D4EDDA 绿字大号。货币用 ¥ + 千分位。
✅ 验收清单
- [ ] 三 Sheet 齐全，含小计/优惠/最终报价
- [ ] 配色与合并符合要求
- [ ] 金额=人天×单价校验一致
阶段8：极简版一体化（.xlsx，小项目）
用脚本：python scripts/gen_simple_estimate.py data_simple.json。是 S6+S7 的合并替代：小项目（<20 人天、有可复用代码、预算有限）用此，跳过 S6/S7。
- Sheet1 人天评估明细：6 列（序号/工作项/工作内容说明/人天/小计¥/复用策略），按阶段分组（一、核心平台→二、场景适配→…），阶段标题浅蓝。每行标注复用策略（"✅ 已有完整Demo，直接迁移"等）。
- Sheet2 报价清单：同 S7 逻辑，但人天来源为简化版。
- Sheet3 架构说明（推荐）：精简对比表（传统 vs 极简）+ 极简技术栈表 + 交付清单表。
关键原则：通用引擎思维（规则引擎+AI网关共享）、最小化依赖（SQLite/原生启动/无容器）、场景即配置。
✅ 验收清单
- [ ] 阶段分组 + 复用策略标注完整
- [ ] 含报价与架构说明
- [ ] 总人天 < 20
阶段9：投标/标书响应（.md，★新增，可选）
当用户处于招投标场景时，在 S1~S3 基础上额外产出：
1. 技术偏离表：序号 | 招标要求 | 投标响应 | 偏离说明（正偏离/负偏离/满足）
2. RFP 应答：按招标文件章节逐条应答
3. 实施方案：人员组织、进度计划、质保期
4. 竞品对比模板：维度（功能/价格/案例/服务）对比表，突出我方优势
✅ 验收清单
- [ ] 偏离表覆盖招标关键条款
- [ ] 竞品对比有数据支撑，不空泛
阶段10：公司背调报告（.html，★用户提供公司名即触发）
当用户给出目标公司名称、要求背调/竞品分析时执行（典型场景：投标准备、售前摸底、竞品调研）。产出单文件 HTML 背调报告，核心必含竞品公司清单。可先于 S1~S9 作为决策输入，也可独立交付。
触发示例："帮我背调 XX 公司" / "调研一下 XX，列出它的竞品" / "投标准备，查一下招标方背景"。
信息采集（联网检索 + 多源交叉验证）
| 板块 | 采集内容 | 建议来源 |
|---|---|---|
| 工商信息 | 企业全称、成立时间、注册资本、法定代表人、总部城市、经营状态、经营范围 | 企查查/天眼查/爱企查公开页（经搜索引擎可达） |
| 业务版图 | 主营业务、产品/服务线、商业模式、典型客户与落地案例 | 官网、微信公众号、招聘 JD、新闻稿 |
| 经营与舆情 | 融资历程、股东背景、中标记录、司法风险、近期动态 | 行业新闻、中国政府采购网/招投标平台、公开裁判文书 |
| 市场定位 | 所处赛道、目标市场、规模体量、发展阶段与竞争地位 | 行业报告、媒体报道 |
| 竞品公司（★核心） | 同赛道直接竞品 ≥3 家，每家含：公司名/一句话简介/主营产品/目标客户/规模/与目标公司的关系 | 搜索"XX 竞品 / 同类产品 / 替代方案"、行业榜单、目标公司官网中的对标表述 |
检索纪律（必须遵守）
1. 关键事实至少 2 个独立来源交叉验证；无法验证的标注【待核实】。
2. 报告顶部必须标注信息采集日期（信息有时效性）。
3. 检索不到的板块如实写"未公开/未检索到"，严禁编造工商数据、融资数据与竞品名单。
4. 司法风险/负面舆情仅客观陈述公开事实并注明来源，不做定性指控。
5. 用 WebSearch 等联网工具逐板块检索；一次检索不充分时换关键词多轮补查（如"公司全称+工商"、"公司名+融资"、"公司名+中标"、"公司名+竞品"）。
报告结构（单文件 HTML，复用 references/company_report_skeleton.html）
- 报告头：目标公司名、采集日期、版本号、免责声明（信息仅来自公开渠道）
- 核心判断摘要：3~5 条结论先行（实力评估/竞争格局/与我方的机会）
- 公司概况：工商信息表 + 发展历程时间线
- 业务版图：产品/服务线矩阵 + 商业模式 + 典型客户
- 市场定位：赛道、体量、竞争地位（融资/中标记录佐证）
- 竞品公司清单（★核心章节）：竞品对比总表（公司名/简介/主营产品/目标客户/规模/相关度）+ 逐家简评（用原生
<details>展开即可，零 JS 依赖） - SWOT 与售前策略启示：优势/劣势/机会/威胁四象限 + 对我方的切入策略、差异化卖点、报价策略建议
- 信息来源附录：全部引用链接 + 检索日期
确定性生成（可选）：python scripts/gen_company_report.py "公司名称" 生成含【请填写】占位的报告骨架（纯标准库、无 JS）；调研完成后备好 data.json，python scripts/gen_company_report.py --data data.json 可一次性确定性产出完整报告。
✅ 验收清单
- [ ] 公司名称来自用户输入，未张冠李戴；工商信息经交叉验证
- [ ] 竞品公司清单 ≥3 家，每家含简介与对比维度
- [ ] 报告头有采集日期与免责声明，关键事实可溯源
- [ ] 含 SWOT 与面向售前动作的策略启示（不空泛）
- [ ] 单文件 HTML 无外部依赖，浏览器直接打开；无头浏览器 0 JS 报错
- [ ] present_files 交付
打包交付（必须 present_files）
所有产出物统一打包到 {项目名称}_售前交付物/：
{项目名称}_售前交付物/
├── 01_售前方案书.md
├── 02_产品PRD文档.md
├── 03_技术分析文档.md
├── 04_流程图/
│ ├── 业务流程图.drawio
│ ├── 系统架构图.drawio
│ └── 时序图.drawio
├── 05_原型设计/
│ ├── {项目}_Web原型.html
│ └── {项目}_H5原型.html
├── 06_{项目}_人天评估.xlsx (标准版)
├── 07_{项目}_报价清单.xlsx (基于标准版人天)
├── 08_{项目}_人天评估+报价_极简版.xlsx (小项目替代)
├── 09_投标响应/ (S9 投标场景)
└── 10_{公司名}_背调报告.html (S10 公司背调场景，可独立交付)
交付前检查清单
- [ ] 所有文件存在且非空
- [ ] 文档结构完整、无缺失章节
- [ ] 流程图 XML 可在 diagrams.net 打开
- [ ] 原型 HTML 无头浏览器实测 0 JS 报错
- [ ] 人天/报价 Excel 格式与模板一致、合计正确
- [ ] 文件命名规范（无空格/特殊字符）
最后必须调用 present_files 把全部产出物交付给用户（HTML 自动开预览面板），否则用户看不到结果。
用户交互指南
- 需求不清时：先假设产出第一版，交付时标注【假设】，不反复追问。
- 用户提供材料时：读取并采纳明确内容，缺失处合理补充并注释。
- 指定格式时：严格遵循；提到"参考模板"先读模板再匹配。
- 多轮迭代：局部修改而非整份重跑，保持已确认部分稳定。
- 所有产出物统一元信息：每份文档/Excel 顶部含版本号、生成日期、编写人（脚本自动写入日期）。
使用示例
示例1：新项目全流程（标准版）
输入："做一套美容门店AI智能体平台售前材料，面向连锁美容院，核心：录音质检、客户管理、AI话术推荐"
执行：S0 假设项目类型=AI-Agent→S1~S5 文档与图→S6 标准版人天（AI角色映射）→S7 报价→打包+present_files。
示例2：仅补某阶段
输入："我有方案书和PRD，补技术分析文档和人天评估"
执行：读取已有→S3→从 PRD 抽模块生成 S6→打包。
示例3：小项目极简版
输入："补胎照片质检Demo扩展成6场景Agent平台，小项目预算有限，已有Demo复用，¥500/人天，总价<1万"
执行：走 S8 极简版（跳过 S6/S7）→打包。
示例4：单独报价
输入："我有标准版人天评估JSON，生成报价，¥500/人天，20%折扣"
执行：python scripts/gen_quote.py data_quote.json →打包。
示例5：投标场景
输入："基于方案书，生成投标技术偏离表和竞品对比"
执行：S1~S3 已有→S9 投标响应→打包。
示例6：公司背调（含竞品清单）
输入："帮我背调一下 XX 科技有限公司，把它的竞品公司列出来"
执行：公司名确认（必填阻断项）→WebSearch 逐板块联网检索+交叉验证→复用 references/company_report_skeleton.html 生成 HTML 背调报告（含竞品对比总表+逐家简评+SWOT+售前策略启示）→无头浏览器 0 JS 报错→present_files 交付。
配套资源索引
scripts/common.py：共享样式与构建函数（被三个脚本复用）scripts/gen_standard_estimate.py：标准版 11 列人天评估scripts/gen_quote.py：报价清单 3 Sheetscripts/gen_simple_estimate.py：极简版一体化references/sample_arch.drawio：draw.io 架构图骨架（含泳道/配色）references/prototype_skeleton.html：单文件原型骨架（Tab 切换范式）references/fewshot_examples.md：真实片段样例（drawio/人天表/报价）references/company_report_skeleton.html：公司背调报告 HTML 骨架（含竞品对比总表/SWOT/来源附录结构）scripts/gen_company_report.py：公司背调报告生成器（骨架模式 / JSON 全量模式，纯标准库无依赖）
