## Skill 安装到 Claude Code（Windows）

skill 是 Claude Code 的扩展能力。Claude Code 启动时会自动扫描指定目录，把 SKILL.md 注册成可调用的能力。

### Step 0: 安装 Claude Code（如果还没装）

Claude Code 在 Windows 的安装方式：

```powershell
npm install -g @anthropic-ai/claude-code
```

验证：
```powershell
claude --version
```

### Step 1: 找到 skill 目录

Claude Code 在 Windows 上的全局 skills 目录：

```
C:\Users\你的用户名\.claude\skills\
```

如果这个目录不存在，手动创建。或者你也可以用「项目级」skill 目录（`项目根目录/.claude/skills/`）——录制时建议用项目级，跟 Mac 行为一致。

### Step 2: 把两个 skill 复制过去

把资源包里的 `skills/huashu-data-pro/` 和 `skills/huashu-doc-reviewer/` 整个复制到上面那个目录。

最终目录结构应该是：

```
C:\Users\你的用户名\.claude\skills\
├── huashu-data-pro\
│   ├── SKILL.md
│   ├── scripts\
│   ├── examples\
│   ├── references\
│   └── test-prompts.json
└── huashu-doc-reviewer\
    ├── SKILL.md
    ├── scripts\
    ├── examples\
    ├── references\
    └── test-prompts.json
```

### Step 3: 安装 huashu-data-pro 的 Node 依赖

参考 `2-Node依赖.txt`：

```powershell
cd C:\Users\你的用户名\.claude\skills\huashu-data-pro\scripts
npm install
npx playwright install chromium
```

huashu-doc-reviewer 是纯 Python，不需要 npm install。

### Step 4: 启动 Claude Code 验证

在任意目录打开 PowerShell：

```powershell
claude
```

进入 Claude Code 交互界面后输入：

```
/skills list
```

应该能看到 `huashu-data-pro` 和 `huashu-doc-reviewer` 都在列表里。

### Step 5: Claude Code 接本地模型（关键一步）

**主路径：用 Ollama 的快捷命令（推荐）**

```powershell
ollama launch claude
```

这条命令会自动配好 Claude Code 接到本地 Ollama 的端口 + 当前默认模型。需要 Ollama 版本 ≥ v0.14.0。

启动 Claude Code 后，**右上角应该显示 `qwen3.6:35b-a3b`**（或你 Ollama 默认拉的模型名）。这是脚本里那句「看右上角，模型名不是 Claude 是 qwen3.6:35b-a3b」对应的画面。

**备路径：手动通过环境变量接入**

如果 `ollama launch claude` 失败，按 `3-环境变量配置.txt` 设好 LOCAL_LLM_BASE_URL，启动 Claude Code 时它会自动读取走本地模型。

### Step 6: 验证 skill + 本地模型联动

在 Claude Code 里输入：

```
帮我审一下这份合同。
（拖入 skills\huashu-doc-reviewer\examples\sample_contract.docx）
```

应该看到：
- Claude Code 调用 huashu-doc-reviewer skill
- 终端打印 decisions injected 进度
- 生成 sample_contract.reviewed.docx
- **整个过程模型走本地，不联网也跑得动**（拔掉网线测一次最稳）

如果跑不动，回到 `3-环境变量配置.txt` 检查 LOCAL_LLM_BASE_URL 是否设对、server 是否真的在跑。

---

## 常见问题

**Q: 提示 `LOCAL_LLM_BASE_URL not set`**
A: 没设环境变量。回到 `3-环境变量配置.txt` 一步步设。

**Q: 提示 `Connection refused`**
A: Ollama 进程没跑或者端口被占用。任务管理器看 `ollama.exe`，没有就在开始菜单启动 Ollama。或者：`ollama serve` 手动启动。

**Q: 跑得很慢（每秒 2 个 token）**
A: GPU 没用上。检查 `OLLAMA_NUM_GPU=999` 环境变量是否生效，回到「录制Best-Practice.md」§1.4 排查。

**Q: skill 不出现在 /skills list 里**
A: 路径不对，或者 SKILL.md 损坏。检查目录结构是否完整。