openclaw-voc-skill/docs/voc-skill-student-course/01-workspace-setup.md

01 工作区准备与 VOC 技能检查

本节目标：让学员确认 Claude Code 能识别 VOC 技能包，并能跑通 smoke 检查。

第一步：打开课程工作区

操作：

1. 打开 VS Code。
2. 选择课程工作区文件夹。
3. 打开终端。

截图位置：

【截图 01-01：VS Code 打开课程工作区】

下一步：检查 Node 和 npx。

第二步：检查 Node 和 npx

在 VS Code 终端输入：

node --version
npm --version
npx --version

正常结果：

三条命令都返回版本号。

截图位置：

【截图 01-02：node/npm/npx 版本号】

下一步：安装 VOC 技能包到当前工作区。

第三步：安装 VOC 技能包

在课程工作区终端执行：

npx --yes @vocmarket/voc-skill@latest workspace --smoke

正常结果里应该能看到：

VSCode workspace mode is ready.
Generated project files:
.\.mcp.json
.\.claude\skills\...
.\.claude\plugins\voc-intelligence

截图位置：

【截图 01-03：运行 workspace --smoke 命令】
【截图 01-04：安装成功输出】

下一步：检查生成文件。

第四步：检查文件是否生成

在终端输入：

dir .\.claude\plugins
dir .\.claude\skills
dir .\.mcp.json

正常结果：

.claude/plugins 下面有 voc-intelligence
.claude/skills 下面有小红书、抖音、问题池、单点深挖、内容计划等技能入口
当前工作区有 .mcp.json

截图位置：

【截图 01-05：.claude/plugins 和 .claude/skills 目录】

下一步：重启 Claude Code 会话。

第五步：重启 Claude Code

操作：

1. 关闭当前 Claude Code 会话。
2. 重新打开 Claude Code。

3. 输入：

   你好，请确认当前工作区是否可以使用 VOC 技能。
   

截图位置：

【截图 01-06：Claude Code 重启后正常回复】

下一步：进入 sample 模式跑第一份趋势情报。

常见问题

npx 无法识别

处理：

1. 关闭 VS Code 终端。
2. 重新打开终端。
3. 重新执行版本检查。
4. 仍然失败时安装 Node.js LTS。

安装成功但 Claude Code 不触发技能

处理：

1. 检查 .claude/skills 是否存在。
2. 检查 .mcp.json 是否存在。
3. 重启 Claude Code。
4. 在提示词里明确写“请使用已安装的 VOC 技能，不要凭经验回答”。

本节验收

• 能看到 voc-intelligence 插件目录。
• 能看到 8 个 skill 入口。
• workspace --smoke 通过。
• Claude Code 能正常对话。