用途：在实现或审查基于 ai 包的 TypeScript 应用、AI SDK UI、provider 包、agents、workflows 或 @ai-sdk/mcp 时使用本技能。建议先阅读破坏性变更说明，再加载与当前工作匹配的主题参考；当顶层抽象未暴露所需能力时，保留 provider 特定选项。
主要能力与主题索引：migrations.md 涵盖运行时要求、codemod、重命名 API、弃用与结果语义；agents-and-tools.md 涵盖代理循环、步进控制、工具、审批、超时、工作流与 harness；generation-and-media.md 涵盖文本流、结构化输出、PDF、文件、图像、语音、转写与视频；mcp-and-runtimes.md 涵盖 MCP 传输、schema、资源、提示、elicitation、应用、漂移与托管资产；providers-and-observability.md 涵盖 provider 能力、集成、推理控制、遥测与生命周期事件；ui-and-streams.md 涵盖 useChat、持久化、数据流、直连代理传输、审批与实时 UI。
关键变更：面向 v7 API 线需 Node.js 22 或更高，使用 ESM 导入，不支持 CommonJS require()；需同时升级 ai 与所有 provider 包，并运行 npx @ai-sdk/codemod v7 后人工复核语义变化。重命名包括 system→instructions、onFinish→onEnd、fullStream→stream、experimental_customProvider→customProvider、experimental_generateImage→generateImage、experimental_output→output、experimental_prepareStep→prepareStep、experimental_telemetry→telemetry。
使用方式与限制：顶层多步结果会累积内容、工具调用与结果、文件、来源、警告与用量，仅在需要最后一步时使用 finalStep。代理循环应设停止规则、超时与中止；始终消费返回的流并处理带内错误部分；重放审批前持久化完整响应消息；校验运行时定义的工具与 MCP 输出。MCP 客户端应保持打开直到生成结束再关闭。具体 API 细节以各参考文件为准，资料未提供的部分暂未提供。