旺小宝智能问答

要解决什么问题

销售、运营或客服在对话里经常要问的是业务事实，而不是「先帮我查 user-id 再拼接口」：例如「张三本周成交几单」「客户主要疑虑是什么」。这类问题如果每次都走报表导出或手写 SQL，成本高；如果让 Agent 乱写文件、改 wiki，又容易留下脏状态。

本技能封装的是 xiaobao-cli qa：用自然语言问当前激活项目的业务数据，CLI 侧只读、零副作用——不写文件、不动 wiki，问错了也没有持久化成本，适合在对话里反复试探。

技能如何工作

执行前需满足与旺小宝 CLI 系列一致的约定（登录、auth whoami、激活项目等，见共享文档 wangxiaobao-shared）。不要由调用方传入 tenant / project：命令从「当前激活项目」读上下文；若返回 NO_ACTIVE_PROJECT，应先切换项目再重试。

| 场景 | 用法要点 |
|------|----------|
| 单轮问数 | prompt 原样传给命令 |
| 多轮追问 | 首轮不传 threadId；响应里的 thread_id 由 Agent 记在会话上下文，后续通过 --thread-id 回传 |
| 附带背景 | 可选 context: {...}，勿塞过大上下文 |

核心原则：用业务语言问，不要替用户查 ID。「张三」这类称呼直接写进 prompt，后端会在项目内解析实体；开放性问题也不要画蛇添足拼时间窗或 ID 列表。

对用户只展示响应中的 answer 文本（外包在 status / ok / data 结构里取 resp.data.data.answer）。需要支持追问时，可在结尾提示用户可继续问，threadId 由 Agent 维护，不要写入文件或 .env；跨 session 不延续，新开一轮即可。

适用边界与注意点

• 禁止写文件：即用户说「顺便存一下」也要说明长报告/落盘能力未在本期 CLI 发布，可复制回答自行保存。
• context 宜小：过大易导致上游慢、打满 CLI 超时，应让用户稍后重试。
• answer 为空：换表述重试，不要臆造结论。
• 批量出报告：本期无报告生成 skill，异步化改造中。
• 录音元数据 / audioId：应切到 wangxiaobao-audio-query 等元数据 API 技能，精度更高。