mcpField
A
ai-sdk

ai-sdk

github.com/laguagu开发71143 次安装1 天前更新
代码仓库

关于 ai-sdk

面向使用 Vercel AI SDK 的开发者的文档路由技能，帮助识别已安装的包版本，并在实现前查找匹配的 API 与参考资料，以减少版本不匹配。

主要功能

  1. 01确认已安装的 SDK 版本
  2. 02按主版本匹配指导
  3. 03搜索本地文档与包类型
  4. 04查找对应版本的 API 参考
  5. 05检查 Provider 模型配置

适用场景

  1. 01准备 AI SDK 升级或迁移
  2. 02依据已安装主版本核对 API 调用
  3. 03在离线工作区查找文档

MCP 相关

该技能指出 @ai-sdk/mcp 不附带文档，并引导查阅 ai/docs 中的指南及包类型声明中的 API。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/laguagu/claude-code-nextjs-skills --skill ai-sdk

安装后在 Claude Code 中输入/ai-sdk确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
common-errors.md
devtools.md
examples.md
type-safe-agents.md

详细介绍

AI SDK 版本与文档路由

在相关工作区的清单、锁文件或已安装的软件包中，确认 ai 和提供商／React 软件包的版本。除非要求升级，否则保持已安装的主版本。

  • AI SDK 7 的实现或迁移：使用 ai-sdk-7。
  • AI SDK 6 的维护：使用 ai-sdk-6。
  • 版本未知、混杂或较旧：先确认版本，再应用任一 API 集。
  • 新应用：从当前主版本开始（撰写本文时为 7；可通过 npm view ai dist-tags 确认）。ai@7 搭配 @ai-sdk/react@4，ai@6 搭配 @ai-sdk/react@3。 不同提供商软件包的主版本各不相同，因此 v7 应为每个提供商安装其 latest， v6 则安装其 ai-v6 dist-tag（npm view <pkg> dist-tags）。

查找与应用匹配的 API

优先搜索已确认版本的软件包中的 docs/、类型定义和 src/（若有）；这些内容无需联网即可使用。 ai 从 6.0.32 及 7.x 开始捆绑文档； 6.0.0-6.0.31 不包含文档。文档目录与网站一致：ai-sdk.dev/docs/<section>/<page> 对应 ai/docs/<nn>-<section>/<nn>-<page>.mdx，因此可以从已安装主版本的软件包副本中 查阅这些技能中的 ai-sdk.dev/docs 链接。提供商软件包会附带 docs/<nn>-<provider>.mdx。@ai-sdk/react、@ai-sdk/workflow、 @ai-sdk/harness、@ai-sdk/otel 和 @ai-sdk/mcp 不附带文档；其指南位于 ai/docs，API 则位于 dist/*.d.ts。Monorepo 提升依赖和 Yarn PnP 可能会改变路径；不要仅为获取文档而安装或升级依赖。

本地文档不可用时，请使用匹配的仓库标签（vercel/ai，标签 ai@<version>， content/docs/）或对应版本的文档。文档搜索 和 Markdown 页面版本有助于查找相关功能。仓库 main 分支和默认网站可能面向比应用更新的主版本。若既无本地文档也无法联网，请说明哪些 API 信息仍未经核实。 在搜索链接后追加 &tag=v6（v5、v6 或 v7），可将结果限定到对应主版本。

从应用的提供商配置或当前提供商目录中选择模型 ID。Gateway 目录 可用于辅助查找；其中的 ID 和功能可用性并不意味着其他提供商也接受这些 ID。应根据任务选择功能、延迟和成本。

定向参考资料

适用时使用默认设置。对更改后的集成运行类型检查，并测试其流式传输／工具流程；即使符号受支持，也可能因回调作用域、结果语义或提供商不同而使用不当。

评论

支持 Markdown