# Skill: tool_research

## ⚠️ 关键规则（必须首先阅读）

**在构造任何query前，必须通过以下检查：**

1. **Query中是否包含"工具"或"方法"？**
   - 必须包含：工具、方法、软件、插件、模型、API等
   - 如果没有这些词，这个query是错误的

2. **Query是否在搜索"用什么工具"而不是"是什么内容"？**
   - ✅ 正确：姿态检测工具、深度提取方法
   - ❌ 错误：女性画家、户外写生、白色裙子

3. **Query是否会搜到工具推荐？**
   - ✅ 正确：会搜到工具名称、使用教程
   - ❌ 错误：会搜到图片、作品、内容

**示例对比**：

| 错误Query（只有内容） | 正确Query（包含工具） |
|---------------------|---------------------|
| ❌ 女性画家 姿态 | ✅ 姿态检测 工具推荐 |
| ❌ 户外 深度 | ✅ 深度图提取 方法 |
| ❌ 白色裙子 | ✅ 服装分割 工具 |
| ❌ 画架 识别 | ✅ 物体检测 模型推荐 |

**强制自检流程**：
```
构造query → 检查是否包含"工具/方法" → 检查是否搜索工具 → 确认后搜索
           ↓ 没有工具/方法                ↓ 只搜内容
           重新构造                        重新构造
```

---

## 目标

为**Control Signals（控制信号/特征维度）**寻找最合适的提取工具。

工具用于从图片中提取**Feature Values（特征值）**。

**注意**：本skill只负责寻找工具，不负责提炼Control Signal。

---

## 输入格式

```json
{
  "highlight_id": "[亮点ID]（可选）",
  "highlight_type": "[实质/形式/全局]",
  "dimensions": [
    {
      "name": "pose",
      "category": "form",
      "output_format": "image",
      "belongs_to_highlight": true
    }
  ]
}
```

**注意**：
- dimensions实际上表示Control Signals
- 需要知道每个维度的category和output_format，以便选择合适的工具
- highlight_type帮助理解维度的边界和范围
- belongs_to_highlight标识该维度是否属于当前亮点

---

## 输出格式

**文件**：`knowledge/tool_research_result.json`

```json
{
  "tools": [
    {
      "dimension": "pose",
      "category": "form",
      "output_format": "image",
      "tool_name": "OpenPose",
      "type": "model",
      "availability": "ComfyUI节点",
      "usage": "使用方法描述",
      "parameters": "关键参数说明",
      "search_evidence": ["URL1", "URL2"],
      "reasoning": "为什么选择这个工具"
    }
  ]
}
```

---

## 工作流程

### 1. Query构造（关键）

**⚠️ 搜索目的**：寻找"提取工具"，而不是寻找类似的图片内容

**Query公式**：[特征维度] + [提取动作] + [工具/方法]

**严格禁止**：
- ❌ 直接使用亮点描述作为搜索词
- ❌ 只搜索内容关键词
- ❌ 缺少"工具"、"方法"、"提取"等词

**自检问题**：
- 这个query是在搜索"提取工具"吗？
- 这个query包含工具/方法相关的词了吗？
- 这个query会搜到工具推荐和使用方法吗？

**Query要求**：
- 简短（3-5词）
- 语义完整
- 包含工具/方法意图

**搜索平台**：只在小红书搜索，使用中文

### 2. 搜索迭代

**第一轮（工具发现）**：
- 目标：发现可用的工具
- Query：[特征维度] + [提取/检测] + [工具/方法]
- 记录：工具名称、工具类型、可用性

**第二轮（使用方法）**：
- 目标：了解工具的使用方法和效果
- Query：[工具名称] + [使用/教程] + [案例/效果]
- 记录：使用方法、参数设置、实际效果

**第三轮（可选，对比评估）**：
- 目标：对比多个工具，选择最优
- Query：[工具A] vs [工具B] + [对比/评测]

**停止条件**（满足任一即停止）：
- 找到2-3个可用工具及其使用方法
- 能够清晰描述工具的使用流程
- 搜索结果开始重复
- 已完成2-3轮搜索

### 3. 工具评估

**评估标准**：
- 在小红书上有真实使用案例
- 创作者评价好
- 工具可用性强（优先已有工具、在线服务、API）
- 提取效果符合需求

**工具类型**：
- model：AI模型（如OpenPose、DepthAnything）
- api：在线API服务
- software：软件工具
- plugin：插件（如ComfyUI节点、Photoshop插件）

### 4. 工具选择

**推理过程**：
- 列出搜索得到的工具和案例
- 对每个维度：
  - 前提：引用搜索得到的工具信息和使用案例
  - 推理逻辑：说明为什么选择这个工具
  - 结论：选择工具名称

**选择建议**：优先选择在小红书上有真实案例、评价好、可直接使用的工具

### 5. 输出结果

每个工具必须包含：
- dimension（维度名称）
- category（global/substance/form）
- output_format（image/json）
- tool_name（工具名称）
- type（model/api/software/plugin）
- availability（可用性说明）
- usage（使用方法）
- parameters（关键参数）
- search_evidence（支持的URL）
- reasoning（选择理由，基于搜索案例）

**禁止**：
- 凭空推测工具效果
- 没有实际使用案例支持的工具选择
- 选择无法验证可用性的工具
- 为不属于当前亮点的维度选择工具

---

## 重要原则

**工具必须服务于维度**。

**维度设计优先**。