$npx -y skills add z0gSh1u/oh-my-writing-skill --skill deep-research对给定选题进行联网深度研究,收集整理资料用于后续内容创作。 自动检测可用的网络搜索工具(WebSearch 或 MCP 搜索工具),无可用工具时回退到 DDGS。 输出结构化的 Markdown 资料汇总,包含来源引用。
| 1 | # 深度研究 Skill |
| 2 | |
| 3 | 你是一个专业的研究助手,负责对给定选题进行联网搜索和资料收集。 |
| 4 | |
| 5 | ## 搜索工具自动检测 |
| 6 | |
| 7 | 本 Skill 会自动检测当前环境中可用的网络搜索工具,按以下优先级顺序选择: |
| 8 | |
| 9 | 1. **Claude 内置 `WebSearch`**:Claude 原生模型的默认搜索工具 |
| 10 | 2. **MCP 搜索工具**:自定义模型厂商提供的搜索工具,常见名称如`mcp__minimax__web_search`,或其他包含 `search` 或 `web` 关键词的 MCP 工具 |
| 11 | 3. **DDGS 回退**:当以上工具均不可用时,使用 ddgs Python 库 |
| 12 | |
| 13 | ### 检测流程 |
| 14 | |
| 15 | ``` |
| 16 | 开始搜索 |
| 17 | │ |
| 18 | ├── WebSearch 可用? ──是──▶ 使用 WebSearch |
| 19 | │ |
| 20 | ├── MCP 搜索工具可用? ──是──▶ 使用 MCP 工具 |
| 21 | │ |
| 22 | └── 都不可用 ──▶ 回退到 DDGS |
| 23 | ``` |
| 24 | |
| 25 | | 搜索方式 | 工具 | 特点 | |
| 26 | | ---------------- | ------------------------------------ | ---------------------- | |
| 27 | | **WebSearch** | Claude 内置 | 搜索质量高、结果更相关 | |
| 28 | | **MCP 搜索工具** | 厂商提供(如 Brave、Tavily、Exa 等) | 自定义模型的搜索能力 | |
| 29 | | **DDGS**(回退) | ddgs Python 库 | 免费、不消耗额度 | |
| 30 | |
| 31 | ## 核心能力 |
| 32 | |
| 33 | 1. **多维度搜索**:围绕主题生成多个搜索关键词,从不同角度收集信息 |
| 34 | 2. **时效性控制**:支持按时间范围过滤结果(天/周/月/年) |
| 35 | 3. **来源追溯**:所有信息都附带原始来源链接 |
| 36 | 4. **结构化输出**:将收集的资料整理为易于使用的 Markdown 格式 |
| 37 | |
| 38 | ## 使用方式 |
| 39 | |
| 40 | ### 联网搜索(优先) |
| 41 | |
| 42 | 当检测到可用的网络搜索工具时,直接使用该工具进行搜索。 |
| 43 | |
| 44 | **执行步骤:** |
| 45 | |
| 46 | 1. 检测可用的搜索工具(WebSearch 或 MCP 搜索工具) |
| 47 | 2. 围绕主题生成 3-5 个搜索关键词(主关键词 + 扩展词如"最新"、"评测"、"教程") |
| 48 | 3. 依次使用搜索工具搜索每个关键词 |
| 49 | 4. 整理搜索结果,按 URL 去重 |
| 50 | 5. 输出结构化的 Markdown 研究报告(格式见下方"输出格式"章节) |
| 51 | |
| 52 | **示例调用:** |
| 53 | |
| 54 | ``` |
| 55 | # Claude 原生环境 |
| 56 | 使用 WebSearch 搜索: "AI 写作工具" |
| 57 | |
| 58 | # 自定义模型环境(示例) |
| 59 | 使用 mcp__brave__web_search 搜索: "AI 写作工具" |
| 60 | ``` |
| 61 | |
| 62 | ### DDGS 回退 |
| 63 | |
| 64 | 当没有可用的网络搜索工具时,回退到 ddgs Python 库。 |
| 65 | |
| 66 | **执行步骤:** |
| 67 | |
| 68 | 运行研究脚本: |
| 69 | |
| 70 | ```bash |
| 71 | python scripts/research.py "搜索主题" --max_results 20 --timelimit m --region zh-cn |
| 72 | ``` |
| 73 | |
| 74 | **参数说明:** |
| 75 | |
| 76 | - `query`:搜索主题(必填) |
| 77 | - `--max_results`:每个关键词返回的最大结果数(默认 10) |
| 78 | - `--timelimit`:时间限制,可选 `d`(天)、`w`(周)、`m`(月)、`y`(年) |
| 79 | - `--region`:搜索区域,如 `zh-cn`、`us-en` |
| 80 | - `--expand`:是否扩展关键词(默认开启) |
| 81 | - `--output`:输出文件路径(默认输出到标准输出) |
| 82 | |
| 83 | ## 输出格式 |
| 84 | |
| 85 | 无论使用哪种搜索模式,都应输出统一格式的 Markdown 研究报告: |
| 86 | |
| 87 | ```markdown |
| 88 | # 研究报告:[主题] |
| 89 | |
| 90 | ## 搜索概览 |
| 91 | |
| 92 | - 搜索时间:2026-01-21 |
| 93 | - 搜索模式:WebSearch / DDGS |
| 94 | - 关键词:主关键词, 扩展关键词1, 扩展关键词2 |
| 95 | - 结果数量:XX 条 |
| 96 | |
| 97 | ## 核心发现 |
| 98 | |
| 99 | ### 1. [发现标题] |
| 100 | |
| 101 | [内容摘要] |
| 102 | |
| 103 | > 来源:[标题](URL) |
| 104 | |
| 105 | ### 2. [发现标题] |
| 106 | |
| 107 | ... |
| 108 | |
| 109 | ## 参考资料 |
| 110 | |
| 111 | 1. [标题1](URL1) |
| 112 | 2. [标题2](URL2) |
| 113 | ... |
| 114 | ``` |
| 115 | |
| 116 | ## 研究策略 |
| 117 | |
| 118 | ### 关键词扩展 |
| 119 | |
| 120 | 对于主题 "AI 写作工具",会自动扩展为: |
| 121 | |
| 122 | - AI 写作工具(原始关键词) |
| 123 | - AI 写作工具 评测/对比 |
| 124 | - AI 写作工具 使用教程 |
| 125 | - AI 写作工具 最新动态 |
| 126 | |
| 127 | ### 信息去重 |
| 128 | |
| 129 | - 按 URL 去重,避免重复内容 |
| 130 | - 按内容相似度合并相近结果 |
| 131 | |
| 132 | ### 质量筛选 |
| 133 | |
| 134 | - 优先保留权威来源(官方文档、知名媒体) |
| 135 | - 过滤明显的广告和低质量内容 |
| 136 | |
| 137 | ## 输出示例 |
| 138 | |
| 139 | ```markdown |
| 140 | # 研究报告:Claude AI 最新功能 |
| 141 | |
| 142 | ## 搜索概览 |
| 143 | |
| 144 | - 搜索时间:2026-01-21 |
| 145 | - 关键词:Claude AI 最新功能, Claude AI 更新, Claude 3.5 特性 |
| 146 | - 结果数量:28 条(去重后) |
| 147 | |
| 148 | ## 核心发现 |
| 149 | |
| 150 | ### 1. Claude 3.5 Sonnet 发布 |
| 151 | |
| 152 | Anthropic 于 2025 年发布了 Claude 3.5 Sonnet,在代码生成和长文本理解方面有显著提升。 |
| 153 | |
| 154 | > 来源:[Anthropic Blog - Claude 3.5](https://anthropic.com/blog/...) |
| 155 | |
| 156 | ### 2. 工具使用能力增强 |
| 157 | |
| 158 | 新版本支持更复杂的工具调用链... |
| 159 | |
| 160 | > 来源:[TechCrunch 报道](https://techcrunch.com/...) |
| 161 | |
| 162 | ## 参考资料 |
| 163 | |
| 164 | 1. [Anthropic Blog - Claude 3.5](https://anthropic.com/blog/...) |
| 165 | 2. [TechCrunch: Claude gets major update](https://techcrunch.com/...) |
| 166 | 3. [The Verge: AI assistant comparison](https://theverge.com/...) |
| 167 | ``` |
| 168 | |
| 169 | ## 注意事项 |
| 170 | |
| 171 | ### 联网搜索(WebSearch / MCP) |
| 172 | |
| 173 | 1. **额度消耗**:每次搜索可能消耗额度(取决于具体工具) |
| 174 | 2. **搜索质量**:结果更相关、更准确 |
| 175 | 3. **推荐使用**:重要选题、需要高质量资料时 |
| 176 | |
| 177 | ### DDGS 回退 |
| 178 | |
| 179 | 1. **网络要求**:需要能够访问 DuckDuckGo 搜索服务 |
| 180 | 2. **速率限制**:避免短时间内大量请求,建议每次搜索间隔 1-2 秒 |
| 181 | 3. **结果时效**:搜索结果可能有几小时到几天的延迟 |
| 182 | 4. **语言偏好**:中文主题建议使用 `zh-cn` 区域设置 |
| 183 | 5. **何时使用**:仅当没有可用的联网搜索工具时自动回退 |