Vercel 官方 AI SDK Skill：让 AI 编程工具永远不凭记忆写代码

Vercel 出品的 AI SDK（就是 ai 这个 npm 包）是目前最流行的 AI 应用开发框架之一，支持 OpenAI、Anthropic、Google 等各大模型厂商的统一 API，还有结构化输出、工具调用、Agent、Embeddings、React 集成等能力。

但问题来了——

这个 SDK 更新太快了。

今天记住的 API，明天可能就被废弃了。你让 Claude Code 凭”记忆”写 AI SDK 代码，大概率会跑出一堆过时语法。尤其是 useChat 这些 React Hook，改过好几次签名，每次重训模型都赶不上官方最新版本。

所以 Vercel 官方出了这个 AI SDK Skill，专门给 AI 编程工具用。

它的核心原则只有一条：

永远不凭记忆写代码。所有 API 必须查文档。

具体怎么做到的？

1️⃣ 用内置文档，不用外部记忆
Skill 指示 Agent：先确保 node_modules/ai/ 已安装，然后去 node_modules/ai/docs/ 和 node_modules/ai/src/ 里找答案。内置文档永远和当前安装版本匹配，不会出现”我以为是这样但其实已经改了”的问题。

2️⃣ 模型 ID 也要实时查
Skill 要求 Agent 在写代码前，先调 API 拿最新的模型列表：

curl -s https://ai-gateway.vercel.sh/v1/models | jq -r '.data[].id'

因为模型上线和下线都很频繁，用记忆里的模型 ID 可能直接报 404。

3️⃣ 推荐 AI Gateway 接入
Skill 建议用 Vercel AI Gateway 作为最快启动方式——一个 API Key，一个入口，接入 OpenAI / Anthropic / Google 等多家模型，不用逐个配置 provider。

4️⃣ 用 SDK 内置的 Agent 抽象
Skill 明确建议用 ToolLoopAgent 等内置 Agent 抽象，而不是自己手写工具调用循环——手写容易出 bug，官方抽象经过大量测试。

5️⃣ 改完必须跑类型检查
每次生成代码后，必须跑类型检查器确认无误。类型错误大多来自”记忆里的旧 API”，重新查文档就能解决。

这个 Skill 的价值总结起来就是一句话：让 AI 编程工具成为一个永远最新的 AI SDK 专家，而不是一个靠训练数据记忆的过时助手。

如果你在用 Claude Code、Cursor、Windsurf 等工具开发 AI 应用，装上这个 Skill，每次写 AI SDK 代码都会自动查最新文档，告别过时语法烦恼。

GitHub：https://github.com/vercel/ai

GitHub: https://github.com/vercel/ai