---
name: qiwei-customer-transfer
description: 迁移自 Qiwei 项目的客户交接能力：预览交接包、执行群成员变更完成客户交接。数据保存在 outputs/transfers/。
---

# 客户交接

## 使用边界

本 skill 负责：

- 根据 fromUserId/toUserId 和 roomIds/externalUserIds 生成交接包预览；
- 执行交接：邀请新顾问入群、可选移除旧顾问、发送欢迎语。

## 数据存储

- 预览包：`outputs/transfers/preview-<timestamp>.json`
- 执行日志：`outputs/transfers/execution-<timestamp>.json`

## 标准流程

### 预览交接包

```json
{
  "fromUserId": "old-broker",
  "toUserId": "new-broker",
  "roomIds": ["r-1", "r-2"]
}
```

系统会读取 `outputs/groups/confirmed-mapping.json` 补充客户信息，生成交接包。

### 执行交接

```json
{
  "guid": "<已登录设备 guid>",
  "removeOldBroker": true,
  "welcomeText": "您好，我是您的新服务顾问，后续由我为您服务。"
}
```

不传 `previewFile` 时默认使用最新的预览包。

## 迁移说明

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

- 预览包/执行日志 → `outputs/transfers/`

MCP 工具：

- `qiwei_preview_transfer_package`
- `qiwei_execute_transfer`