ai-sdk-5 — скилл для Claude Code: что делает и как установить
Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии.
Apache-2.0 138 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-codeЧто делает ai-sdk-5
Скилл содержит готовые шаблоны и правила перехода с AI SDK 4 на пятую версию фреймворка. В коде v5 хук useChat импортируется из пакета @ai-sdk/react, а сетевой слой настраивается через экземпляр DefaultChatTransport из пакета ai.
Вместо единой строки content структура сообщений UIMessage теперь опирается на массив parts. Внутри него лежат отдельные блоки: текст, изображения, вызовы инструментов tool-call и их результаты tool-result. Скилл показывает, как правильно разбирать эти части при рендеринге интерфейса.
В правилах также описаны серверные роуты со streamText, интеграция со стримингом из LangChain через toUIMessageStream, объявление инструментов с валидацией схем через zod и генерация текста через useCompletion. Если проект всё ещё использует сигнатуры параметров из v4 вроде прямого поля api в useChat, сборка интерфейса упадёт с ошибками типов.
Какие задачи решает
- Обновить вызовы хука
useChatи подключитьDefaultChatTransport - Отрендерить массив
partsвUIMessageвместо устаревшего поляcontent - Настроить серверный стриминг
streamTextс вызовами инструментов - Связать стримы LangChain с клиентским форматом через
toUIMessageStream
Примеры запросов агенту
- Собери React-компонент чата на Vercel AI SDK 5 с обработкой ошибок
- Перепиши серверный роут
/api/chatна streamText с тулом погоды - Покажи, как извлечь текстовые блоки из UIMessage parts в v5
Как установить ai-sdk-5
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-code2Вручную: положить файлы
~/.claude/skills/ai-sdk-5/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ai-sdk-5/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a codex2Вручную: положить файлы
.agents/skills/ai-sdk-5/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a cursor2Вручную: положить файлы
.cursor/skills/ai-sdk-5/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills curated/ai-sdk-5/SKILL.md2Вручную: положить файлы
.github/skills/ai-sdk-5/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path curated/ai-sdk-5Вручную: положить файлы
.devin/skills/ai-sdk-5/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об ai-sdk-5
Как установить ai-sdk-5 в Claude Code?
Выполните в терминале команду npx skills add Gentleman-Programming/Gentleman-Skills --skill ai-sdk-5 -a claude-code.
Что делает скилл ai-sdk-5?
Он направляет ассистента использовать синтаксис Vercel AI SDK 5, исключая устаревшие методы и структуры данных из четвёртой версии библиотеки.
Какие пакеты требуются для примеров из скилла?
Для работы клиента нужен @ai-sdk/react, для ядра и транспорта — ai, а для серверных моделей и валидации — @ai-sdk/openai и zod.
Исходный текст
SKILL.md · Apache-2.0
---
name: ai-sdk-5
description: >
Vercel AI SDK 5 patterns.
Trigger: When building AI chat features - breaking changes from v4.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
## Breaking Changes from AI SDK 4
```typescript
// ❌ AI SDK 4 (OLD)
import { useChat } from "ai";
const { messages, handleSubmit, input, handleInputChange } = useChat({
api: "/api/chat",
});
// ✅ AI SDK 5 (NEW)
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
const { messages, sendMessage } = useChat({
transport: new DefaultChatTransport({ api: "/api/chat" }),
});
```
## Client Setup
```typescript
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
import { useState } from "react";
export function Chat() {
const [input, setInput] = useState("");
const { messages, sendMessage, isLoading, error } = useChat({
transport: new DefaultChatTransport({ api: "/api/chat" }),
});
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault();
if (!input.trim()) return;
sendMessage({ text: input });
setInput("");
};
return (
<div>
<div>
{messages.map((message) => (
<Message key={message.id} message={message} />
))}
</div>
<form onSubmit={handleSubmit}>
<input
value={input}
onChange={(e) => setInput(e.target.value)}
placeholder="Type a message..."
disabled={isLoading}
/>
<button type="submit" disabled={isLoading}>
Send
</button>
</form>
{error && <div>Error: {error.message}</div>}
</div>
);
}
```
## UIMessage Structure (v5)
```typescript
// ❌ Old: message.content was a string
// ✅ New: message.parts is an array
interface UIMessage {
id: string;
role: "user" | "assistant" | "system";
parts: MessagePart[];
}
type MessagePart =
| { type: "text"; text: string }
| { type: "image"; image: string }
| { type: "tool-call"; toolCallId: string; toolName: string; args: unknown }
| { type: "tool-result"; toolCallId: string; result: unknown };
// Extract text from parts
function getMessageText(message: UIMessage): string {
return message.parts
.filter((part): part is { type: "text"; text: string } => part.type === "text")
.map((part) => part.text)
.join("");
}
// Render message
function Message({ message }: { message: UIMessage }) {
return (
<div className={message.role === "user" ? "user" : "assistant"}>
{message.parts.map((part, index) => {
if (part.type === "text") {
return <p key={index}>{part.text}</p>;
}
if (part.type === "image") {
return <img key={index} src={part.image} alt="" />;
}
return null;
})}
</div>
);
}
```
## Server-Side (Route Handler)
```typescript
// app/api/chat/route.ts
import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";
export async function POST(req: Request) {
const { messages } = await req.json();
const result = await streamText({
model: openai("gpt-4o"),
messages,
system: "You are a helpful assistant.",
});
return result.toDataStreamResponse();
}
```
## With LangChain
```typescript
// app/api/chat/route.ts
import { toUIMessageStream } from "@ai-sdk/langchain";
import { ChatOpenAI } from "@langchain/openai";
import { HumanMessage, AIMessage } from "@langchain/core/messages";
export async function POST(req: Request) {
const { messages } = await req.json();
const model = new ChatOpenAI({
modelName: "gpt-4o",
streaming: true,
});
// Convert UI messages to LangChain format
const langchainMessages = messages.map((m) => {
const text = m.parts
.filter((p) => p.type === "text")
.map((p) => p.text)
.join("");
return m.role === "user"
? new HumanMessage(text)
: new AIMessage(text);
});
const stream = await model.stream(langchainMessages);
return toUIMessageStream(stream).toDataStreamResponse();
}
```
## Streaming with Tools
```typescript
import { openai } from "@ai-sdk/openai";
import { streamText, tool } from "ai";
import { z } from "zod";
const result = await streamText({
model: openai("gpt-4o"),
messages,
tools: {
getWeather: tool({
description: "Get weather for a location",
parameters: z.object({
location: z.string().describe("City name"),
}),
execute: async ({ location }) => {
// Fetch weather data
return { temperature: 72, condition: "sunny" };
},
}),
},
});
```
## useCompletion (Text Generation)
```typescript
import { useCompletion } from "@ai-sdk/react";
import { DefaultCompletionTransport } from "ai";
const { completion, complete, isLoading } = useCompletion({
transport: new DefaultCompletionTransport({ api: "/api/complete" }),
});
// Trigger completion
await complete("Write a haiku about");
```
## Error Handling
```typescript
const { error, messages, sendMessage } = useChat({
transport: new DefaultChatTransport({ api: "/api/chat" }),
onError: (error) => {
console.error("Chat error:", error);
toast.error("Failed to send message");
},
});
// Display error
{error && (
<div className="error">
{error.message}
<button onClick={() => sendMessage({ text: lastInput })}>
Retry
</button>
</div>
)}
```
## Keywords
ai sdk, vercel ai, chat, streaming, langchain, openai, llm
© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills