Coaching Highlights Specification¶
Coaching Highlights 用 AI 给每通销售电话的 5 个销售能力维度打分，把表现弱的通话标成 flag（需教练）、强的标成 highlight（样板）。本文给开发者定义：AI 该产出什么、flag/highlight 怎么推导、前端和 Rules 怎么消费。
这是 prescriptive spec。 当前 AI pipeline 只产出笼统的 practical_coaching 文本，没有这 5 个维度的逐通话结构化打分——本文定义的是新需求，不是现状。
关联：Rules Feature · Dashboard Specification · AI Prompt 架构
一、设计原则¶
- 逐通话、逐维度：每个合格通话，5 个维度各独立打
0–10分，互不合并 - 阈值驱动，店铺可配：flag/highlight 由分数与 Rules 阈值比较得出，不靠 AI 直接给标签
- 通话去重计数：一通话多维度低分仍只算 1 个 flagged call，对齐老板的直觉口径
- 演进自原型：UI 形态以
docs/diagrams/ui-prototype-mvp-v2.htmlStaff Performance 面板为准
二、AI 数据产出（新增需求）¶
2.1 评分对象 — coaching-worthy 通话¶
一个通话进入 SA 打分，需同时满足三个条件：
| 条件 | 判定 | 来源 |
|---|---|---|
| 时长达标 | 通话时长 ≥ minCallDuration |
Rules（默认 60 秒） |
| 销售/Lead 类型 | 属销售或 Lead 相关通话，排除 wrong_number/do_not_contact/spam/纯行政咨询 |
通话分类 |
| 有销售互动 | AI 判定该通话有足够销售互动值得评（客户秒挂等跳过） | AI |
不满足任一条件的通话不打分，也不计入 flag rate 分母。
2.2 5 个固定 SA 维度¶
每个 coaching-worthy 通话，AI 对以下 5 个维度各产出 score: 0–10 + rationale: 文本理由：
| 维度 | 衡量什么 |
|---|---|
Booking Ask |
是否主动、清晰地促成下一步预约（试课/到店） |
Objection Handling |
对价格/时间/犹豫等异议的回应质量 |
Retention Technique |
挽留/续费/防流失话术的运用 |
Rapport Building |
与客户建立信任和连接的程度 |
Information Accuracy |
提供的价格、政策、排课等信息是否准确 |
5 个维度固定，不随店铺变化。新增维度需改本 spec 与 Rules。
三、flag / highlight 推导¶
3.1 单维度判定¶
对每个维度分数 s：
s < flagThreshold→ 该（通话, 维度）记一个 flags > highlightThreshold→ 记一个 highlight- 之间 → 不标
一通话可在多个维度同时被 flag 和 highlight。
3.2 通话级计数¶
| 指标 | 定义 |
|---|---|
| flagged call | 该通话 ≥1 个维度低于 flagThreshold（去重，一通话最多算 1 次） |
| Coaching Flag Rate | flagged calls ÷ coaching-worthy calls（按 Rules 滚动窗口统计） |
chip 的 M flagged |
周期内 flagged 通话数 |
highlight 同理按通话去重得 highlighted call。
四、前端展示¶
4.1 Coaching Highlights 面板（Staff Performance 内）¶
全列表 + 筛选：列出当前周期所有 flagged / highlighted 通话，可按维度类别和 staff 筛选。每条目展示：
- staff + 联系人
- 命中的维度 + 该维度 AI 分（
X/10） - flag 红 / highlight 绿 的视觉区分
- 该维度的
rationale（Why flagged / highlighted） - Coaching suggestion 一行
- View details → 跳通话详情
原型当前用"5 类各 1 条精选"占位。本 spec 定稿口径为可筛选全列表，原型据此演进。
4.2 Staff Performance 表 + 周期 chip¶
- 表内每个 SA 显示其 Coaching Flag Rate
- 面板顶部 chip：
<周期> · N coaching-worthy calls → M flagged
五、Rules 可配项¶
| 配置项 | 默认值 | 说明 |
|---|---|---|
minCallDuration |
60 秒 | 进入 SA 打分的最小通话时长 |
rollingWindow |
4 周 | Coaching Flag Rate 的统计窗口 |
flagThreshold |
< 4 |
维度分低于此记 flag |
highlightThreshold |
> 8 |
维度分高于此记 highlight |
flagThreshold / highlightThreshold V1 为全局统一一对，5 个维度共用。每维度独立阈值 DEFERRED。
六、V1 范围¶
| 范围 | 状态 |
|---|---|
| 5 维度逐通话打分 + rationale | V1 |
| flag 与 highlight 双向（同套阈值两端） | V1 |
| 全局统一阈值 + Rules 可配 | V1 |
| Coaching Highlights 全列表 + 类别/staff 筛选 | V1 |
| 每维度独立阈值 | DEFERRED — 原因：V1 数据量小，先验证统一阈值是否够用；恢复条件：单店 coaching-worthy 通话量稳定 ≥ 单维度可统计后 |
| 维度趋势 / 雷达图 / 跨周期对比可视化 | DEFERRED — 原因：先跑通打分与 flag 闭环；恢复条件：评分数据积累 ≥ 1 个完整滚动窗口 |