@puyinkai/xiaobao-cli 0.1.0

package/skills/wangxiaobao-customer-query/SKILL.md

@@ -0,0 +1,214 @@
+---
+name: wangxiaobao-customer-query
+description: |
+  旺小宝客户分页查询 skill：按 **置业顾问 / 客户姓名 / 手机号 / 画像关键词 /
+  最后来访时间** 维度分页查当前激活项目里的客户列表。**只读、不写文件、无副作用**。
+  对应 `xiaobao_list_customers` tool。排序固定 last_visit_time DESC。
+
+  **当以下情况时使用此 Skill**:
+  (1) 用户问"客户列表"、"我的客户"、"高意向客户"、"近期来访客户"
+  (2) 用户问"张三名下的客户"、"陈平这周新增了哪些客户"——先调
+      `xiaobao_list_consultants` 反查顾问 user-id，再调本 skill 带 userId 过滤
+  (3) 用户按客户画像找——"高意向客户"、"价格敏感客户"、"看四房的客户"，用
+      `portrait` 关键词
+  (4) 用户问"姓张的客户"、"手机号 138 的客户"——客户姓名 / 手机号 LIKE 模糊
+  (5) 用户问"5 月份来过的客户"、"上周访客"——`fromDate` / `toDate` 时间窗
+  (6) 任何"看客户名单 / 客户画像"的开放式查询，**不写文件 / 不出报告**
+
+  **不要用本 skill 的场景**：
+  - 用户要的是来访 / 接待记录（"今天来了几组"）→ 走 `wangxiaobao-visit-query`
+  - 用户问录音元数据 / 文本 → 走 `wangxiaobao-audio-query`
+  - 用户要"出报告 / 落 wiki" → 本期不支持
+---
+
+> **Host-agnostic CLI skill** — 本 skill 假设 `xiaobao-cli` 已装到 PATH
+> (`npm i -g @puyinkai/xiaobao-cli` 或 `npx -y @puyinkai/xiaobao-cli`)。
+> Agent 通过 shell 工具（Bash / Run / Shell）执行命令、读 **stdout JSON** 消费；
+> stderr 是进度/错误提示。退出码 0 = 成功，非 0 = 业务/网络错（错误对象同时打到 stdout 可解析）。
+>
+> CLI 14 个子命令跟 openclaw-xiaobao plugin 14 个 tool **1:1 等价**，返回 JSON
+> 结构完全一致（`{status, ok, data: {...}}`）。skill 里看到的 `resp.data.data.xxx`
+> 取数路径直接对 stdout JSON 用 `jq` / `JSON.parse` 即可。
+>
+> **plugin tool → CLI 命令翻译表（数组参数走逗号分隔）**：
+>
+> | plugin tool | CLI 命令 |
+> | --- | --- |
+> | `xiaobao_authorize { force? }` | `xiaobao-cli auth login [--force]` |
+> | `xiaobao_whoami` | `xiaobao-cli auth whoami` |
+> | `xiaobao_logout` | `xiaobao-cli auth logout` |
+> | `xiaobao_list_projects { keyword? }` | `xiaobao-cli project list [--keyword <kw>]` |
+> | `xiaobao_switch_project { tenantId, tenantName, projectId, projectName }` | `xiaobao-cli project use --tenant-id ... --tenant-name ... --project-id ... --project-name ...` |
+> | `xiaobao_list_consultants` | `xiaobao-cli consultant list` |
+> | `xiaobao_list_audio { fromDate, toDate, userId?, userIdList?, page, size }` | `xiaobao-cli audio list --from "..." --to "..." [--user-id ...] [--user-id-list a,b,c] [--page N] [--size N]` |
+> | `xiaobao_get_audio_text { audioId }` | `xiaobao-cli audio text <audioId>` |
+> | `xiaobao_list_customers { ... }` | `xiaobao-cli customer list [--user-id] [--user-name] [--customer-name] [--customer-phone] [--portrait] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_visits { ... }` | `xiaobao-cli visit list [--customer-id] [--customer-name] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_customer_focus { visitIds, customerIds, audioIds, category, classification, fromDate, toDate, ... }` | `xiaobao-cli focus list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category ...] [--classification ...] [--from ...] [--to ...]` |
+> | `xiaobao_list_customer_resistance { ... }` | `xiaobao-cli resistance list [同 focus]` |
+> | `xiaobao_quick_qa { prompt, threadId? }` | `xiaobao-cli qa "<prompt>" [--thread-id ...]` |
+> | `xiaobao_api { method, path, query, body, headers }` | `xiaobao-cli api <METHOD> <PATH> [--query k=v] [--body '<json>'] [--headers k=v]` |
+>
+> 用 `--format toon` 切到 TOON（uniform 数组省 30-50% token，LLM 上下文优化）；
+> 用 `--format json`（默认）保持 JSON。state 路径：`~/.xiaobao/`（fallback 读 `~/.openclaw/state/wangxiaobao/`）。
+
+
+# 旺小宝客户分页查询
+
+调 `xiaobao_list_customers` tool 查当前激活项目的客户画像列表。
+零副作用，鼓励放心调用。
+
+## 执行前必读
+
+- 必须有有效 token：先调 `xiaobao_whoami`；未登录就 `xiaobao_authorize`
+- **必须有激活项目**：tool 内部自动读，如果返回 `NO_ACTIVE_PROJECT` 就跑
+  `wangxiaobao-switch-project` skill
+- **数据权限隔离**：后端按"当前用户授权可见的顾问范围"过滤（普通顾问看自己 /
+  团队长看团队 / 项目管理员看全项目）。当前用户无权访问的顾问名下客户**看不到**——
+  这不是 bug
+- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），plugin 自动转 ISO
+- **不要**写文件、出报告
+
+---
+
+## 快速索引：意图 → 工具
+
+| 用户意图                       | plugin tool                | 关键参数                           |
+| ------------------------------ | -------------------------- | ---------------------------------- |
+| 列全部客户（最近来访的在前）   | `xiaobao_list_customers`   | `page` / `size`                    |
+| 看某顾问名下客户               | `xiaobao_list_consultants` → `xiaobao_list_customers` | `userId: <反查的 id>` |
+| 按客户画像找                   | `xiaobao_list_customers`   | `portrait: "高意向"` 等            |
+| 按客户姓名 / 手机号模糊        | `xiaobao_list_customers`   | `customerName` / `customerPhone`   |
+| 按最后来访时间筛               | `xiaobao_list_customers`   | `fromDate` / `toDate`              |
+| 估算总数                       | `xiaobao_list_customers`   | `page: 1, size: 1`，只读 `total`   |
+
+---
+
+## 核心约束
+
+### 1. 按顾问筛 —— 先反查 user-id，不要硬猜
+
+用户说"张三的客户"——**不要**直接传 `userName: "张三"`（虽然支持但是 LIKE 模糊）。
+正确做法：
+
+1. 调 `xiaobao_list_consultants` 拿当前授权范围内的顾问列表
+2. 找 `userName === "张三"` 的 `userId`
+3. 调 `xiaobao_list_customers { userId: <张三的 userId> }` 精确过滤
+
+如果 list-consultants 里**找不到张三**——说明当前用户没权限看张三名下数据，
+告诉用户"当前账号无权访问销售『张三』"，不要再硬试。
+
+### 2. portrait 单关键词，越短越宽
+
+后端在 `dynamic_tags` JSON 文本上 `LIKE '%xxx%'`。所以：
+
+- `portrait: "高意向"` 命中 `{"高意向客户":"高意向客户"}` / `{"AI意向判定":"高意向"}` 等
+- `portrait: "价格"` 命中 `{"抗性点":"价格"}` 等
+- 不要传完整 JSON / key=value 形式（不支持，反而匹不到）
+
+### 3. 时间窗：用户没明确说就推断
+
+| 用户说法     | fromDate / toDate                                |
+| ------------ | ------------------------------------------------ |
+| "今天来访"   | 今天 00:00:00 / 明天 00:00:00                    |
+| "本周"       | 周一 00:00:00 / 今天 23:59:59                    |
+| "上周"       | 上周一 / 本周一                                  |
+| "5 月份"     | 2026-05-01 00:00:00 / 2026-06-01 00:00:00        |
+| "近一个月"   | 30 天前 / now                                    |
+
+用户明确给时间则按字面用。
+
+### 4. 分页：page 从 **1** 开始
+
+PageParam 默认 `page: 1, size: 10`。传 `page: 0` 报错。`size` 上限 500。
+
+### 5. 响应外层
+
+`xiaobao_list_customers` 返回：
+
+```jsonc
+{
+  "code": "0",
+  "msg":  "success",
+  "data": {
+    "page": 1, "size": 10, "total": 47,
+    "content": [
+      {
+        "customerId":   "1685535452481236993",
+        "customerName": "屈哥",
+        "customerPhone": "173****7325",
+        "intentLevel":   "A",
+        "aiIntentLevel": "A",
+        "lastVisitTime": "2023-07-30 14:01:03",
+        "userId":   270078834689187840,
+        "userName": "兰鸿建",
+        "userInfo": { /* 顾问详情 */ },
+        "dynamicTags": { "高意向客户": "高意向客户", "抗性点": "配套", ... }
+      }
+    ]
+  }
+}
+```
+
+plugin tool 又外包一层 `{ status, ok, data }` —— 取数据用 `resp.data.data.content`。
+
+---
+
+## 使用场景示例
+
+### 场景 1：列我能看到的高意向客户
+
+```jsonc
+{ "portrait": "高意向", "page": 1, "size": 20 }
+```
+
+渲染：
+
+```
+共 12 位高意向客户（最近来访在前）:
+1. 屈哥 · 173****7325 · 顾问兰鸿建 · 最后来访 2023-07-30
+2. 曹女士 · 186****1938 · 顾问兰鸿建 · 最后来访 2023-07-30
+...
+```
+
+### 场景 2：陈平名下的客户
+
+```jsonc
+// step 1
+// xiaobao_list_consultants
+{}
+
+// step 2 ——找到陈平的 userId = 270078836362715136
+// step 3
+// xiaobao_list_customers
+{ "userId": 270078836362715136, "page": 1, "size": 20 }
+```
+
+### 场景 3：5 月来访的客户里抗性是价格的
+
+```jsonc
+{
+  "portrait": "价格",
+  "fromDate": "2026-05-01 00:00:00",
+  "toDate":   "2026-06-01 00:00:00"
+}
+```
+
+### 场景 4：估算总数
+
+```jsonc
+{ "page": 1, "size": 1 }
+```
+
+回复：「当前授权范围下共 1247 位客户」。
+
+---
+
+## 常见错误与排查
+
+- **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
+- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登
+- **`total: 0`** — 时间窗口 / 过滤条件没匹配到，**或**当前用户授权范围为空
+  （新人顾问刚入职 / 团队成员被移走等）
+- **顾问名找不到** — 不在当前用户授权可见范围内；不要硬调 list_customers 试
+- **画像匹配不准** — portrait 太长 / 太具体导致 LIKE 不命中；改短关键词

package/skills/wangxiaobao-customer-resistance-query/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: wangxiaobao-customer-resistance-query
+description: |
+  旺小宝**客户抗性点**分页查询 skill：按 visit/customer/audio ID 列表、一级/二级
+  分类模糊、来访时间窗组合查 AI 在客户对话里抽出的「抗性点」标签
+  （客户疑虑 / 反对 / 不满：价格高 / 户型差 / 地段差 / 装修不满 等）。
+  **只读、不写文件、无副作用**。对应 `xiaobao_list_customer_resistance` tool。
+  排序固定 visit_time DESC。每条 tag 含 customer / userInfo / audio +
+  value_str（详细说明） + text_fragment（录音原文片段）。
+
+  **当以下情况时使用此 Skill**:
+  (1) 用户问"客户抗性点"、"客户疑虑"、"客户反对"、"客户嫌"、"客户担心"、"不满意"
+  (2) 用户问某客户的抗性 —— 先调 `xiaobao_list_customers` 反查 customerId，
+      再调本 skill 带 customerIds 精确过滤
+  (3) 用户问某次到访 / 某条录音里的抗性 —— 带 visitIds / audioIds
+  (4) 用户按分类找 —— 价格抗性 / 户型抗性 / 地段抗性 等 → category 模糊
+  (5) 用户按二级分类找 —— "价格因素" / "位置因素" → classification 模糊
+  (6) 用户给时间窗 —— "5 月份的抗性" / "本周抗性" → fromDate / toDate
+  (7) 想看 **TOP 抗性原因** / 销售应该重点准备哪些应对话术
+
+  **不要用本 skill 的场景**：
+  - 用户问的是**关注点 / 兴趣点 / 客户偏好** → 走 `wangxiaobao-customer-focus-query`
+  - 用户要的是客户**画像** / 标签 → 走 `wangxiaobao-customer-query`
+  - 用户问"完整录音文本" → 走 `wangxiaobao-audio-query` + `xiaobao_get_audio_text`
+---
+
+> **Host-agnostic CLI skill** — 本 skill 假设 `xiaobao-cli` 已装到 PATH
+> (`npm i -g @puyinkai/xiaobao-cli` 或 `npx -y @puyinkai/xiaobao-cli`)。
+> Agent 通过 shell 工具（Bash / Run / Shell）执行命令、读 **stdout JSON** 消费；
+> stderr 是进度/错误提示。退出码 0 = 成功，非 0 = 业务/网络错（错误对象同时打到 stdout 可解析）。
+>
+> CLI 14 个子命令跟 openclaw-xiaobao plugin 14 个 tool **1:1 等价**，返回 JSON
+> 结构完全一致（`{status, ok, data: {...}}`）。skill 里看到的 `resp.data.data.xxx`
+> 取数路径直接对 stdout JSON 用 `jq` / `JSON.parse` 即可。
+>
+> **plugin tool → CLI 命令翻译表（数组参数走逗号分隔）**：
+>
+> | plugin tool | CLI 命令 |
+> | --- | --- |
+> | `xiaobao_authorize { force? }` | `xiaobao-cli auth login [--force]` |
+> | `xiaobao_whoami` | `xiaobao-cli auth whoami` |
+> | `xiaobao_logout` | `xiaobao-cli auth logout` |
+> | `xiaobao_list_projects { keyword? }` | `xiaobao-cli project list [--keyword <kw>]` |
+> | `xiaobao_switch_project { tenantId, tenantName, projectId, projectName }` | `xiaobao-cli project use --tenant-id ... --tenant-name ... --project-id ... --project-name ...` |
+> | `xiaobao_list_consultants` | `xiaobao-cli consultant list` |
+> | `xiaobao_list_audio { fromDate, toDate, userId?, userIdList?, page, size }` | `xiaobao-cli audio list --from "..." --to "..." [--user-id ...] [--user-id-list a,b,c] [--page N] [--size N]` |
+> | `xiaobao_get_audio_text { audioId }` | `xiaobao-cli audio text <audioId>` |
+> | `xiaobao_list_customers { ... }` | `xiaobao-cli customer list [--user-id] [--user-name] [--customer-name] [--customer-phone] [--portrait] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_visits { ... }` | `xiaobao-cli visit list [--customer-id] [--customer-name] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_customer_focus { visitIds, customerIds, audioIds, category, classification, fromDate, toDate, ... }` | `xiaobao-cli focus list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category ...] [--classification ...] [--from ...] [--to ...]` |
+> | `xiaobao_list_customer_resistance { ... }` | `xiaobao-cli resistance list [同 focus]` |
+> | `xiaobao_quick_qa { prompt, threadId? }` | `xiaobao-cli qa "<prompt>" [--thread-id ...]` |
+> | `xiaobao_api { method, path, query, body, headers }` | `xiaobao-cli api <METHOD> <PATH> [--query k=v] [--body '<json>'] [--headers k=v]` |
+>
+> 用 `--format toon` 切到 TOON（uniform 数组省 30-50% token，LLM 上下文优化）；
+> 用 `--format json`（默认）保持 JSON。state 路径：`~/.xiaobao/`（fallback 读 `~/.openclaw/state/wangxiaobao/`）。
+
+
+# 旺小宝客户抗性点查询
+
+调 `xiaobao_list_customer_resistance` tool 查 AI 抽出的客户抗性点标签。
+跟关注点 skill 镜像，差别就是底层走 `mv_open_customer_resistance` 表 ——
+**抗性 = 客户疑虑 / 反对 / 不满**（关注 = 客户主动表达的关心）。
+
+## 执行前必读
+
+- 必须有有效 token：先调 `xiaobao_whoami`；未登录就 `xiaobao_authorize`
+- **必须有激活项目**：tool 内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
+- **数据权限隔离**：按当前用户授权可见顾问范围过滤（普通顾问看自己 /
+  团队长看团队 / 项目管理员看全项目）
+- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），plugin 自动转
+- **不要**写文件、出报告
+
+---
+
+## 快速索引：意图 → 工具
+
+| 用户意图                             | plugin tool                            | 关键参数                           |
+| ------------------------------------ | -------------------------------------- | ---------------------------------- |
+| 列时段内全部抗性点                   | `xiaobao_list_customer_resistance`     | `fromDate` / `toDate`              |
+| 看某客户的抗性                       | `xiaobao_list_customers` → `xiaobao_list_customer_resistance` | `customerIds: [<wang_id>]` |
+| 看某次到访的抗性                     | `xiaobao_list_customer_resistance`     | `visitIds: [<visit_id>]`           |
+| 看某条录音的抗性                     | `xiaobao_list_customer_resistance`     | `audioIds: [<audio_id>]`           |
+| 按分类找（一级）                     | `xiaobao_list_customer_resistance`     | `category: "价格"` 等              |
+| 按分类找（二级）                     | `xiaobao_list_customer_resistance`     | `classification: "价格因素"`        |
+| 估算总数                             | `xiaobao_list_customer_resistance`     | `page: 1, size: 1`，只读 `total`   |
+
+---
+
+## 核心约束
+
+### 1. 客户名 → wang_id 反查
+
+用户说"屈哥的抗性"——先调 `xiaobao_list_customers { customerName: "屈哥" }` 拿到
+`customerId`，再传 `customerIds` 数组。
+
+### 2. 分类模糊：一级 + 二级二选一或同时用
+
+```
+category 一级常见值：户型 / 价格 / 环境 / 教育 / 交通 / 商业配套 / 装修 / 其他
+classification 二级常见值：户型因素 / 价格因素 / 环境因素 / ... / 位置因素 / 发展因素
+```
+
+抗性点最常见是 **"价格因素"** —— 价格高、超预算、车位贵、维修基金贵等。
+其次 **"户型因素"**（房间小 / 朝向不好 / 楼间距）和 **"位置因素"**（偏远 / 噪音）。
+
+### 3. 时间窗：用户没明确说就推断
+
+| 用户说法     | fromDate / toDate                                |
+| ------------ | ------------------------------------------------ |
+| "今天抗性"   | 今天 00:00:00 / 明天 00:00:00                    |
+| "本周抗性"   | 周一 00:00:00 / 今天 23:59:59                    |
+| "5 月份"     | 2026-05-01 00:00:00 / 2026-06-01 00:00:00        |
+
+### 4. 响应字段重点
+
+跟 focus 接口**完全镜像**（共享 `CustomerTagPageResp`），只是返回的是抗性点。
+
+```jsonc
+{
+  "code": "0",
+  "data": {
+    "page": 1, "size": 10, "total": 89,
+    "content": [
+      {
+        "id": "...",
+        "visitId":   "510395382098829312",
+        "audioId":   "1920802945878642689",
+        "customerId": "510395381809422336",
+        "textFragment": "车位都要十来万？",
+        "startOffset": 2778940,
+        "endOffset":   2780380,
+        "keyStr":   "车位价格贵且与房价捆绑优惠",
+        "valueStr": "客户觉得车位贵，且与房价优惠捆绑，如'车位都要十来万？...'",
+        "category":       "价格因素",
+        "classification": "价格因素",
+        "visitTime": "2025-05-09 18:09:01",
+        "customer":  { /* 客户信息 */ },
+        "userInfo":  { /* 顾问信息 */ },
+        "audio":     { /* 录音简要 + 签名 fileUrl */ }
+      }
+    ]
+  }
+}
+```
+
+### 5. 渲染给用户时
+
+- **必显**：keyStr（抗性标题）+ valueStr（详细说明）+ visitTime + 客户名
+- **可选**：category（分类标签，常见是"价格因素"/"户型因素"）+ textFragment（原文，省略号截断）
+- **链接**：要听原录音给 `audio.fileUrl`
+
+### 6. TOP 抗性原因聚合
+
+用户问"我们项目客户最大的抗性是什么"——拉一页 `size: 100`，agent 后处理按
+`category` 聚合输出："5 月共 89 条抗性：价格因素 42 条（47%）/ 户型因素 23 条 /
+环境因素 12 条 / ..."。
+
+---
+
+## 使用场景示例
+
+### 场景 1：本月客户最主要的抗性
+
+```jsonc
+{
+  "fromDate": "2026-05-01 00:00:00",
+  "toDate":   "2026-06-01 00:00:00",
+  "page": 1, "size": 100
+}
+```
+
+按 category 聚合 → "本月 89 条抗性中价格类占 47%，户型 26%，..."。
+
+### 场景 2：价格抗性的具体说法
+
+```jsonc
+{ "category": "价格", "page": 1, "size": 20 }
+```
+
+列出 20 条价格抗性原文，让 LLM 帮销售总结"客户主要嫌车位价高、楼层差价大、
+南北向价差大..."。
+
+### 场景 3：屈哥这次到访都嫌什么
+
+```jsonc
+{ "visitIds": ["510395382098829312"], "page": 1, "size": 50 }
+```
+
+### 场景 4：户型 + 时间窗组合
+
+```jsonc
+{
+  "category":  "户型",
+  "fromDate":  "2026-05-01 00:00:00",
+  "toDate":    "2026-06-01 00:00:00"
+}
+```
+
+回复："5 月户型抗性 23 条，主要集中在'房间小'（11）/'朝向不好'（5）/'楼间距'（4）..."。
+
+---
+
+## 常见错误与排查
+
+- **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
+- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登
+- **`total: 0`** — 过滤条件没匹配 / 该时段没数据 / 当前用户授权范围内没匹配的接待顾问
+- **抗性点 vs 关注点**：跟 LLM 强调"抗性"是负面（疑虑/反对），"关注"是中性偏正
+  （主动关心）；用户说"嫌弃 / 担心 / 不满"走抗性，"在意 / 关心 / 偏好"走关注
+- **category 模糊命中过多** — 加 classification 二级分类收敛

package/skills/wangxiaobao-quick-qa/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: wangxiaobao-quick-qa
+description: |
+  旺小宝业务数据问数 skill：用自然语言询问当前项目的客户 / 来访 / 销售 /
+  录音 / 业务指标等数据，AI 直接基于旺小宝数据回答。**只读、不写文件、无副作用**——
+  对应 `xiaobao_quick_qa` tool。
+
+  **当以下情况时使用此 Skill**:
+  (1) 用户问客户相关数据 —— "今天来了几个客户"、"本周新增多少客户"、
+      "意向客户都有谁"、"老客户回访情况"
+  (2) 用户问来访数据 —— "今天到访多少组"、"上周末来访高峰是几点"、
+      "首访 / 复访比例"
+  (3) 用户问挖需 / 转化指标 —— "挖需率多少"、"成交转化率"、"意向客户占比"、
+      "客户分级分布"
+  (4) 用户问销售 / 销冠数据 —— "本月销冠是谁"、"张三这周成交几单"、
+      "销售排行榜"、"业绩 TOP3"
+  (5) 用户问录音 / 通话 / 接待数据 —— "录音覆盖率多少"、"哪些销售有几条录音"、
+      "本周通话时长 TOP5"、"未跟进客户有多少"
+  (6) 任何"问一句旺小宝数据"的开放式问题
+
+  **不要用本 skill 的场景**：
+  - 用户要的是录音元数据列表（如"列今天所有录音的 audioId"） →
+    用 `wangxiaobao-audio-query` skill，更快更精确
+  - 用户要批量同步录音文本到 wiki → 用 `wangxiaobao-audio-wiki` skill
+---
+
+> **Host-agnostic CLI skill** — 本 skill 假设 `xiaobao-cli` 已装到 PATH
+> (`npm i -g @puyinkai/xiaobao-cli` 或 `npx -y @puyinkai/xiaobao-cli`)。
+> Agent 通过 shell 工具（Bash / Run / Shell）执行命令、读 **stdout JSON** 消费；
+> stderr 是进度/错误提示。退出码 0 = 成功，非 0 = 业务/网络错（错误对象同时打到 stdout 可解析）。
+>
+> CLI 14 个子命令跟 openclaw-xiaobao plugin 14 个 tool **1:1 等价**，返回 JSON
+> 结构完全一致（`{status, ok, data: {...}}`）。skill 里看到的 `resp.data.data.xxx`
+> 取数路径直接对 stdout JSON 用 `jq` / `JSON.parse` 即可。
+>
+> **plugin tool → CLI 命令翻译表（数组参数走逗号分隔）**：
+>
+> | plugin tool | CLI 命令 |
+> | --- | --- |
+> | `xiaobao_authorize { force? }` | `xiaobao-cli auth login [--force]` |
+> | `xiaobao_whoami` | `xiaobao-cli auth whoami` |
+> | `xiaobao_logout` | `xiaobao-cli auth logout` |
+> | `xiaobao_list_projects { keyword? }` | `xiaobao-cli project list [--keyword <kw>]` |
+> | `xiaobao_switch_project { tenantId, tenantName, projectId, projectName }` | `xiaobao-cli project use --tenant-id ... --tenant-name ... --project-id ... --project-name ...` |
+> | `xiaobao_list_consultants` | `xiaobao-cli consultant list` |
+> | `xiaobao_list_audio { fromDate, toDate, userId?, userIdList?, page, size }` | `xiaobao-cli audio list --from "..." --to "..." [--user-id ...] [--user-id-list a,b,c] [--page N] [--size N]` |
+> | `xiaobao_get_audio_text { audioId }` | `xiaobao-cli audio text <audioId>` |
+> | `xiaobao_list_customers { ... }` | `xiaobao-cli customer list [--user-id] [--user-name] [--customer-name] [--customer-phone] [--portrait] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_visits { ... }` | `xiaobao-cli visit list [--customer-id] [--customer-name] [--from] [--to] [--page] [--size]` |
+> | `xiaobao_list_customer_focus { visitIds, customerIds, audioIds, category, classification, fromDate, toDate, ... }` | `xiaobao-cli focus list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category ...] [--classification ...] [--from ...] [--to ...]` |
+> | `xiaobao_list_customer_resistance { ... }` | `xiaobao-cli resistance list [同 focus]` |
+> | `xiaobao_quick_qa { prompt, threadId? }` | `xiaobao-cli qa "<prompt>" [--thread-id ...]` |
+> | `xiaobao_api { method, path, query, body, headers }` | `xiaobao-cli api <METHOD> <PATH> [--query k=v] [--body '<json>'] [--headers k=v]` |
+>
+> 用 `--format toon` 切到 TOON（uniform 数组省 30-50% token，LLM 上下文优化）；
+> 用 `--format json`（默认）保持 JSON。state 路径：`~/.xiaobao/`（fallback 读 `~/.openclaw/state/wangxiaobao/`）。
+
+
+# 旺小宝问数
+
+调 `xiaobao_quick_qa` tool 用自然语言问当前激活项目的业务数据。
+零副作用，不写文件、不动 wiki，所以用错也没成本，鼓励放心调用。
+
+## 执行前必读
+
+- 必须有有效 token：先调 `xiaobao_whoami`；未登录 / 过期就调 `xiaobao_authorize`
+- **必须有激活项目**：tool 内部自动从激活项目状态读 tenant/project，
+  调用方**不要传** tenant/project 参数。如果 tool 返回
+  `error: 'NO_ACTIVE_PROJECT'`，让用户跑 `wangxiaobao-switch-project` skill
+  后再重试
+- **绝不要**写文件。即使用户随口说"顺便存一下"也要拦——告诉用户"出长报告
+  的功能暂未发布，如果想存可以把回答复制下来"
+
+---
+
+## 快速索引：意图 → 工具
+
+| 用户意图                           | plugin tool        | 关键参数                              |
+| ---------------------------------- | ------------------ | ------------------------------------- |
+| 单轮问数                           | `xiaobao_quick_qa` | `prompt`                              |
+| 接着上一轮继续追问                 | `xiaobao_quick_qa` | `prompt + threadId`                   |
+| 给问题加上下文（如客户 ID 列表）    | `xiaobao_quick_qa` | `prompt + context: {...}`             |
+
+---
+
+## 核心约束
+
+### 1. 用业务语言问，不要追问 ID
+
+用户问"张三本周成交几单"——直接把 prompt 原样传给 tool，**不要**先去查
+张三的 user-id 再拼参数。后端 AI 知道"张三"在当前项目里就是谁。
+
+如果用户问的是开放性问题（"客户主要疑虑是啥"），更不要画蛇添足拼任何
+ID / 时间窗口——AI 会自己定义合理范围。
+
+### 2. 多轮：threadId 由 agent 自己接续
+
+第一轮**不传** `threadId`，走单轮模式。响应里有 `resp.data.data.thread_id`，
+**记在 agent 当前对话上下文里**，后续追问把它原样传回 `threadId` 入参。
+**不要**把 thread_id 写到任何文件 / .env / 状态——它只是会话短期记忆。
+
+跨 session（用户关了 chat）就**不再延续**，新 session 重新发起新一轮即可。
+
+### 3. 响应只取 answer 给用户
+
+`xiaobao_quick_qa` 返回结构：
+
+```jsonc
+{
+  "code": "0",
+  "msg":  "success",
+  "data": {
+    "type":      "quick-qa",
+    "thread_id": "...",
+    "answer":    "最终文本（这就是要展示给用户的）",
+    "output":    { /* 原始结构化数据，agent 自己看就行，不展示 */ }
+  }
+}
+```
+
+plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本写
+`resp.data.data.answer`，渲染给用户**只展示 answer**。
+
+如果要支持后续追问，结尾加一句"💡 想接着问可以告诉我，会沿用本次对话上下文"
+（threadId 由 agent 自己存，不要让用户记）。
+
+### 4. 不要拉太多上下文进 context
+
+`context` 字段可以塞额外背景，但**控制在 < 4KB**。需要塞大块录音 / 客户
+档案的需求暂时没有 plugin 侧支持——用户可以分多轮 prompt 喂，每轮塞一段。
+
+### 5. 不要替代 audio-query 做"列录音元数据"
+
+用户问"列下今天哪些录音"、"audioId 是多少"——那是
+`wangxiaobao-audio-query` skill 的事（直接走录音元数据 API，更快也更精确）。
+本 skill 是问"开放式业务问题"用的，不是数据列表 API 代理。
+
+---
+
+## 使用场景示例
+
+### 场景 1：问客户来访
+
+```jsonc
+// xiaobao_quick_qa
+{ "prompt": "今天到访了多少组客户，里面有几组是首访？" }
+```
+
+渲染：
+
+```
+今天到访 18 组，其中：
+- 首访 11 组（61%）
+- 复访 7 组
+
+💡 想接着问可以告诉我，会沿用本次对话上下文。
+```
+
+### 场景 2：问销冠
+
+```jsonc
+{ "prompt": "本月销冠是谁，业绩多少？" }
+```
+
+渲染：
+
+```
+本月销冠：张三
+- 成交 8 单 / 金额 1240 万
+- 跟进客户 47 组，成交转化率 17%
+```
+
+### 场景 3：问录音覆盖率
+
+```jsonc
+{ "prompt": "本周录音覆盖率怎么样？哪些销售覆盖低？" }
+```
+
+渲染：
+
+```
+本周录音覆盖率 78%（45 个销售里 35 个开了工牌录音）。
+覆盖偏低的销售（< 50%）：
+1. 李四（22%）
+2. 王五（38%）
+3. 赵六（45%）
+```
+
+### 场景 4：接着追问（多轮）
+
+用户："那张三跟客户讲到学区时通常怎么应对？"
+（接着上一轮 ——agent 自己存了 threadId）
+
+```jsonc
+{
+  "prompt": "那张三跟客户讲到学区时通常怎么应对？",
+  "threadId": "<上一轮 resp.data.data.thread_id>"
+}
+```
+
+### 场景 5：带额外 context
+
+```jsonc
+{
+  "prompt": "评估一下这个客户的成交概率",
+  "context": {
+    "customer_id": 12345,
+    "recent_audio_ids": [9001, 9023, 9045]
+  }
+}
+```
+
+---
+
+## 典型问数关键词参考
+
+帮 agent 识别用户意图。看到这类词就走本 skill：
+
+- **客户类**：客户、新客、老客、意向客、成交客、客户画像、客户分级、回访
+- **来访类**：到访、来访、首访、复访、上门、到店、客流
+- **挖需 / 转化**：挖需率、转化率、意向、成交率、跟进、转化漏斗
+- **销售 / 销冠**：销冠、销售排行、业绩、佣金、TOP、成单
+- **录音 / 接待**：录音、通话、对话、接待、覆盖率、时长
+- **业务指标**：成单、签约、定金、退订、回款、佣金
+
+---
+
+## 常见错误与排查
+
+- **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目 → 跑
+  `wangxiaobao-switch-project` skill 后重试
+- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登，重试一次
+- **响应耗时 > 30 分钟** — 后端慢到打满 plugin timeout → 告诉用户"上游慢，稍后重试"
+- **answer 为空** — 上游这一轮没产出最终文本 → 让用户换个 prompt 重试
+- **用户想"批量出报告"** — 拦住：本期 plugin 没有报告生成 skill，
+  解释"出长报告的功能在做异步化改造，下期发布"
+- **用户问"列录音元数据 / audioId 是多少"** — 切到
+  `wangxiaobao-audio-query` skill，那个走元数据 API 更精确