用途
Verify With Docs(检索优先)用于解决一个常见问题:训练数据存在截止时间,而库和框架更新很快,模型记忆中的 API 可能已经过时。因此,凡是代码要接触特定依赖时,应先检索再编写,不能凭记忆。
适用场景
- 基于具名库、框架或 SDK 实现功能,尤其是快速变化的 web 框架、云 SDK、AI/LLM SDK、构建工具、ORM。
- 代码依赖精确的函数签名、选项名、返回结构或配置键。
- 需求中出现“最新”“当前”“某版本是否改了 X”,或明确指定版本。
- 当前报错看起来像 API 用错或改名。
不适用:有把握的稳定标准库用法,或没有外部 API 面的纯逻辑。
主要能力
- 锁定实际版本:JS/TS 查 package.json 与锁文件(node_modules/<pkg>/package.json 为安装版本的事实来源);Python 查 pyproject.toml、requirements.txt 或 pip show;Go 查 go.mod;Rust 查 Cargo.toml / Cargo.lock。
- 优先本地引用:先检查 opencode.jsonc 的 references 是否挂载了目标库的本地副本,若有则先读本地源码;仅在引用过期、未覆盖相关代码路径或未挂载时才联网获取。
- 按版本查一手来源:顺序为对应版本官方文档、库自身仓库(匹配版本的 tag/分支)、包内类型定义(.d.ts、stubs、godoc)、可靠参考;签名不要依赖博客和问答。
- 最小化摘取:只取需要的签名、必填与可选参数、返回类型、错误模式及与记忆假设不符的破坏性变更,不整页粘贴。
- 带来源报告:每个结论附 URL 或文件路径。
使用方式
按循环执行:锁版本 → 查对应版本的一手来源 → 摘取最小必要信息 → 带来源报告 → 最后才按检索结果实现。对于常用库,可在 opencode.json 挂载引用,例如将 somelib 的仓库与分支固定到实际使用版本,或挂载 vendored 内部库路径作为只读上下文;之后先搜索本地引用,引用缺失或过期时刷新,而不是回退到记忆。
输出格式固定为三段:“Verified against docs”列出 API/签名与来源及版本;“Changed / gotchas”说明与记忆猜测的差异及影响;“Ready to implement”一行确认可据此写码。
限制与反模式
避免先写调用再“事后检查”、引用与安装版本不符的文档、整页粘贴文档、信任博客或问答片段而非官方文档与随包类型定义。技能本身不提供自动校验工具,依赖执行者按流程检索并标注来源。