# OKKI CRM 月度经营报告 SKILL · 使用说明

**版本**：v2.0  |  **适用范围**：所有接入 OKKI CRM 插件的 Accio Work 账号

---

## 一、安装技能（首次使用必读）

### 前提条件

使用本技能前，请确认以下三项已就绪：

| 条件 | 检查方式 |
|------|---------|
| 已安装 Accio Work | 访问 [accio-ai.com](https://www.accio-ai.com) 下载并登录 |
| 已连接 OKKI CRM 插件 | Accio Work → 插件市场 → 搜索「OKKI」→ 安装并授权 |
| 已获取本技能文件夹 | 收到 `okki-crm-monthly-report` 文件夹（含3个文件） |

### 技能文件夹结构

安装前请确认文件夹包含以下内容：

```
OKKI-CRM月度数据诊断V1全量版/
├── SKILL.md        ← 技能核心指令文件（必须）
└── 使用说明.md     ← 本文档
```

> ✅ v2.0 起报告完全由 AI 直接生成 HTML，**不再依赖任何外部脚本**，文件夹结构更简洁。

### 收到的是 .zip 压缩包？先解压

如果收到的是 `okki-crm-monthly-report.zip` 压缩文件，**请先解压，再安装**：
- macOS：双击 .zip 文件即可自动解压
- Windows：右键 → 「解压到当前文件夹」

解压后得到 `okki-crm-monthly-report` 文件夹，再按以下步骤安装。

> ❌ 不支持直接安装 .zip 文件，必须先解压成文件夹。

---

### 安装步骤

**步骤 1**：打开 Accio Work，点击左侧边栏的**「技能（Skills）」**页面

**步骤 2**：点击右上角**「上传」**或**「安装本地技能」**按钮

**步骤 3**：在弹出的文件选择框中，选择 `okki-crm-monthly-report` **文件夹**（选文件夹，不是里面的单个文件）

> Accio 会自动读取 SKILL.md，并将整个文件夹（含脚本）一起注册为可用技能

**步骤 4**：看到「技能安装成功」提示后，在对话框输入「生成月度报告」验证是否生效

---

### ⚠️ 两个常见错误操作

| 错误操作 | 结果 | 正确做法 |
|---------|------|---------|
| 把文件夹**拖到聊天窗口** | Accio 会把它当普通文件读取，不会安装成技能 | 去「技能」页面点「上传」安装 |
| 直接上传 **.zip 压缩包** | 无法识别为技能包 | 先解压成文件夹再安装 |

### 常见安装问题

| 问题 | 原因 | 解决方式 |
|------|------|---------|
| 点「安装」后没反应 | 文件夹结构不完整 | 确认 SKILL.md 在文件夹根目录 |
| 触发后提示「OKKI 未授权」 | OKKI 插件未连接 | 先去插件市场安装并授权 OKKI CRM |
| 报告模块缺失/图表空白 | 使用了自动模型 | **切换为 Claude Sonnet 5 或专业模型后重新触发** |
| 数据全显示 $0 或 0 | 查询时间范围不对 | 明确告诉 Accio「生成2026年X月的报告」 |

---

## 二、快速开始（安装后）

在对话框输入以下任意指令，Accio 将自动生成报告：

```
生成月度报告
出月报
OKKI月报
帮我出上个月的经营报告
生成2026年6月的OKKI报告
```

Accio 会自动：
1. 识别报告周期（默认上一个自然月）
2. 并行查询 OKKI CRM 的 14 个数据维度
3. AI 分析业务员类型、渠道效率、商机机会
4. 生成一份完整 HTML 报告文件（打开即显示，无需网络）
5. 在对话里给出 3 条核心发现

---

## 三、模型选择建议（重要）

> ⚠️ **经测试：本 SKILL 强烈推荐使用专业模型或 Claude Sonnet 5，自动模型生成效果不稳定。**

### 推荐模型

| 优先级 | 模型 | 效果 |
|--------|------|------|
| ✅ **首选** | **Claude Sonnet 5**（专业模型）| 报告完整度最高，SVG图表正确，业务诊断最精准 |
| ✅ 可用 | 其他专业模型 | 报告完整，偶有细节需微调 |
| ⚠️ 不推荐 | 自动模型 | 经测试：SVG图表易生成空壳、内容模块容易缺失、诊断建议偏通用 |

### 为什么本 SKILL 必须用专业模型？

本 SKILL 一次要完成 14 项并行数据查询 + SVG 坐标计算 + 9 大模块 HTML 生成，**任务链条长、上下文量大**。自动模型在处理长上下文时容易"省略"后半段，导致：

- 报告模块缺失（只有前4-5个模块，后面没了）
- SVG 图表生成空壳（画了框但没填数据）
- 业务员档案不完整（只有2-3人，其他人丢了）
- 诊断建议过于通用（没有结合具体数字分析）

### 切换方式

在 Accio Work 对话框**左下角**找到模型选择器，切换到 `Claude Sonnet 5` 或专业模型，再输入触发词即可。

> **最佳实践**：正式出月报用 Claude Sonnet 5；日常测试用其他模型验证流程即可，但最终正式报告必须用专业模型。

---

## 四、报告包含内容

| 模块 | 内容 | 价值 |
|------|------|------|
| **KPI 总览** | 订单额、商机数、转化率、输单数、新客户、邮件量 | 一眼掌握月度健康度 |
| **1. 订单趋势** | 过去6个月月度走势 + 环比 | 看增长还是下滑 |
| **2. 商机漏斗** | 各业务员商机数 vs 赢单数 | 找出低效业务员 |
| **3. 业务员档案** | 自动打标签+评分+改进建议 | 团队管理利器 |
| **4. 输单分析** | 输单原因分布 + 近期输单记录 | 找回流失订单 |
| **5. 商机预测** | 在途商机三情景预测金额 | 下月收入预期 |
| **6. 渠道对比** | 获客来源 vs 成交来源（阿里生态合并） | 识别低效渠道 |
| **7. 国家双视角** | 客户数 Top10 + 成交额 Top10 | 找隐藏高价值市场 |
| **8. 产品排名** | 过去半年 Top10 产品（含利润定位标签） | 调整产品推广策略 |
| **9. 诊断建议** | 3个核心问题 + 4个行动建议 | 本月工作优先级 |

---

## 五、指定报告月份

默认生成上一个自然月的报告。如需指定月份：

```
生成2026年5月的月度报告
出一份4月份的OKKI报告
帮我做6月的经营分析
```

支持最近6个月的任意月份。

---

## 六、报告文件说明

生成的报告文件：
- **文件名**：`OKKI-CRM月度经营报告-YYYY年M月.html`
- **保存位置**：Accio 当前工作空间目录
- **打开方式**：双击用浏览器打开，或通过 Accio 文件链接访问
- **零网络依赖**：无需联网，离线也能完整显示所有图表

---

## 七、业务员档案评分说明

每位业务员自动计算 0-100 综合评分：

| 评分维度 | 权重 | 说明 |
|---------|------|------|
| 赢单转化率 | 30% | 赢单数 ÷ 商机数 |
| 订单金额占比 | 30% | 个人订单 ÷ 团队总订单 |
| 回款率 | 20% | 回款金额 ÷ 订单金额 |
| 跟进活跃度 | 20% | 联系次数 ÷ 团队最高联系次数 |

**类型标签自动判定**：

| 标签 | 边框颜色 | 判定条件 |
|------|---------|---------|
| 猎人型 Hunter | 绿色 | 赢单率≥20% 或 订单额第一+回款率≥90% |
| 农夫型 Farmer | 金色 | 联系量、跟进客户数、商机数均为全队最高 |
| 稳健型 Farmer | 蓝色 | 回款率100% 且商机数≤5 |
| 客服型 Service | 紫色 | 线索>500 且跟进率<2% 且零赢单 |
| 潜力型 Rising | 金色 | 商机<3 且联系次数<100 |
| ⚠ 数据异常 | 红色 | 线索数>团队均值3倍 且跟进率<1% 且零赢单 |

---

## 八、渠道分组说明

**阿里国际站生态**（自动合并）：
- TM咨询
- 阿里巴巴（询盘）
- 阿里国际站名片
- 阿里询盘
- 信保询盘

**独立渠道**（单独展示）：
- 信保订单
- RFQ
- 潜客运营
- OKKI Leads
- 自主开发

---

## 九、不同公司的适配说明

本 SKILL 适用于任何接入 OKKI CRM 的公司，数据完全来自各公司自己的 OKKI 账号，不会混用。以下内容会自动适配：

| 项目 | 适配方式 |
|------|---------|
| 业务员名单 | 自动读取当前 OKKI 账号下的所有业务员 |
| 业务员数量 | <4人单列，4-6人双列，>6人三列 |
| 业务员类型标签 | 基于本公司数据相对值判定，非固定阈值 |
| 渠道列表 | 自动识别并合并，无数据的渠道不显示 |
| 产品排名 | 完全基于本公司订单数据 |

---

## 十、常见问题（使用中）

**Q：报告里图表显示空白怎么办？**
A：这个报告是纯 SVG 零依赖，无需网络，打开就能显示。如果空白请检查文件是否完整下载。

**Q：某个业务员的数据为空或显示「—」？**
A：说明该业务员在 OKKI 中该字段无记录。不是报告错误，是真实数据状态。

**Q：想修改报告周期怎么办？**
A：直接告诉 Accio「重新生成，改成5月」即可。

**Q：可以每月自动生成报告吗？**
A：可以，告诉 Accio「每月1日自动生成上月报告」，Accio 会帮你设置定时任务。

**Q：报告数据多久更新一次？**
A：每次触发生成时实时查询 OKKI CRM，数据是生成时刻的最新状态。

**Q：如何分享报告给老板或团队？**
A：直接发送 HTML 文件，对方用浏览器打开即可，无需安装任何软件。

---

## 十一、版本说明

| 版本 | 日期 | 主要变更 |
|------|------|---------|
| v1.0 | 2026-07-07 | 初始版本 |
| v2.0 | 2026-07-09 | 修复：删除不存在的Python脚本；改为AI直接生成HTML；加入SVG坐标规范；推荐模型更新为 Claude Sonnet 5 |

### 升级计划

| 功能 | 状态 |
|------|------|
| 自动定时推送（每月1日生成） | 规划中 |
| 飞书/钉钉消息通知 | 规划中 |
| 周度报告（7天维度） | 规划中 |
| 同比分析（对比去年同期） | 规划中 |
| 业务员个人报告（单人版） | 规划中 |

---

**技术支持**：如遇到数据异常或报告生成失败，在对话里告诉 Accio 具体问题，Accio 会协助排查。

*本 SKILL 由 Andy 基于实际外贸运营场景创建，v2.0 · 2026-07-09*