docs-lookup 是一个用于代码编写前验证库 API 的辅助技能。其核心用途是解决训练数据滞后的问题:在编写或修复依赖某个库、框架、SDK、CLI 或云 API 的代码前,按照与项目所用版本一致的来源进行查证,避免使用过时或错误的 API 信息。
主要能力包括:第一,锁定版本。从项目的清单文件与锁文件中读取版本信息(如 package.json + lockfile、pyproject.toml/uv.lock、Cargo.lock、go.mod),不在项目中时使用最新版本,最终获得 name@version 或 latest。第二,按阶梯逐级查找来源。阶梯次序为:源码仓库(通过 opensrc path 获取锁定版本对应的仓库副本,搜索 docs 文件夹、README、CHANGELOG/迁移指南、类型定义、测试和示例);文档仓库(源码仓库没有 docs 文件夹时,查找同级文档仓库并用 opensrc 打开);文档站点 markdown(获取官方站点的 llms.txt 了解 URL 格式,尝试 .md、.mdx、/index.md 或普通 HTML);网络搜索(当主机、页面或文档仓库未知,或主题比克隆源码更新时使用,限制官方域名);Context7(每个问题使用一次 resolve-library-id 和一次 query-docs,遇到配额错误提示用户后继续);已安装包(查看 node_modules、site-packages、cargo registry、GOMODCACHE 中的实际发布产物)。第三,带证据回答。每个使用或推荐的库 API 都必须追溯到本次会话中读取的来源,引用为锁定版本下的路径或 URL;来源冲突时以版本锁定来源为准,未验证内容需明确标注。
使用方式上,该技能通常作为编码助手或智能体工作流中的调用步骤,在需要查阅外部库文档时触发。它要求具备文件系统访问、命令行工具(如 rg、opensrc、gh)、网络访问等能力,并按环境规定的方式获取远程内容(如 ctx_fetch_and_index 或 WebFetch)。
适用场景包括:编写或修复涉及第三方库 API 或配置的代码、需要确认特定版本行为、排查因版本差异引起的错误、查阅迁移指南或新版本变更等。限制与注意事项:Context7 有共享月度配额限制;当包无法解析(如私有、无仓库 URL)时需直接跳到后续阶梯;文档站点和文档仓库通常跟踪最新版,非最新锁定版本需查找版本化文件夹;未验证内容应标注;该技能不提供额外的收费、价格或平台信息。