关于 ai-app
用于规划和实现 AI 应用的技能,要求保留项目现有技术栈和 SDK 主版本。它指导开发者选择版本、在服务端处理凭据与授权,并验证用户流程和集成。
主要功能
- 01确定 AI SDK 和提供方版本
- 02在服务端保管凭据并执行授权
- 03构建最小完整用户流程
- 04匹配服务端流与客户端传输
- 05验证多轮对话、工具状态和错误
适用场景
- 01启动新的 AI 应用
- 02在现有技术栈中加入聊天功能
- 03实现 Agent 控制面板
- 04验证流式多轮交互
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ laguagu/ claude-code-nextjs-skills --skill ai-app安装后在 Claude Code 中输入/ai-app确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/agent-dashboard.mdchatbot.mdexamples.mdproject-structure.md详细介绍
AI 应用设置
围绕用户、数据和操作构建所需的应用。除非任务包含迁移,否则保留现有技术栈和 SDK 主版本;新建 JavaScript 项目时使用 Bun。
- 通过
ai-sdk确认已安装的 AI SDK 主版本;实现时使用ai-sdk-6或ai-sdk-7。新应用默认使用 AI SDK 7:ai@7、@ai-sdk/react@4,以及各提供商的latest版本(提供商的主版本 各不相同;Node.js 22+)。只有在必需的依赖锁定 v6 时才保留 v6。AI Elements 仍以 v6 为目标,其context.tsx在修补前无法通过 v7 类型检查 (参见ai-elements)。使用网页示例前,先阅读匹配版本的ai/docs/和提供商文档。 - 使用
nextjs-shadcn设置框架,并使用frontend-design确定视觉方向。如果其组件适合所需的聊天界面,则使用ai-elements;检查已安装的源码,不要臆测注册表中的属性。 - 将提供商凭据和授权保留在服务端。根据配置或所选提供商的目录确定模型 ID。
- 实现最精简但完整的用户流程。根据应用需求添加持久化、审批、附件、搜索、建议或仪表板。
- 确保服务端流与客户端传输匹配。除项目的类型检查和构建外,还要验证第二轮对话、相关工具状态、安全的错误处理以及移动端行为。
阅读与所构建应用相关的内容
- 聊天机器人:对话和流式传输约定。
- Agent 仪表板:执行、审批和运行状态。
- 示例:当前官方实现。
- 项目结构:不固定目录树的边界划分。
nextjs-chatbot:持久化历史记录、反馈、嵌入和生产环境检查。
这些参考资料描述的是要求,而非可直接复制的生产模板。
评论
支持 Markdown