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

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

## 第一步：打开课程工作区

操作：

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

截图位置：

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

下一步：检查 Node 和 npx。

## 第二步：检查 Node 和 npx

在 VS Code 终端输入：

```powershell
node --version
npm --version
npx --version
```

正常结果：

```text
三条命令都返回版本号。
```

截图位置：

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

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

## 第三步：安装 VOC 技能包

在课程工作区终端执行：

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

正常结果里应该能看到：

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

截图位置：

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

下一步：检查生成文件。

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

在终端输入：

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

正常结果：

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

截图位置：

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

下一步：重启 Claude Code 会话。

## 第五步：重启 Claude Code

操作：

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

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

截图位置：

```text
【截图 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 能正常对话。