# Claude Code VOC Intelligence

Claude Code 原生版 VOC 技能包。

当前第一阶段聚焦“小红书趋势情报官”，用于从小红书内容和评论中发现行业趋势、用户顾虑、设计元素、内容选题和待验证门店话术。

## 当前范围

- `xiaohongshu-trend-intelligence`：小红书趋势情报官 Skill。
- sample 模式：无需 token，可用于教学、录屏和流程验证。
- live 模式：已接入小红书/TikHub token 检查和 provider 骨架，真实采集需有效 token。
- 偏好记忆：用户回答动态校准问题，或说“保留/不要/更偏”后，会保存到记忆，下一轮报告会基于反馈收敛。

## 用户入口话术

```text
帮我做一份家装全屋定制行业的小红书趋势情报。
重点看女性客户下季度可能关注的设计元素、风格和消费顾虑。
先在聊天里给我第一轮样本观察和待确认问题，不要只给文件路径。
```

## 客户演示文档

- `docs/customer-quickstart.md`：给客户/助教看的快速说明。
- `docs/demo-runbook.md`：录制教学视频时可直接参考的分段脚本。
- `docs/npm-packaging-notes.md`：npm 与 zip 双交付方式的打包经验。

## 技术路线

第一阶段：

- Claude Code Skill 负责自然语言工作流。
- 本地工具模块负责生成 sample 趋势报告。
- MCP tools 负责 sample/live 采集、趋势报告、偏好更新。
- 输出统一返回 `assistantMessage`。

当前 MCP tools：

- `voc_xiaohongshu_token_check`
- `voc_xiaohongshu_trend_run`
- `voc_xiaohongshu_preference_update`

## 本地测试

在仓库根目录执行：

```bash
npm --prefix claude-code-voc-intelligence run xhs:sample
npm --prefix claude-code-voc-intelligence run xhs:preference-smoke
npm --prefix claude-code-voc-intelligence run xhs:sample-with-memory
npm --prefix claude-code-voc-intelligence run mcp:smoke
```

真实采集前先配置小红书/TikHub token：

```bash
set XIAOHONGSHU_API_TOKEN=你的token
npm --prefix claude-code-voc-intelligence run xhs:live
```

如果没有 token，live 模式会返回 `needs_token`，不会误用 OpenClaw VOC token。

## 打包交付

在仓库根目录执行：

```bash
npm run claude-voc:build
```

该命令会生成：

```text
dist/claude-code-voc-intelligence.zip
dist/claude-code-voc-intelligence-suite-manifest.json
```

并在临时目录里解压、重新安装依赖、跑 sample / preference / MCP smoke。

用户拿到 zip 后的安装方式：

```bash
node install.js
```

如果要顺手验证完整 sample 链路：

```bash
node install.js --smoke
```

`--smoke` 会输出简洁检查结果，不会把完整报告 JSON 打满屏幕。

## npm 安装

全局安装：

```bash
npm install -g @gangvy/claude-code-voc-intelligence
claude-voc install
```

免全局安装：

```bash
npx @gangvy/claude-code-voc-intelligence install
```

两种方式都会把技能包安装到：

```text
~/.claude/plugins/voc-intelligence
```

安装后按提示用 `claude --plugin-dir` 加载即可。

npm 本地打包验证：

```bash
npm run claude-voc:npm-pack
```

上传到 CDN 需要先配置七牛环境变量：

```bash
set QINIU_AK=...
set QINIU_SK=...
npm run claude-voc:upload
```

Claude Code 插件开发态加载：

```bash
claude --plugin-dir ./claude-code-voc-intelligence
```

进入 Claude Code 后可直接调用：

```text
/voc-intelligence:xiaohongshu-trend-intelligence
```

MCP server 启动命令：

```bash
npm --prefix claude-code-voc-intelligence run mcp:start
```