@puyinkai/xiaobao-cli 0.1.0 → 0.1.8

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

@@ -1,86 +1,43 @@
 ---
 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" → 本期不支持
+version: 0.1.0
+description: "旺小宝客户画像分页查询：按 置业顾问 / 客户姓名 / 手机号 / 画像关键词（dynamic_tags JSON LIKE） / 最后来访时间窗 维度过滤，排序固定 last_visit_time DESC。只读、不写文件、无副作用。高频命令: xiaobao-cli customer list [--user-id <id>] [--user-name <n>] [--customer-name <n>] [--customer-phone <p>] [--portrait <kw>] [--from <date>] [--to <date>] [--page N] [--size N]。何时用：用户问客户列表/我的客户/高意向客户/近期来访客户/某顾问名下的客户/某顾问这周新增哪些客户/姓张的客户/手机号 138 的客户/5 月份来过的客户；按画像找如高意向/价格敏感/看四房用 --portrait。注：顾问名→user-id 先用 xiaobao-cli consultant list 反查；要来访记录走 visit-query；要录音元数据走 audio-query。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli customer --help"
 ---
 
-> **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 查当前激活项目的客户画像列表。
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
+跑 `xiaobao-cli customer list` 查当前激活项目的客户画像列表。
 零副作用，鼓励放心调用。
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao_whoami`；未登录就 `xiaobao_authorize`
-- **必须有激活项目**：tool 内部自动读，如果返回 `NO_ACTIVE_PROJECT` 就跑
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- **必须有激活项目**：命令内部自动读，如果返回 `NO_ACTIVE_PROJECT` 就跑
   `wangxiaobao-switch-project` skill
 - **数据权限隔离**：后端按"当前用户授权可见的顾问范围"过滤（普通顾问看自己 /
   团队长看团队 / 项目管理员看全项目）。当前用户无权访问的顾问名下客户**看不到**——
   这不是 bug
-- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），plugin 自动转 ISO
+- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），CLI 自动转 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`   |
+| 列全部客户（最近来访的在前）   | `xiaobao-cli customer list`   | `--page` / `--size`                    |
+| 看某顾问名下客户               | `xiaobao-cli consultant list` → `xiaobao-cli customer list` | `--user-id <反查的 id>` |
+| 按客户画像找                   | `xiaobao-cli customer list`   | `--portrait 高意向` 等            |
+| 按客户姓名 / 手机号模糊        | `xiaobao-cli customer list`   | `--customer-name` / `--customer-phone`   |
+| 按最后来访时间筛               | `xiaobao-cli customer list`   | `--from` / `--to`              |
+| 估算总数                       | `xiaobao-cli customer list`   | `--page 1 --size 1`，只读 `total`   |
 
 ---
 
@@ -91,9 +48,9 @@ description: |
 用户说"张三的客户"——**不要**直接传 `userName: "张三"`（虽然支持但是 LIKE 模糊）。
 正确做法：
 
-1. 调 `xiaobao_list_consultants` 拿当前授权范围内的顾问列表
-2. 找 `userName === "张三"` 的 `userId`
-3. 调 `xiaobao_list_customers { userId: <张三的 userId> }` 精确过滤
+1. 调 `xiaobao-cli consultant list` 拿当前授权范围内的顾问列表
+2. 找 `userName === "张三"` 的 `--user-id`
+3. 调 `xiaobao-cli customer list { userId: <张三的 userId> }` 精确过滤
 
 如果 list-consultants 里**找不到张三**——说明当前用户没权限看张三名下数据，
 告诉用户"当前账号无权访问销售『张三』"，不要再硬试。
@@ -102,8 +59,8 @@ description: |
 
 后端在 `dynamic_tags` JSON 文本上 `LIKE '%xxx%'`。所以：
 
-- `portrait: "高意向"` 命中 `{"高意向客户":"高意向客户"}` / `{"AI意向判定":"高意向"}` 等
-- `portrait: "价格"` 命中 `{"抗性点":"价格"}` 等
+- `--portrait 高意向` 命中 `{"高意向客户":"高意向客户"}` / `{"AI意向判定":"高意向"}` 等
+- `--portrait 价格` 命中 `{"抗性点":"价格"}` 等
 - 不要传完整 JSON / key=value 形式（不支持，反而匹不到）
 
 ### 3. 时间窗：用户没明确说就推断
@@ -120,11 +77,11 @@ description: |
 
 ### 4. 分页：page 从 **1** 开始
 
-PageParam 默认 `page: 1, size: 10`。传 `page: 0` 报错。`size` 上限 500。
+PageParam 默认 `--page 1 --size 10`。传 `page: 0` 报错。`--size` 上限 500。
 
 ### 5. 响应外层
 
-`xiaobao_list_customers` 返回：
+`xiaobao-cli customer list` 返回：
 
 ```jsonc
 {
@@ -150,7 +107,7 @@ PageParam 默认 `page: 1, size: 10`。传 `page: 0` 报错。`size` 上限 500
 }
 ```
 
-plugin tool 又外包一层 `{ status, ok, data }` —— 取数据用 `resp.data.data.content`。
+CLI 又包一层 `{ status, ok, data }` —— 取数据用 `resp.data.data.content`。
 
 ---
 
@@ -158,8 +115,8 @@ plugin tool 又外包一层 `{ status, ok, data }` —— 取数据用 `resp.dat
 
 ### 场景 1：列我能看到的高意向客户
 
-```jsonc
-{ "portrait": "高意向", "page": 1, "size": 20 }
+```bash
+xiaobao-cli customer list --portrait 高意向 --page 1 --size 20
 ```
 
 渲染：
@@ -173,31 +130,25 @@ plugin tool 又外包一层 `{ status, ok, data }` —— 取数据用 `resp.dat
 
 ### 场景 2：陈平名下的客户
 
-```jsonc
-// step 1
-// xiaobao_list_consultants
-{}
-
-// step 2 ——找到陈平的 userId = 270078836362715136
-// step 3
-// xiaobao_list_customers
-{ "userId": 270078836362715136, "page": 1, "size": 20 }
+```bash
+# step 1: 反查陈平的 user-id
+xiaobao-cli consultant list
+
+# step 2: 假设找到陈平的 userId = 270078836362715136
+# step 3: 用 --user-id 过滤
+xiaobao-cli customer list --user-id 270078836362715136 --page 1 --size 20
 ```
 
 ### 场景 3：5 月来访的客户里抗性是价格的
 
-```jsonc
-{
-  "portrait": "价格",
-  "fromDate": "2026-05-01 00:00:00",
-  "toDate":   "2026-06-01 00:00:00"
-}
+```bash
+xiaobao-cli customer list --portrait 价格 --from "2026-05-01 00:00:00" --to "2026-06-01 00:00:00"
 ```
 
 ### 场景 4：估算总数
 
-```jsonc
-{ "page": 1, "size": 1 }
+```bash
+xiaobao-cli customer list --page 1 --size 1
 ```
 
 回复：「当前授权范围下共 1247 位客户」。
@@ -207,7 +158,7 @@ plugin tool 又外包一层 `{ status, ok, data }` —— 取数据用 `resp.dat
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登
+- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
 - **`total: 0`** — 时间窗口 / 过滤条件没匹配到，**或**当前用户授权范围为空
   （新人顾问刚入职 / 团队成员被移走等）
 - **顾问名找不到** — 不在当前用户授权可见范围内；不要硬调 list_customers 试

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

@@ -1,89 +1,43 @@
 ---
 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`
+version: 0.1.0
+description: "旺小宝客户抗性点（resistance）分页查询 —— AI 在客户对话里抽出的客户疑虑 / 反对 / 不满标签（价格高 / 户型差 / 地段差 / 装修不满 等）。schema 与 focus 镜像，仅底层 MV 表不同。按 visit/customer/audio ID 列表 + 一级/二级分类模糊 + 来访时间窗组合过滤，排序固定 visit_time DESC。每条 tag 带 customer + userInfo + audio + value_str + text_fragment。只读、不写文件。高频命令: xiaobao-cli resistance list [--visit-ids a,b] [--customer-ids a,b] [--audio-ids a,b] [--category <kw>] [--classification <kw>] [--from <date>] [--to <date>] [--page N] [--size N]。何时用：用户问客户抗性/客户疑虑/客户反对/客户嫌/客户担心/不满意/价格抗性/户型抗性/地段抗性/TOP 抗性原因/销售应对话术；用户想看销售应该重点准备哪些应对话术。注：客户名→wang_id 先用 xiaobao-cli customer list 反查；问关注/兴趣/偏好走 focus-query；问完整录音文本走 audio-query。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli resistance --help"
 ---
 
-> **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 抽出的客户抗性点标签。
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
+跑 `xiaobao-cli resistance list` 查 AI 抽出的客户抗性点标签。
 跟关注点 skill 镜像，差别就是底层走 `mv_open_customer_resistance` 表 ——
 **抗性 = 客户疑虑 / 反对 / 不满**（关注 = 客户主动表达的关心）。
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao_whoami`；未登录就 `xiaobao_authorize`
-- **必须有激活项目**：tool 内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- **必须有激活项目**：命令内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
 - **数据权限隔离**：按当前用户授权可见顾问范围过滤（普通顾问看自己 /
   团队长看团队 / 项目管理员看全项目）
-- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），plugin 自动转
+- LocalDateTime 格式：`yyyy-MM-dd HH:mm:ss`（空格分隔），CLI 自动转
 - **不要**写文件、出报告
 
 ---
 
 ## 快速索引：意图 → 工具
 
-| 用户意图                             | 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`   |
+| 列时段内全部抗性点                   | `xiaobao-cli resistance list`     | `--from` / `--to`              |
+| 看某客户的抗性                       | `xiaobao-cli customer list` → `xiaobao-cli resistance list` | `--customer-ids <wang_id>` |
+| 看某次到访的抗性                     | `xiaobao-cli resistance list`     | `--visit-ids <visit_id>`           |
+| 看某条录音的抗性                     | `xiaobao-cli resistance list`     | `--audio-ids <audio_id>`           |
+| 按分类找（一级）                     | `xiaobao-cli resistance list`     | `--category 价格` 等              |
+| 按分类找（二级）                     | `xiaobao-cli resistance list`     | `--classification 价格因素`        |
+| 估算总数                             | `xiaobao-cli resistance list`     | `--page 1 --size 1`，只读 `total`   |
 
 ---
 
@@ -91,8 +45,8 @@ description: |
 
 ### 1. 客户名 → wang_id 反查
 
-用户说"屈哥的抗性"——先调 `xiaobao_list_customers { customerName: "屈哥" }` 拿到
-`customerId`，再传 `customerIds` 数组。
+用户说"屈哥的抗性"——先调 `xiaobao-cli customer list { customerName: "屈哥" }` 拿到
+`--customer-id`，再传 `--customer-ids` 数组。
 
 ### 2. 分类模糊：一级 + 二级二选一或同时用
 
@@ -153,7 +107,7 @@ classification 二级常见值：户型因素 / 价格因素 / 环境因素 / ..
 ### 6. TOP 抗性原因聚合
 
 用户问"我们项目客户最大的抗性是什么"——拉一页 `size: 100`，agent 后处理按
-`category` 聚合输出："5 月共 89 条抗性：价格因素 42 条（47%）/ 户型因素 23 条 /
+`--category` 聚合输出："5 月共 89 条抗性：价格因素 42 条（47%）/ 户型因素 23 条 /
 环境因素 12 条 / ..."。
 
 ---
@@ -162,20 +116,16 @@ classification 二级常见值：户型因素 / 价格因素 / 环境因素 / ..
 
 ### 场景 1：本月客户最主要的抗性
 
-```jsonc
-{
-  "fromDate": "2026-05-01 00:00:00",
-  "toDate":   "2026-06-01 00:00:00",
-  "page": 1, "size": 100
-}
+```bash
+xiaobao-cli resistance list --from "2026-05-01 00:00:00" --to "2026-06-01 00:00:00" --page 1 --size 100
 ```
 
 按 category 聚合 → "本月 89 条抗性中价格类占 47%，户型 26%，..."。
 
 ### 场景 2：价格抗性的具体说法
 
-```jsonc
-{ "category": "价格", "page": 1, "size": 20 }
+```bash
+xiaobao-cli resistance list --category 价格 --page 1 --size 20
 ```
 
 列出 20 条价格抗性原文，让 LLM 帮销售总结"客户主要嫌车位价高、楼层差价大、
@@ -183,18 +133,14 @@ classification 二级常见值：户型因素 / 价格因素 / 环境因素 / ..
 
 ### 场景 3：屈哥这次到访都嫌什么
 
-```jsonc
-{ "visitIds": ["510395382098829312"], "page": 1, "size": 50 }
+```bash
+xiaobao-cli resistance list --visit-ids 510395382098829312 --page 1 --size 50
 ```
 
 ### 场景 4：户型 + 时间窗组合
 
-```jsonc
-{
-  "category":  "户型",
-  "fromDate":  "2026-05-01 00:00:00",
-  "toDate":    "2026-06-01 00:00:00"
-}
+```bash
+xiaobao-cli resistance list --category 户型 --from "2026-05-01 00:00:00" --to "2026-06-01 00:00:00"
 ```
 
 回复："5 月户型抗性 23 条，主要集中在'房间小'（11）/'朝向不好'（5）/'楼间距'（4）..."。
@@ -204,7 +150,7 @@ classification 二级常见值：户型因素 / 价格因素 / 环境因素 / ..
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登
+- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
 - **`total: 0`** — 过滤条件没匹配 / 该时段没数据 / 当前用户授权范围内没匹配的接待顾问
 - **抗性点 vs 关注点**：跟 LLM 强调"抗性"是负面（疑虑/反对），"关注"是中性偏正
   （主动关心）；用户说"嫌弃 / 担心 / 不满"走抗性，"在意 / 关心 / 偏好"走关注

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

@@ -1,71 +1,25 @@
 ---
 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
+version: 0.1.0
+description: "旺小宝业务数据问数（自然语言）：用一句话问当前激活项目的客户 / 来访 / 挖需率 / 销冠 / 录音覆盖率 / 业务指标等开放式问题，AI 直接基于旺小宝数据回答。只读、无副作用、超时 30 分钟。多轮追问通过 --thread-id 续接。高频命令: xiaobao-cli qa '<prompt>' [--thread-id <id>]。何时用：用户问今天来了几个客户/本周新增多少客户/意向客户都有谁/老客户回访/今天到访多少组/首访 vs 复访比/挖需率/成交转化率/客户分级分布/本月销冠是谁/张三这周成交几单/销售排行榜/业绩 TOP3/录音覆盖率/哪些销售有几条录音/本周通话时长 TOP5/未跟进客户有多少；任何问一句旺小宝业务数据的开放式问题。注：要列录音元数据走 audio-query 更快；批量同步录音文本到 wiki 走 audio-wiki。"
+metadata:
+  requires:
+    bins: ["xiaobao-cli"]
+  cliHelp: "xiaobao-cli qa --help"
 ---
 
-> **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 用自然语言问当前激活项目的业务数据。
+> **CRITICAL** —— 跑命令前 MUST 先用 Read tool 读取 [`../wangxiaobao-shared/SKILL.md`](../wangxiaobao-shared/SKILL.md)（一份共享文档讲清安装 / 登录 / 选项目 / 错误码 / 输出协议等所有 xiaobao-cli 命令通用的前置约定）。
+
+跑 `xiaobao-cli qa` 用自然语言问当前激活项目的业务数据。
 零副作用，不写文件、不动 wiki，所以用错也没成本，鼓励放心调用。
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao_whoami`；未登录 / 过期就调 `xiaobao_authorize`
-- **必须有激活项目**：tool 内部自动从激活项目状态读 tenant/project，
-  调用方**不要传** tenant/project 参数。如果 tool 返回
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录 / 过期就调 `xiaobao-cli auth login`
+- **必须有激活项目**：命令内部自动从激活项目状态读 tenant/project，
+  调用方**不要传** tenant/project 参数。如果 命令 返回
   `error: 'NO_ACTIVE_PROJECT'`，让用户跑 `wangxiaobao-switch-project` skill
   后再重试
 - **绝不要**写文件。即使用户随口说"顺便存一下"也要拦——告诉用户"出长报告
@@ -75,11 +29,11 @@ description: |
 
 ## 快速索引：意图 → 工具
 
-| 用户意图                           | plugin tool        | 关键参数                              |
+| 用户意图                           | 命令        | 关键参数                              |
 | ---------------------------------- | ------------------ | ------------------------------------- |
-| 单轮问数                           | `xiaobao_quick_qa` | `prompt`                              |
-| 接着上一轮继续追问                 | `xiaobao_quick_qa` | `prompt + threadId`                   |
-| 给问题加上下文（如客户 ID 列表）    | `xiaobao_quick_qa` | `prompt + context: {...}`             |
+| 单轮问数                           | `xiaobao-cli qa` | `prompt`                              |
+| 接着上一轮继续追问                 | `xiaobao-cli qa` | `prompt + threadId`                   |
+| 给问题加上下文（如客户 ID 列表）    | `xiaobao-cli qa` | `prompt + context: {...}`             |
 
 ---
 
@@ -87,7 +41,7 @@ description: |
 
 ### 1. 用业务语言问，不要追问 ID
 
-用户问"张三本周成交几单"——直接把 prompt 原样传给 tool，**不要**先去查
+用户问"张三本周成交几单"——直接把 prompt 原样传给 命令，**不要**先去查
 张三的 user-id 再拼参数。后端 AI 知道"张三"在当前项目里就是谁。
 
 如果用户问的是开放性问题（"客户主要疑虑是啥"），更不要画蛇添足拼任何
@@ -95,15 +49,15 @@ ID / 时间窗口——AI 会自己定义合理范围。
 
 ### 2. 多轮：threadId 由 agent 自己接续
 
-第一轮**不传** `threadId`，走单轮模式。响应里有 `resp.data.data.thread_id`，
-**记在 agent 当前对话上下文里**，后续追问把它原样传回 `threadId` 入参。
+第一轮**不传** `--thread-id`，走单轮模式。响应里有 `resp.data.data.thread_id`，
+**记在 agent 当前对话上下文里**，后续追问把它原样传回 `--thread-id` 入参。
 **不要**把 thread_id 写到任何文件 / .env / 状态——它只是会话短期记忆。
 
 跨 session（用户关了 chat）就**不再延续**，新 session 重新发起新一轮即可。
 
 ### 3. 响应只取 answer 给用户
 
-`xiaobao_quick_qa` 返回结构：
+`xiaobao-cli qa` 返回结构：
 
 ```jsonc
 {
@@ -118,7 +72,7 @@ ID / 时间窗口——AI 会自己定义合理范围。
 }
 ```
 
-plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本写
+CLI 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本写
 `resp.data.data.answer`，渲染给用户**只展示 answer**。
 
 如果要支持后续追问，结尾加一句"💡 想接着问可以告诉我，会沿用本次对话上下文"
@@ -127,7 +81,7 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 ### 4. 不要拉太多上下文进 context
 
 `context` 字段可以塞额外背景，但**控制在 < 4KB**。需要塞大块录音 / 客户
-档案的需求暂时没有 plugin 侧支持——用户可以分多轮 prompt 喂，每轮塞一段。
+档案的需求暂时没有 CLI 侧支持——用户可以分多轮 prompt 喂，每轮塞一段。
 
 ### 5. 不要替代 audio-query 做"列录音元数据"
 
@@ -141,9 +95,8 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 
 ### 场景 1：问客户来访
 
-```jsonc
-// xiaobao_quick_qa
-{ "prompt": "今天到访了多少组客户，里面有几组是首访？" }
+```bash
+xiaobao-cli qa "今天到访了多少组客户，里面有几组是首访？"
 ```
 
 渲染：
@@ -158,8 +111,8 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 
 ### 场景 2：问销冠
 
-```jsonc
-{ "prompt": "本月销冠是谁，业绩多少？" }
+```bash
+xiaobao-cli qa "本月销冠是谁，业绩多少？"
 ```
 
 渲染：
@@ -172,8 +125,8 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 
 ### 场景 3：问录音覆盖率
 
-```jsonc
-{ "prompt": "本周录音覆盖率怎么样？哪些销售覆盖低？" }
+```bash
+xiaobao-cli qa "本周录音覆盖率怎么样？哪些销售覆盖低？"
 ```
 
 渲染：
@@ -191,25 +144,21 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 用户："那张三跟客户讲到学区时通常怎么应对？"
 （接着上一轮 ——agent 自己存了 threadId）
 
-```jsonc
-{
-  "prompt": "那张三跟客户讲到学区时通常怎么应对？",
-  "threadId": "<上一轮 resp.data.data.thread_id>"
-}
+```bash
+xiaobao-cli qa "那张三跟客户讲到学区时通常怎么应对？" --thread-id "<上一轮 resp.data.data.thread_id>"
 ```
 
-### 场景 5：带额外 context
+### 场景 5：带额外 context（v0.1.x 暂不支持）
 
-```jsonc
-{
-  "prompt": "评估一下这个客户的成交概率",
-  "context": {
-    "customer_id": 12345,
-    "recent_audio_ids": [9001, 9023, 9045]
-  }
-}
+CLI 当前只暴露 `--thread-id`，不支持 `--context` JSON 入参。要给 AI 喂上下文，
+**把上下文直接写进 prompt** 即可：
+
+```bash
+xiaobao-cli qa "评估一下客户 12345 的成交概率，相关录音 audioId: 9001, 9023, 9045"
 ```
 
+后端 AI 会从 prompt 文本里识别 customer_id / audio 引用。
+
 ---
 
 ## 典型问数关键词参考
@@ -229,10 +178,10 @@ plugin tool 又把上面塞进 `{ status, ok, data }` 外包：拿最终文本
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目 → 跑
   `wangxiaobao-switch-project` skill 后重试
-- **401 / token 过期** — 调 `xiaobao_authorize { force: true }` 重登，重试一次
-- **响应耗时 > 30 分钟** — 后端慢到打满 plugin timeout → 告诉用户"上游慢，稍后重试"
+- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登，重试一次
+- **响应耗时 > 30 分钟** — 后端慢到打满 CLI timeout → 告诉用户"上游慢，稍后重试"
 - **answer 为空** — 上游这一轮没产出最终文本 → 让用户换个 prompt 重试
-- **用户想"批量出报告"** — 拦住：本期 plugin 没有报告生成 skill，
+- **用户想"批量出报告"** — 拦住：本期 CLI 没有报告生成 skill，
   解释"出长报告的功能在做异步化改造，下期发布"
 - **用户问"列录音元数据 / audioId 是多少"** — 切到
   `wangxiaobao-audio-query` skill，那个走元数据 API 更精确