cnb-npc-search

name	cnb-npc-search
description	通过关键词语义搜索 CNB 平台上的公开 NPC 角色，帮助用户找到最适合当前需求的 NPC。

搜索 NPC 角色

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

搜索步骤

1. 提取搜索关键词

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

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

2. 执行搜索

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。