| name | web-search |
| description | 当任务需要联网检索、外部依据、最新技术知识、官方文档、GitHub 仓库、论文博客、标准、数据集、benchmark、许可证、价格、API 或工程实践依据时使用；适合代码生成前的技术选型、方案设计、内容生成、论文理解、工具库更新和其他 skill 需要外部依据支撑结论的场景。用户明确要求不联网时不要使用。 |
web-search
技能定位
用于给代码开发、内容生成、方案设计、技术选型、论文理解、官方 API 使用、工具库更新、前沿博客和 benchmark 规则提供可追溯的外部依据。目标是弥补 Agent 的知识滞后，避免在外部事实可能变化时凭记忆回答。
本 skill 不绑定单一项目、单一技术栈或单一资料类型。它既服务学术论文，也服务工程实践、官方文档、作者仓库、release notes、数据集主页、RFC / 标准、供应商文档和社区高质量实践。
触发场景
- 用户明确要求联网、检索、查资料、查论文、查官方文档、查 GitHub、查 benchmark 或查最新进展。
- 信息可能近期变化，例如模型版本、API、库用法、框架能力、许可证、价格、标准、论文结论、数据集规则、release notes 或供应商政策。
- 代码生成、技术选型、架构设计、内容生成或文档编写依赖外部事实。
- 另一个 skill 需要外部依据支撑结论，例如
$knowledge-explainer 需要解释最新论文、官方文档、benchmark、争议结论或现代 API。
- 用户问“现在主流怎么做”“有没有官方实现”“最新版本怎么用”“这个 benchmark 规则是什么”“这个库还推荐吗”。
不触发场景
- 用户明确要求不联网、不检索或只基于本地材料回答。
- 本地源码、README、设计文档、测试日志已经足够回答，且问题不依赖最新外部信息。
- 纯文件整理、格式修复、已有代码解释、无外部事实依赖的一次性任务。
- 用户只要求本地 diff、当前实现、仓库内调用链或已有文档的总结。
检索源优先级
优先使用一手来源，并按任务类型调整具体来源：
- 官方文档、标准、RFC、供应商文档、官方 release notes。
- 作者仓库、官方 GitHub、论文代码、数据集主页、benchmark 官方页面。
- 一手论文、会议页面、作者主页、arXiv、OpenReview、ACL Anthology、主要会议或期刊页面。
- 高质量技术博客、工程实践文章、项目 issue、维护者讨论、迁移指南。
- 社区问答、论坛、社交媒体只作为补充，不能作为唯一依据。
不同项目可以替换具体来源类型，但不能降低“优先一手来源、二手来源只作补充”的原则。
最小检索流程
- 明确任务类型：
- 官方 API / 库用法确认。
- 代码生成前技术选型。
- 论文、方法、benchmark 或数据集调研。
- 工程实践、架构方案或迁移策略对照。
- 许可证、价格、标准、兼容性或发布规则核对。
- 拆关键词：
- 用户原始中文问题。
- 英文关键词、同义词、论文术语、库名、版本名、接口名。
- 当前项目相关关键词，但不要把项目私有事实写成外部事实。
- 优先查一手来源：
- API / 库任务至少查官方文档或官方 release notes。
- 论文 / benchmark / 数据集任务至少查论文、会议页面、作者仓库或官方主页。
- 工程选型任务至少查官方文档、维护者仓库或权威迁移说明。
- 对来源做可信度分层：
- 明确哪些是已确认事实。
- 明确哪些是来源之间存在冲突的判断。
- 明确哪些是工程推断。
- 明确哪些仍需用户或真实环境验证。
- 只把可靠来源纳入最终结论。若只能找到二手来源，必须说明“证据不足”，不能写成确定事实。
输出结构
按任务需要裁剪，但默认包含：
问题重述：这次检索要解决什么决策或事实。检索关键词：列出中文关键词和英文关键词。核心发现：按官方规范、论文依据、工程实践、社区补充等来源类型分组。结论分层：
- 已确认事实。
- 来源冲突与取舍。
- 工程推断。
- 仍需真实环境验证的边界。
项目落地点：如果和当前项目相关，说明对模块、流程、接口、数据、测试、文档或设计取舍的影响；如果只是背景知识，明确说明不直接落代码。来源清单：给出可点击链接，并标注来源类型、年份或更新时间。
代码生成前的特别要求
当检索服务于代码生成、配置修改或架构决策时，必须先把结论转成工程约束：
- 推荐使用哪个官方 API、库、协议、格式或实现路径。
- 不推荐什么做法，原因是什么，依据来自哪里。
- 当前项目的最小可行实现是什么。
- 哪些内容只能作为后续扩展，不能包装成当前已完成能力。
- 需要新增或更新哪些测试、smoke test、文档或验证证据。
- 如果来源和当前项目环境不完全匹配，说明差异和需要真实环境验证的边界。
质量要求
- 不允许只写“网上说”“资料显示”这类不可追溯表达。
- 不允许只给二手转述；二手来源只能作为补充。
- 不允许把论文、博客或官方能力夸大成当前项目已实现。
- 涉及现代库、API、模型、标准、许可证、价格或 benchmark 时，必须核对最新官方来源。
- 若不同来源冲突，必须说明冲突点、取舍理由和仍需验证的部分。
- 若网页无法访问，说明访问限制，并改用可访问的一手来源或高质量来源。
- 输出外部依据时，必须区分已确认事实、冲突判断、工程推断和未验证边界。
自检
输出前检查：
- 是否满足触发条件，且用户没有要求不联网。
- 是否至少优先使用了一手来源。
- 是否给出可追溯链接，而不是泛泛转述。
- 是否区分事实、冲突、推断和未验证边界。
- 如果服务于代码生成，是否把外部结论转成最小工程约束和验证要求。
- 是否没有把任何单一项目的私有路径、模块名、benchmark、trace 文件或测试命令写成通用模板事实。
