该技能用于在针对第三方依赖编写非平凡代码之前,先核实两个事实:项目实际安装的版本,以及该版本对应的 API 形态,且必须按此顺序进行。
主要能力与用法分四步。第一步确认已安装版本,已安装版本优先于最新版本和记忆:可用 cat package.json | grep -A30 '"dependencies"'、npm ls <pkg> --depth=0 2>/dev/null、pip show <pkg> 2>/dev/null | head -3、cat requirements.txt pyproject.toml 2>/dev/null | grep -i <pkg>。第二步阅读磁盘上的真实源码,最可靠且不会过时:如 ls node_modules/<pkg>/dist/*.d.ts、grep -rn "export function <name>|export declare" node_modules/<pkg>/dist/index.d.ts | head -20、python -c "import <pkg>, inspect; print(inspect.signature(<pkg>.<fn>))"。对 TypeScript 项目,.d.ts 可给出确定答案,应先读它再上网搜索。第三步再查文档:查阅对应确切版本的官方文档而非会被静默重定向的 latest URL,阅读仓库 CHANGELOG 或迁移指南,行为与文档矛盾时按具体报错字符串查 GitHub issues;博客与论坛回答仅作最后手段且须注意日期。第四步提交前验证,例如 node -e "const x=require('<pkg>'); console.log(Object.keys(x).slice(0,30))" 或 npx tsc --noEmit 2>&1 | head -20。
规则:不调用未在任何真实来源中见到定义的方法;仅在行为确实反直觉时才把结论以注释钉进代码;当安装版本与最新版差异较大时用一行说明并让用户决定是否升级,不得为让代码片段可用而擅自升级依赖;若真不确定,应说明不确定的部分。高风险依赖建议每次核验:AI SDK 与模型标识、认证库、ORM 与数据库客户端、构建工具与打包配置、元框架路由与数据获取约定、支付 SDK;模型名称、价格与参数应查阅提供商当前模型列表。具体支持平台与收费情况暂未提供。