visit-report-designer — 拜访报告设计器（长松品牌诊断报告）
> 把一份干净的拜访文本，变成客户愿意看、看完想成交的诊断报告。
> 开放在「抽取」，约束在「合规」：卡点怎么总结 AI 说了算，但数据必须真、不能编、不承诺效果。
0. 输入与前置
- 输入：已解析的拜访文本（来自
visit-input-parser，或用户直接粘贴）。若用户给的是原始录音 / 文档，先调visit-input-parser解析成文字，再继续。 - 必需附带：销售本人的专属顾问信息（姓名 / 职务 / 联系方式 / 微信二维码图）——材料里没有，P3 专属顾问槽位必需。未提供则先生成主体、顾问槽位留占位并提示补完。
- 长松智库检索（内置，默认必走）：通过
ima-mcp连接器检索共享库「长松智库」(id7461959758803066，954 条 / 3.2GB，长松咨询创建，聚焦组织/财务/营销/战略四大系统 + 股权/执行)。本 skill 已内置检索逻辑，运行时所在账号需已授权ima-mcp连接器即可自动检索；连接器状态可能显示 disconnected 但实测可调；勿用~/.config/ima直连 HTTP 凭证（7/3 写入已过期 401）。
1. 核心原则：开放抽取（不是清单填空）
| ❌ 不这么做 | ✅ 这么做 |
|---|---|
| 预设 6 维 → 固定问题清单 → 固定检索词 | 拿到文本 → 自己理解 → 自己总结卡点（数量自定，通常 2–5） |
| 卡点维度、关键词、搜索次数写死 | 每个卡点自生成搜索关键词；是否连续搜索自己定 |
| 模板里硬塞某家客户的固定故事 | 模板只留空插槽，具体词/数/故事全由抽取产出 |
为什么必须开放：客户千差万别，写死清单会①漏掉真实问题②硬塞不相关维度，反而显得不专业。AI 应像顾问一样先「听懂」再「开方」。
但开放不等于无约束——每个抽取的卡点都必须：
1. 归属到 6 维之一（用于检索路由，见 §3）
2. 配客户原话佐证（被听见感，模板 P2 痛点块强制要求）
3. 匹配至少一个解决方案 + 交付与周期（痛点 ↔ 方案一一对应）
2. 工作流（6 步）
Step 1 · 解析与全景理解
- 通读输入文本，建立「客户现状认知」：行业属性、企业规模、老板当前关注点、痛点信号、组织发展阶段。
- 输出一段内部「客户全景摘要」（不进报告，仅供后续步骤路由）。
Step 2 · 开放抽取卡点
- 基于 Step 1 理解，自行归纳 N 个卡点（N 自定，通常 2–5）。
- 每个卡点对象含：
标题（一句话）客户原话佐证（来自输入文本的真实原话，必须可追溯）展开描述（问题表现、影响）维度归属（组织/财务/营销/战略/执行/股权 之一，用于 Step 3 路由）表象问题与根因的初步判断（供 P2 根因推导）
Step 3 · 动态检索长松智库
- 对每个卡点：基于其语义自生成 1–3 个中文检索关键词（不写死）。
- 调
ima-mcp：search_knowledge(knowledge_base_id="7461959758803066", query=<关键词>)。 - 命中内容不足以支撑方案时，自行换词续搜（是否连续搜索 AI 自定）。
- 摘录可溯源的方法论 / 方案 / 案例片段，标注出处（库内文件夹或资料名）。
Step 4 · 匹配方案与步骤
- 每个卡点：从 Step 3 命中内容中提炼
解决方案名称（必须是客户生意结果语言，去课名化：如「理顺合伙分钱，招的人不会中途翻脸」，而非「动态股权精华班」）交付与周期（对应模板 P3 方案卡）- ⚠️ 去课名化 + 去溯源 clutter 硬规则：方案卡的
.nm与.ds必须站在「客户能得到什么」写；长松的方法论 / 资料名不得在客户端报告中以内联文件名形式出现。检索结果用于支撑方案设计，但溯源信息只在 AI 内部保留；报告以专业建议形态呈现，否则客户会莫名其妙、像看内部文件清单。 - 强制保证「卡点 ↔ 方案」一一对应（模板 P3 已设计为对应结构）。
Step 5 · 套模板填充
- 读取本 skill 自带的
templates/诊断报告模板.html（与 SKILL.md 同目录下的 templates/）。 - 替换静态占位符（见 §6.1）。
- 动态循环块（
.pain/.sol .card/.acts .a）按 N 复制填充（见 §6.2）。 - 执行 §4 合规校验，不通过则回退补全（尤其是评分、案例数据、原话真实性）。
Step 6 · 交付（必须输出一张可保存的 JPEG 图片，约 300–500KB）
- 最终交付物是一张图片——销售要发给客户/发到微信群，必须能直接保存，而不是 HTML 源码或仅能在预览面板打开的页面。
- 正确交付流程：
1. 将 Step 5 填充后的完整 HTML 写入本地中间文件：<workspace>/dist/诊断报告_<客户缩写>_<YYYYMMDD>.html。
2. 调用本 skill 自带渲染器render_report.py，把 HTML 转成 1.5x 清晰度的 JPEG 图片（体积约 300–500KB，专为小程序 base64 内联优化，避免「加载失败」）：python render_report.py <html路径> <jpg路径>- 渲染脚本与
SKILL.md同目录，依赖playwright+Pillow+ Chromium，详见 §9 环境依赖。 - 输出的是一张拼合 3 页报告的高清长图（如 1191×5162 的 JPEG，约 300–500KB），可直接保存、发送、发朋友圈。
- 体积约束（重要）：WorkBuddy 小程序端以 base64 内联图片，>1MB 极易「加载失败」。务必保证输出 < 600KB；若卡片内容过多导致超限，优先调低第 4 个参数
quality（如 70）或第 3 个参数scale（如 1.2），不要让体积回到 2MB 级。
3. 调用present_files工具展示该 JPEG 图片。
4. 将 JPEG 图片路径告知用户，说明「这是一张可保存的图片」。HTML 作为源文件可一并保留，但对外发送以 JPEG 为准。
- 若当前环境没有安装 Playwright/Chromium/Pillow，生成图片失败：先把 HTML 文件写入并告知用户，同时说明「环境缺少渲染引擎，需安装
playwright+playwright install chromium+pip install pillow后才能出图」。
3. 长松智库检索约定（6 维路由）
| 维度 | 检索路由关键词族（AI 自生成，示例非穷举） |
|---|---|
| 组织 | 架构 / 人才 / 晋升 / 干部培养 / 组织系统 |
| 财务 | 利润 / 成本 / 税务 / 老板财务通 |
| 营销 | 获客 / 品牌 / 销售平台 / 营销模式 |
| 战略 | 目标规划 / 增长引擎 / 战略清晰 |
| 执行 | 目标落地 / 流程 / 复盘 |
| 股权 | 股权设计 / 激励 / 分钱机制 |
检索纪律：
- 关键词由 AI 基于卡点动态生成，不写死清单。
- 凡引用智库的具体数据 / 方法 / 案例，必须来自真实检索命中，且 AI 内部保留溯源；但客户端报告中不出现内部文件名（见 §5 呈现规范）。
- 禁止把「智库没提到的内容」伪造成「智库说」。
4. 合规红线（发客户材料，不可逾越）
> 与 GEO 业务同源红线一致：不承诺效果 / 获客；所有事实性数据必须有出处。
- 成熟度评分 / 评分数字：来自真实输入或总部沉淀库，AI 不得编造。
- 客户案例增长数据 / 客户引言：必须真实可溯（来自智库或客户自述），不得编造。
- 不出现结果承诺词：保证获客 / 保证推荐 / 优先排名 / 包效果 / 保证线索。
- 无出处不写：任何事实性陈述若无可靠来源，宁可删去，不可臆造。
- 对外发出前建议经销售 / 总部复核（非强制，由使用方自定）；本 skill 不内置强制人工审核关卡。
5. 呈现规范（客户视角，必须执行）
以下规则与合规红线并列，控制客户看到的内容形态：
- 不出现 AI 生成过程说明：删掉「以下痛点块由 AI 抽取生成」「以下方案卡按痛点数量动态生成」等 meta 语句——客户不需要知道报告是怎么被程序拼出来的。
- 不出现内部文件名/资料名：不在方案卡、案例块里写「长松智库支持：《xxx.pdf》」「引自《安徽辅导客户见证.pdf》」。智库资料只作为 AI 设计依据，不在客户端展示。
- 对标案例块改为「典型路径」呈现：不展示匿名、无名、无数据的"客户见证"（客户看了会莫名其妙）。改为以「同类代理商的典型成长路径（供参考）」形式，用
{{典型路径}}给出一条清晰阶段顺序（如 接住流量 → 跑通单店 → 理顺分配 → 复制扩张）。可带真实机制（如营销薪酬机制→第二团队），但不得编造具体客户名/数字，也不得加合规自我辩解注（如"出于合规未杜撰……"）。 - 社会认同可揉进方案描述：如需证明路径可行，在对应方案卡里轻轻带一句「长松辅导过的同类企业也走这条路径」即可，与典型路径块互为补充。
6. 模板插槽映射表
本 skill 自带 templates/诊断报告模板.html：3 页 / 红白黑高级质感 / 无任何图表 / 全动态插槽 + {{占位符}}。
6.1 静态占位符（每次必填）
| 占位符 | 来源 |
|---|---|
{{L1标签}} |
Step 2 客户画像归纳（如「经营效率型」） |
{{核心结论}} |
Step 2 一句话总诊断 |
{{综合成熟度分}} |
真实输入 / 总部沉淀（合规红线 §4.1，不得编造）；无真实分数时填「深度诊断后出具」，严禁填「待测」（客户视角像草稿）。渲染于 P1 左红边评估条（.score-pill），与「AI 不预填」说明同条呈现 |
{{客户原话}} |
Step 2 原话集精选 |
{{客户姓名}} {{客户职务}} |
客户基础信息 |
{{代价金额}} |
基于痛点推导的年度损失估算（需有依据） |
{{表象问题}} {{根因}} |
Step 2 卡点归纳 |
{{顾问姓名}} {{顾问职务}} {{顾问联系方式}} |
销售本人信息（Step 0 索取，P3 专属顾问）；未提供时 {{顾问姓名}} 填「您的专属顾问」、{{顾问职务}} 填「长松咨询 · 您的专属诊断顾问」、{{顾问联系方式}} 填「发送前由顾问本人补充」，严禁留「（待补）」（客户视角像半成品） |
{{所属行业}} |
Step 1 客户全景摘要（P1 基本信息条） |
{{诊断日期}} |
拜访/诊断日期（取源材料真实日期，如录音文件名日期；无则留空提示） |
{{报告编号}} |
由 skill 按 CS-<客户缩写>-<YYYYMMDD> 规则生成（标识码，非事实主张） |
{{维度数量}} {{维度标签}} |
Step 2 卡点实际归属维度（如「4」「战略/营销/组织/股权」），P1 导读 |
{{痛点数量}} {{方案数量}} {{行动数量}} |
真实计数（= N 痛点 / N 方案 / 行动卡数），P1 导读，不编造 |
{{典型路径}} |
同类代理商典型成长路径（P3 案例块）：按客户维度写一条阶段顺序（如 接住流量→跑通单店→理顺分配→复制扩张），可带真实机制、不得编客户名/数字、不得加合规辩解注（呈现规范 §5.3） |
6.2 动态循环块（按卡点数 N 复制）
| 块 | 模板位置 | 数量 | 填充来源 |
|---|---|---|---|
痛点块 .pain |
P2 | = N | Step 2 每个卡点（含 {{痛点N标题}} {{痛点N原话}} {{痛点N展开}} {{痛点N维度}}——维度名，渲染为标题后的金色胶囊标签，如 战略/营销/组织/股权） |
方案卡 .sol .card |
P3 | = N | Step 4 每个卡点匹配的方案（{{方案N名称}} {{方案N交付与周期}}） |
行动卡 .acts .a |
P3 | 自定（建议 3） | Step 4 推演的下一步（{{行动1}} {{行动2}} {{行动3}}） |
> 循环块在模板中已各留 2 个示例，实际由 skill 按 N 生成对应数量。填充时复制 HTML 结构、替换其中的 {{...}}，再把不需要的示例块删除。
> 行动卡硬规则：第 1 步必须是具体、零成本、零签约风险的小动作（如「本周花 1 小时做 X 梳理，不花钱、不签单」），不得只写「战略先行 / 系统夯实」等抽象词——客户看完要知道「明天能干什么」。
7. 已知边界与待办（透明披露）
| # | 事项 | 状态 |
|---|---|---|
| 1 | IMA 长松智库检索连通性 | ✅ 已实测（ima-mcp 可调，KB id 7461959758803066 命中组织架构图.jpg 等 20+ 资料） |
| 2 | 语音转文字（ASR） | ✅ 已实测（asr-transcribe 本地离线 Whisper，真实录音端到端跑通，数据未出域）—— 由 visit-input-parser 前置完成 |
| 3 | 报价单模板（¥53,800 深色金） | ⏸ 暂缓，模板已建待激活（不在本 skill 范围） |
| 4 | 雷达图 / 六维速览 | ❌ 已移除（用户决策「正常没人看那个图」），报告纯文字无图表 |
| 5 | 与库内「诊断回答SOP_长松智库.md」5 维对齐 | ❌ 已放弃，本 skill 维持 6 维（组织/财务/营销/战略/执行/股权） |
| 6 | 人工审核关卡 | ⚪ 已按用户决策移除强制（是否复核由使用方自定） |
| 7 | 同类对标案例块 | ✅ 已改为「典型成长路径（供参考）」呈现：去匿名客户见证、去合规辩解注，改用 {{典型路径}} 给阶段顺序；可带真实机制但不得编客户名/数字 |
8. 与其他 skill 的衔接
- 输入来自
visit-input-parser（解析音频/文档）：本 skill 不碰原始文件解析，只吃「干净文本」。若用户直接给文本则可跳过解析步。 - 输出为 JPEG 诊断报告长图（由 HTML 渲染生成，体积控制在 300–500KB），可直接保存/发送；HTML 作为可编辑源文件一并保留。
- 本 skill 内含「听懂→抽卡点→搜智库→匹配方案」的理解层逻辑（因其产出最终成品、必须懂内容）；如未来想把理解层也单独拆出，可再议。
9. 环境依赖（图片渲染器）
本 skill 最终交付物为图片，依赖如下渲染环境：
- Python 3.10+（执行
render_report.py）。 - playwright 包：
pip install playwright - Pillow 包（PNG→JPEG 压缩，控制体积以适配小程序）：
pip install pillow - Chromium 浏览器二进制：
playwright install chromium（首次执行会下载约 100MB+ 的 headless Chromium）。
体积优化说明：渲染器默认以 1.5x 清晰度截图，再用 Pillow 转 JPEG（质量 80）。原 2x PNG 约 2.3MB，在小程序端以 base64 内联时超过体积上限导致「加载失败」；降至 1.5x JPEG 后约 300–500KB，可正常加载。如确需更高清，可传第 3 个参数 scale（如 2）与第 4 个参数 quality（如 85）重渲染，但需自行确认小程序端体积限制（建议 < 600KB）。
如果运行环境不满足，优先保证 HTML 文件先生成，再提示用户安装依赖后重渲染。
附：参考资料（本 skill 附带）
references/Skill开放抽取规范.md— v1 设计蓝图（含完整决策过程，拆分依据）references/内容产出维度分析.md— 诊断报告内容维度拆解（7 维 + 2 锚定模块）templates/诊断报告模板.html— 输出模板（红白黑高级质感，动态插槽）render_report.py— HTML → JPEG 渲染脚本（1.5x 截图 + Pillow 压缩，3 页拼合为一张长图，体积约 300–500KB）
