目标
事实层问题(参数语义、行为、版本差异)必须以官方文档为 ground truth。本 skill 强制把"能看官方就不要看二手"作为第一原则。
适用场景
- 参数 / 返回值 / 默认值 / 副作用查询
- 版本差异 / breaking change
- 迁移路径 / 升级指南
规则(共 8 条)
- 官方 doc 优先级最高:vendor 主站 doc > GitHub README > 官方 blog > 任何二手内容。
- 明确目标版本:query 必须带版本号;缺失会读到不适用的旧/新文档。
- 变更日志专项检索:行为差异 / 弃用 / 默认值变化必须查 CHANGELOG / Release Notes。
- 迁移指南专项:跨大版本时找 "migration guide" / "upgrade guide" / "breaking changes"。
- API reference 专项:参数语义 / 返回值 / 错误码用 reference 章节,不要从教程类页面推断。
- doc 与源码不一致时以源码为准:但需在答案中显式标注差异。
site:限定到官方域:通用搜索时强制site:docs.<vendor>.com。- 搜不到时回到源码:官方 doc 缺漏的字段,回到 GitHub 仓库的源码 / 注释 / 测试。
执行流程
- 识别 vendor + 版本号。
site:docs.<vendor>.com <keyword>锁定 reference / changelog / migration。- 命中 reference → 抽参数 / 默认值 / 错误码。
- 命中 changelog → 抽版本差异。
- 文档无答案 → 回 GitHub 源码。
关联 skill
forum_search— 社区指向后回到本 skill 验证github_search/codebase_search— 文档缺漏时回到源码general_query_construction— query 构造上游