mcpField
A
ai-app

ai-app

github.com/laguagu开发70191 次安装2 天前更新
代码仓库

关于 ai-app

用于规划和实现 AI 应用的技能,要求保留项目现有技术栈和 SDK 主版本。它指导开发者选择版本、在服务端处理凭据与授权,并验证用户流程和集成。

主要功能

  1. 01确定 AI SDK 和提供方版本
  2. 02在服务端保管凭据并执行授权
  3. 03构建最小完整用户流程
  4. 04匹配服务端流与客户端传输
  5. 05验证多轮对话、工具状态和错误

适用场景

  1. 01启动新的 AI 应用
  2. 02在现有技术栈中加入聊天功能
  3. 03实现 Agent 控制面板
  4. 04验证流式多轮交互

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/laguagu/claude-code-nextjs-skills --skill ai-app

安装后在 Claude Code 中输入/ai-app确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
agent-dashboard.md
chatbot.md
examples.md
project-structure.md

详细介绍

AI 应用设置

围绕用户、数据和操作构建所需的应用。除非任务包含迁移,否则保留现有技术栈和 SDK 主版本;新建 JavaScript 项目时使用 Bun。

  1. 通过 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/ 和提供商文档。
  2. 使用 nextjs-shadcn 设置框架,并使用 frontend-design 确定视觉方向。如果其组件适合所需的聊天界面,则使用 ai-elements;检查已安装的源码,不要臆测注册表中的属性。
  3. 将提供商凭据和授权保留在服务端。根据配置或所选提供商的目录确定模型 ID。
  4. 实现最精简但完整的用户流程。根据应用需求添加持久化、审批、附件、搜索、建议或仪表板。
  5. 确保服务端流与客户端传输匹配。除项目的类型检查和构建外,还要验证第二轮对话、相关工具状态、安全的错误处理以及移动端行为。

阅读与所构建应用相关的内容

  • 聊天机器人:对话和流式传输约定。
  • Agent 仪表板:执行、审批和运行状态。
  • 示例:当前官方实现。
  • 项目结构:不固定目录树的边界划分。
  • nextjs-chatbot:持久化历史记录、反馈、嵌入和生产环境检查。

这些参考资料描述的是要求,而非可直接复制的生产模板。

评论

支持 Markdown