> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Coaching Highlights 规格

Coaching Highlights 用 AI 给每通销售电话的 5 个销售能力维度打分，把表现弱的通话标成 flag（需教练）、强的标成 highlight（样板）。本文给开发者定义：AI 该产出什么、flag/highlight 怎么推导、前端和 Rules 怎么消费。

**这是 prescriptive spec。** 当前 AI pipeline 只产出笼统的 `practical_coaching` 文本，没有这 5 个维度的逐通话结构化打分——本文定义的是**新需求**，不是现状。

**关联**：[Rules Feature](/product-design/v1/rules-feature/rules-feature.md) · [Dashboard Specification](/product-design/v1/dashboard-feature/dashboard-spec.md) · [AI Prompt 架构](../../../ai-agent-design/prompt-structure/final-6-file-prompt-architecture.md)

***

## 一、设计原则

- **逐通话、逐维度**：每个合格通话，5 个维度各独立打 `0–10` 分，互不合并
- **阈值驱动，店铺可配**：flag/highlight 由分数与 Rules 阈值比较得出，不靠 AI 直接给标签
- **通话去重计数**：一通话多维度低分仍只算 1 个 flagged call，对齐老板的直觉口径
- **演进自原型**：UI 形态以 `docs/public/ui-prototypes/ui-prototype-mvp-v2.html` Staff 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` → 该（通话, 维度）记一个 **flag**
- `s > 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 个完整滚动窗口                      |