脚手架：计划赶不上生态——AI SDK 直接装到了 v6

目标

跑通脚手架：Next.js + TypeScript + Tailwind，装好 AI 相关依赖，写下项目约定（CLAUDE.md），让部署管线尽早可用。

关键 prompt（原文摘录）

这个阶段的关键输入是计划获批后的执行指令，以及脚手架自带的一条给 AI 的警告。Next.js 16 的模板现在会生成一份 AGENTS.md，里面写着：

This is NOT the Next.js you know. This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ before writing any code.

框架作者直接在脚手架里给 AI 写说明书——这本身就说明「AI 写代码」已经是被认真对待的一等场景。

结果

• Next.js 16.2.9（Turbopack 默认）+ Tailwind v4 + ESLint 9，干净落地；
• 安装 AI 依赖时发现：计划里写的 Vercel AI SDK v5，npm 上已经是 v6.0.200；
• 应对方式：写代码前先 grep node_modules/ai/dist/index.d.ts 核对真实 API（确认 streamText/createUIMessageStream/DefaultChatTransport 都在，UI 流 chunk 的字段名是 delta），再把这些备忘写进 CLAUDE.md 约束后续生成。

踩坑与纠正

计划阶段预判过「AI 训练数据落后于 SDK 版本」的风险，但预判的是 v4→v5，现实是 v5→v6。教训很具体：对快速迭代的库，AI 的版本知识默认过期，唯一可靠的是装好的包里的类型定义和文档——先读再写，而不是写完再调。

用时与备注

脚手架与依赖安装约 15 分钟。Node v25 / npm 11 环境。