客户拜访录音分析流水线
概述
将一线销售的客户拜访录音（或转写稿）转化为结构化分析资产：多视角诊断 MD → 统一深蓝商务风可视化 HTML → 可选上传团队资料库 → 记录工作日志。适用于销售教练复盘、销售管理者巡检、市场部情报沉淀三类场景。
触发条件
满足任一即触发本 skill：
- 用户提交录音文件（音频/视频），附带或可推断"业务姓名 + 客户名称 + 拜访日期"
- 用户粘贴大段转写文本（多发言人格式，如"发言人 1 / 发言人 2"），末尾附"姓名+客户+日期"
- 用户明确说"分析这份拜访录音/转写稿""出拜访分析"等
工作流程
第 1 步：获取转写稿
- 用户给了音频/视频文件 → 先用 AudioTranscribe 工具转写（长音频 ASR，支持中文、方言、说话人分离），转写完成后向用户确认说话人对应关系（哪位是业务本人、哪位是客户）
- 用户直接贴转写文本 → 直接使用，跳过转写
- 关键信息缺失（业务姓名/客户名称/日期任一缺失）→ 先向用户确认再动笔，不要臆造；日期判定优先级见
references/transcription-rules.md
第 2 步：产出分析 MD
- 读取
references/analysis-framework.md（七段结构与写作要点） - 读取
references/md-template.md（MD 骨架模板，按占位符填充） - 按
references/transcription-rules.md处理：发言人分离、误转纠正、量级存疑标注 - 命名
YYYYMMDD业务姓名_客户名称.md，写入输出目录（默认{workspace}/客户拜访分析/，用户指定了其他位置则从其指定）
质量红线：
- 不臆造数字——原话量级存疑的写"待核"，未出现的客户名/人名不脑补
- 客户侧商业机密（报价、账期、灰色操作）只进内部分析文件，不进对外传播物料
- 全程用规范名称，发现谐音误转变体一律改回正确写法
第 3 步：转可视化 HTML
运行打包脚本（深蓝商务风模板已内置：hero 头部、评级徽章、日期徽章、目录、表格样式）：
# 单文件模式
python3 scripts/convert_vis.py "路径/文件名.md" --out-dir "输出目录"
# 批量模式（转换目录下所有 .md，跳过框架/模板类文件）
python3 scripts/convert_vis.py "分析目录/" --out-dir "输出目录" --brand "团队/品牌名" --dept "部门名"
- 评级徽章自动从 MD 中提取（
商机评级：B+（说明）等多种格式，正则已覆盖历年实战变体） - 日期自动从文件名前缀
YYYYMMDD提取 - 依赖
markdown库：系统 python3 常缺此模块，优先用/Users/seven/.workbuddy/binaries/python/envs/default/bin/python（其他机器用装好markdown的环境） - 转换后抽查 HTML 中的
class="chip hot"徽章是否命中预期评级——这是历次翻车点
第 4 步：上传资料库（可选，默认先询问）
上传前必须向用户确认目标文件夹；不要凭历史记忆假定 nodeId，让用户提供或从会话上下文确认。流程：
- ToolSearch 加载
LibraryUpload - DeferExecuteTool 执行上传，
parent_id传用户确认的文件夹节点 ID - 默认只传可视化 HTML（资料库以浏览为主）；用户要求时再补传 MD 源稿
若本 skill 被团队共享使用：提醒成员上传目标是个人资料库空间，需各自确认自己的目标文件夹，避免误传他人空间。
第 5 步：记录工作日志 + 交付
- 按所在工作区的记忆规范，向当日日志追加一条：份序号、业务/客户/日期、评级、核心结论（3-5 条要点）、交付物路径
- 用 present_files 同时呈现 HTML 与 MD（HTML 在前，预览优先）
资源清单
| 文件 | 用途 |
|---|---|
scripts/convert_vis.py |
MD→HTML 转换脚本（参数化品牌名/部门名，评级正则+日期提取已实战验证） |
references/analysis-framework.md |
七段分析框架：结构、评级体系、写作要点、跨场合流识别 |
references/md-template.md |
MD 骨架模板（占位符版，可直接复制填充） |
references/transcription-rules.md |
转写处理规则：发言人分离、日期判定、命名规则、误转纠正词典（可持续累积） |
扩展约定
- 误转纠正词典：分析中每发现新的谐音误转（人名/公司名/产品名/型号），按
transcription-rules.md的表格格式追加一行——词典越用越准 - 评级校准：A- 以上须有公司级/渠道级信号（联营、集采入口、渠道级承诺），B+ 须有明确可验证商机，避免评级通胀
- 框架演进：若用户提出新的分析维度（如新增视角、新增字段），先更新
analysis-framework.md再用于下一份，保持历史文件不回改
