# Search Guide

> 搜索工具调用决策指南。明确定义 Agent 何时应调用搜索工具（如实时信息、具体事实），何时应依赖内部知识。作为参考规范，优化 Agent 的工具使用策略。

- Skill: `majiayu000/search-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/search-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/search-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/search-guide

---


## 搜索工具使用规范

### ✅ 应该搜索的场景

#### 1. 实时信息
- 今日新闻、最新动态
- 股票价格、汇率
- 天气预报
- 体育赛事结果
- 最新版本号、发布日期

#### 2. 具体事实验证
- 具体的数字、日期、统计数据
- 公司信息（成立时间、创始人、融资）
- 产品规格、价格
- 官方文档链接

#### 3. 不熟悉的概念
- 专有名词、缩写
- 新技术、新产品
- 特定领域术语
- 人物、公司背景

#### 4. 用户明确要求
- "帮我查一下..."
- "搜索..."
- "最新的..."
- "现在的..."

---

### ❌ 不应该搜索的场景

#### 1. 通用知识
- 编程语言基础语法
- 常见设计模式
- 基本数学概念
- 广为人知的历史事件

#### 2. 概念解释
- "什么是 REST API"
- "解释一下 async/await"
- "面向对象的特点"

#### 3. 代码编写
- 写一个排序算法
- 实现某个功能
- 修复代码 bug
- 代码重构建议

#### 4. 创意任务
- 写文章、写故事
- 取名字
- 提供建议和方案

#### 5. 已有信息
- 上一轮搜索已返回的内容
- 用户在对话中提供的信息

---

### 🔄 搜索决策流程

```
用户提问
    │
    ▼
┌─────────────────────┐
│ 这是实时信息需求吗？ │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 涉及具体事实/数据？  │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 是不熟悉的专有名词？ │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
┌─────────────────────┐
│ 用户明确要求搜索？   │──── 是 ────→ 搜索
└─────────────────────┘
    │ 否
    ▼
  直接回答（不搜索）
```

---

### 📝 搜索关键词技巧

#### 好的关键词
- 简短精准：3-8 个字
- 包含核心概念
- 避免语气词、助词

#### 示例对比

| ❌ 差的关键词 | ✅ 好的关键词 |
|--------------|---------------|
| "请问一下现在苹果公司的股票价格是多少" | "苹果 股价" |
| "我想知道 Python 3.12 有什么新特性" | "Python 3.12 新特性" |
| "能不能帮我查一下北京今天的天气怎么样" | "北京 天气" |

---

### ⚠️ 搜索注意事项

1. **避免重复搜索**：如果上一轮已搜索过相同内容，直接使用结果
2. **并行搜索**：对比类问题可同时搜索多个关键词
3. **切换工具**：简单查询用 `websearch`，复杂研究用 `deepsearch`
4. **结果验证**：搜索结果需要判断可信度，优先使用权威来源