openclaw-voc-skill/claude-code-voc-intelligence

Claude Code VOC Intelligence

Claude Code 原生版 VOC 技能包。

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

当前范围

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

用户入口话术

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

客户演示文档

• 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

本地测试

在仓库根目录执行：

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：

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

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

打包交付

在仓库根目录执行：

npm run claude-voc:build

该命令会生成：

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

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

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

node install.js

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

node install.js --smoke

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

npm 安装

全局安装：

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

免全局安装：

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

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

~/.claude/plugins/voc-intelligence

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

npm 本地打包验证：

npm run claude-voc:npm-pack

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

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

Claude Code 插件开发态加载：

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

进入 Claude Code 后可直接调用：

/voc-intelligence:xiaohongshu-trend-intelligence

MCP server 启动命令：

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