---
name: qiwei-broker-playbook
description: 迁移自 Qiwei 项目的顾问 playbook 能力：准备/蒸馏/保存/批量/导出顾问 playbook、读取已保存 playbook。数据保存在 outputs/broker-playbooks/。
---

# 顾问 Playbook

## 使用边界

本 skill 负责：

- 基于群消息准备顾问 playbook 分析上下文；
- 关键词模式快速生成简版 playbook；
- 保存 Agent 分析后的 playbook；
- 批量蒸馏/保存/导出 playbook；
- 读取已保存的 playbook。

## 数据存储

- Playbook 文件：`outputs/broker-playbooks/<brokerUserId>.json`
- 分析上下文：`outputs/broker-playbooks/<timestamp>/context-<brokerUserId>.json`
- Playbook 导出：`outputs/broker-playbooks/export-<timestamp>.xlsx`

## 标准流程

### 准备顾问 playbook

```json
{
  "brokerUserId": "broker-1",
  "roomIds": ["r1"]
}
```

返回分析上下文。分析后调用 `qiwei_save_broker_playbook` 保存。

### 关键词模式蒸馏

```json
{
  "brokerUserId": "broker-1",
  "aiMode": "keyword",
  "roomIds": ["r1"]
}
```

直接基于消息关键词生成简版 playbook 并保存。

### 保存 playbook

```json
{
  "brokerUserId": "broker-1",
  "playbook": {
    "客户分层": "...",
    "开场白": "..."
  }
}
```

### 批量与导出

- `qiwei_batch_distill_broker`
- `qiwei_batch_save_broker_playbook`
- `qiwei_export_broker_playbooks`
- `qiwei_get_broker_playbook`

## 迁移说明

原 Qiwei 项目中的 `BrokerPlaybook` SQLite 表改为文件化：

- Playbook 分析 → `outputs/broker-playbooks/`

MCP 工具：

- `qiwei_prepare_broker_playbook`
- `qiwei_distill_broker`
- `qiwei_save_broker_playbook`
- `qiwei_batch_distill_broker`
- `qiwei_batch_save_broker_playbook`
- `qiwei_export_broker_playbooks`
- `qiwei_get_broker_playbook`