# Cnb Npc Search

> 搜索 NPC 角色。

- Skill: `eryajf/cnb-npc-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eryajf/cnb-npc-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eryajf/cnb-npc-search/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eryajf (https://skillmd.com/u/eryajf)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/eryajf/cnb-npc-search

---


# 搜索 NPC 角色

根据用户需求，通过关键词语义搜索 CNB 平台上的公开 NPC 角色，帮助用户找到最合适的 NPC。

## 搜索步骤

### 1. 提取搜索关键词

分析用户的需求，提取最能描述目标 NPC 功能的关键词。例如：

- 用户说"帮我找一个能做代码审查的 NPC" → 关键词：`代码审查`
- 用户说"有没有写前端的 NPC" → 关键词：`前端开发`
- 用户说"我需要一个 NPC 帮我写单元测试" → 关键词：`单元测试`

### 2. 执行搜索

```bash
cnb knowledge-base search-npc --key "关键词"
```

可选参数：
- `--top-n <number>`：返回结果数量，最大 20（默认 10）

### 3. 解读搜索结果

搜索结果包含以下字段：

| 字段 | 说明 |
|------|------|
| `name` | NPC 角色名称 |
| `slug` | NPC 所在仓库路径 |
| `slogan` | NPC 简介/标语，描述其能力和特点 |
| `score` | 语义匹配分数（越高越相关） |
| `avatar` | NPC 头像路径 |

### 4. 选出最合适的 NPC

根据搜索结果，结合以下因素选出最合适的 NPC：

1. **匹配分数**（score）：分数越高，语义匹配度越高
2. **slogan 描述**：了解 NPC 能力定位，判断是否符合需求
3. **角色名称**（name）：通常反映专长领域

选定后，NPC 的使用形式为 `@{slug}({name})`，其中 `slug` 是仓库路径，`name` 是角色名。

例如：`@npc/hok(π)` 表示仓库 `npc/hok` 下名为 `π` 的 NPC 角色。

## 注意事项

- 关键词应精准，避免过于宽泛
- 搜索结果不理想时，可换关键词重试
- slogan 为空的 NPC 可能缺少描述，优先推荐有明确 slogan 的
- 直接执行命令搜索，无需用户确认
- **npc提及**: 评论中直接 @npc 会召唤 npc 干活，如果只提及不召唤，应该去掉 `@` 符号，或使用反引号包裹 `@npc`。