100 lines
4.2 KiB
Markdown
100 lines
4.2 KiB
Markdown
# EXPERIMENTAL_SKILL_SEARCH — 技能语义搜索
|
||
|
||
> Feature Flag: `FEATURE_EXPERIMENTAL_SKILL_SEARCH=1`
|
||
> 实现状态：全部 Stub（8 个文件），布线完整
|
||
> 引用数：21
|
||
|
||
## 一、功能概述
|
||
|
||
EXPERIMENTAL_SKILL_SEARCH 提供 DiscoverSkills 工具，根据当前任务语义搜索可用技能。目标是让模型在执行任务时自动发现和推荐相关的技能（包括本地和远程），无需用户手动查找。
|
||
|
||
## 二、实现架构
|
||
|
||
### 2.1 模块状态
|
||
|
||
| 模块 | 文件 | 状态 | 说明 |
|
||
|------|------|------|------|
|
||
| DiscoverSkillsTool | `src/tools/DiscoverSkillsTool/prompt.ts` | **Stub** | 空工具名 |
|
||
| 预取 | `src/services/skillSearch/prefetch.ts` | **Stub** | 3 个函数全部空操作 |
|
||
| 远程加载 | `src/services/skillSearch/remoteSkillLoader.ts` | **Stub** | 返回空结果 |
|
||
| 远程状态 | `src/services/skillSearch/remoteSkillState.ts` | **Stub** | 返回 null/undefined |
|
||
| 信号 | `src/services/skillSearch/signals.ts` | **Stub** | `DiscoverySignal = any` |
|
||
| 遥测 | `src/services/skillSearch/telemetry.ts` | **Stub** | 空操作日志 |
|
||
| 本地搜索 | `src/services/skillSearch/localSearch.ts` | **Stub** | 空操作缓存 |
|
||
| 功能检查 | `src/services/skillSearch/featureCheck.ts` | **Stub** | `isSkillSearchEnabled => false` |
|
||
| SkillTool 集成 | `src/tools/SkillTool/SkillTool.ts` | **布线** | 动态加载所有远程技能模块 |
|
||
| 提示集成 | `src/constants/prompts.ts` | **布线** | DiscoverSkills schema 注入 |
|
||
|
||
### 2.2 预期数据流
|
||
|
||
```
|
||
模型处理用户任务
|
||
│
|
||
▼
|
||
DiscoverSkills 工具触发 [需要实现]
|
||
│
|
||
├── 本地搜索：索引已安装技能元数据
|
||
│ └── localSearch.ts → 技能名称/描述/关键字匹配
|
||
│
|
||
└── 远程搜索：查询技能市场/注册表
|
||
└── remoteSkillLoader.ts → fetch + 解析
|
||
│
|
||
▼
|
||
结果排序和过滤
|
||
│
|
||
▼
|
||
返回推荐技能列表
|
||
│
|
||
▼
|
||
模型使用 SkillTool 调用推荐技能
|
||
```
|
||
|
||
### 2.3 预取机制
|
||
|
||
`prefetch.ts` 预期在用户提交输入前分析消息内容，提前搜索相关技能：
|
||
|
||
- `startSkillDiscoveryPrefetch()` — 开始预取
|
||
- `collectSkillDiscoveryPrefetch()` — 收集预取结果
|
||
- `getTurnZeroSkillDiscovery()` — 获取 turn 0 的技能发现结果
|
||
|
||
## 三、需要补全的内容
|
||
|
||
| 优先级 | 模块 | 工作量 | 说明 |
|
||
|--------|------|--------|------|
|
||
| 1 | `DiscoverSkillsTool` | 大 | 语义搜索工具 schema + 执行 |
|
||
| 2 | `skillSearch/prefetch.ts` | 中 | 用户输入分析和预取逻辑 |
|
||
| 3 | `skillSearch/remoteSkillLoader.ts` | 大 | 远程市场/注册表获取 |
|
||
| 4 | `skillSearch/remoteSkillState.ts` | 小 | 已发现技能状态管理 |
|
||
| 5 | `skillSearch/localSearch.ts` | 中 | 本地索引构建/查询 |
|
||
| 6 | `skillSearch/featureCheck.ts` | 小 | GrowthBook/配置门控 |
|
||
| 7 | `skillSearch/signals.ts` | 小 | `DiscoverySignal` 类型定义 |
|
||
|
||
## 四、关键设计决策
|
||
|
||
1. **预取优化**：在用户提交前就开始搜索，减少首次响应延迟
|
||
2. **本地+远程双搜索**：本地索引快速匹配 + 远程市场深度搜索
|
||
3. **SkillTool 集成**：发现的技能通过 SkillTool 调用，不需要新的调用机制
|
||
4. **独立于 MCP_SKILLS**：MCP_SKILLS 从 MCP 服务器发现，EXPERIMENTAL_SKILL_SEARCH 从技能市场发现
|
||
|
||
## 五、使用方式
|
||
|
||
```bash
|
||
# 启用 feature（需要补全后才能真正使用）
|
||
FEATURE_EXPERIMENTAL_SKILL_SEARCH=1 bun run dev
|
||
```
|
||
|
||
## 六、文件索引
|
||
|
||
| 文件 | 职责 |
|
||
|------|------|
|
||
| `src/tools/DiscoverSkillsTool/prompt.ts` | 工具 schema（stub） |
|
||
| `src/services/skillSearch/prefetch.ts` | 预取逻辑（stub） |
|
||
| `src/services/skillSearch/remoteSkillLoader.ts` | 远程加载（stub） |
|
||
| `src/services/skillSearch/remoteSkillState.ts` | 远程状态（stub） |
|
||
| `src/services/skillSearch/signals.ts` | 信号类型（stub） |
|
||
| `src/services/skillSearch/telemetry.ts` | 遥测（stub） |
|
||
| `src/services/skillSearch/localSearch.ts` | 本地搜索（stub） |
|
||
| `src/services/skillSearch/featureCheck.ts` | 功能检查（stub） |
|
||
| `src/tools/SkillTool/SkillTool.ts` | SkillTool 集成点 |
|
||
| `src/constants/prompts.ts:95,335,778` | 提示增强 |
|