LogoNEXTDEVKIT 教程

集成 AI Agents

本教程将帮助你快速上手 NEXTDEVKIT 配合 AI IDE 使用,包括 AI Rules 和 MCP 的安装和使用。

对于当前的时代而言,模板加上 AI 的加持,可以极大的提高开发效率。

对于现在大模型语言而言,无论是 GPT 也好,Claude 也好,从零搭建一个完整的,易于扩展的,稳定的 SaaS 项目是比较困难的,因为 AI 不擅长代码抽象和组织整理,并且缺乏对项目架构的认知。

所以大多数完全从零开始使用 AI 来 Vibe Coding 的项目,到了一定阶段,都会遇到脆弱的代码架构,以及难以维护的代码问题。bug 多,代码非常零碎,难以进一步的使用 AI 来 Vibe Coding。

这也是我在当前推出 NextDevKit 的原因之一,如果 AI 基于一个已经有完善的组织架构的项目,有明确的代码结构,如何继续编写代码的指令,以及完善的文档支持。那么使用 AI 来 Vibe Coding 绝对是事半功倍,因为我本人也是基于这个原因,所以才开发了 NextDevKit,帮助我自己更好的 Vibe Coding。

NextDevKit 通过 Ruler 项目可以集成大多数现代 AI 开发工具,包括像 AI IDE 例如 Cursor 和 Copilot 等,也支持 Claude Code 和 Gemini 这样的 AI CLI 工具。

NextDevKit 有完善的文档,并且已经默认集成了 Context7 这样的 AI 代理,可以直接通过 MCP 来访问最新文档。并且内置了一套 AI Rules 指令,可以方便快速集成开发功能。

选择 AI IDE

市面上的 AI IDE 有很多,例如 Cursor、Copilot、Gemini、AugmentCode、Claude Code 等。

NextDevKit 为了集成不同的 AI IDE,所以需要使用 Ruler 项目来管理 AI IDE 的配置。

关于 Ruler 项目,请参考 Ruler 官方文档

所以目前来讲,使用 Ruler 项目支持的 AI Agents 会有更好的体验,如果目前你使用的 AI IDE 不在 Ruler 项目支持的列表中,那么你可以手动将对应的 Rules 和 MCP 配置到你的项目中。

AI IDE 的使用可以结合你自己的情况和价格来进行选择,我个人的推荐是使用 Cursor + Claude Code 的组合,大模型推荐使用 Claude 4 Sonnet Think 模型。综合体验下来最好。

AI Rules 指令

NextDevKit 为了可以帮助你更快的进行二次开发,更好的使用 AI 工具,内置了一套 AI Rules 指令,可以方便快速集成开发功能。

.ruler/
├── engineering
   ├── common-commands.md
   ├── core-files-and-functions.md
   └── development-guidelines.md
├── instructions.md
├── mcp.json
├── project
   └── project-architecture.md
└── ruler.toml

安装

如何将这些 rules 配置到你的 AI IDE 中,那么你首先需要全局安装 Ruler:

npm install -g @intellectronica/ruler

快速开始

将内置的 rules 应用到你的 AI 代理:

# 应用到所有配置的代理,基于你的 ./ruler/ruler.toml 配置文件
ruler apply

# 仅应用到特定代理,例如 Cursor
ruler apply --agents cursor

预配置规则

NextDevKit 包含 4 个核心指令文件:

  • 🏗️ 项目架构 - 完整项目结构和技术栈
  • 🛠️ 开发规范 - 编程标准和最佳实践
  • 🔧 核心功能 - 关键文件位置和函数参考
  • 常用命令 - 开发命令和部署流程

建议

AI rules 并不是越多越好,rules 越多可能大模型的幻觉越严重,对于实际开发帮助不大,尽量添加和你需求相关的到你的 prompt 中。

NextDevKit 暂时默认集成了四个 rules 文件,都是基于 NextDevKit 项目结构和功能编写的,你可以将它作为你自己的规则指令参考。

如果你不想使用默认的 rules 文件,那么你可以手动将对应的 Rules 和 MCP 配置到你的项目中。

我强烈建议如果你要使用 AI rules 的这种方式,那么你最好仔细阅读其中的指令内容,并且根据你的需求进行调整。

不要使用你不熟悉的指令规则,不然 AI 很可能不会按照你的需求来执行。

例如核心功能的指令文件如下所示,你可以将它作为你自己的规则指令参考。

上面的文件是一个参考,在不同的模板中,例如 cloudflare workers 模板中会有一些专门的变动和优化。

合理的指令规则集加上清晰的 Prompt,绝对能极大的提高开发效率。

AI + Docs

除了 AI rule 指令集外,NextDevKit 还提供了全面完善的文档,AI 代理可以通过 Context7 MCP 集成访问这些文档。这确保 AI 始终拥有最新的项目信息。

并且 NextDevKit 的文档提供 llms.txt 文件支持,可以更好的被 AI 代理和爬虫访问。

优势:

  • 始终访问最新文档
  • 针对 NextDevKit 的上下文化响应
  • 无需手动搜索@相关文档

如果你还需要更多的文档索引支持,也可以通过 Context7 的 MCP 来检索更多的文档。

例如 Better Auth、Drizzle ORM、Shadcn UI 的文档等。

关于如何使用,你只需要简单的告诉 AI 下面的指令即可。

帮我通过 Context7 查询 NEXTDEVKIT 的文档,然后 xxxx

AI + MCP

NextDevKit 目前只默认集成了 Context7 这一个 MCP 服务器。

你可以在 .ruler/mcp.json 文件中配置了更多的 MCP 服务器。然后运行 ruler apply --with-mcp 来应用这些配置。

我个人的经验是大量的 MCP 集成对于开发效率来讲并没有太大有效果。建议仅仅集成你需要的 MCP 服务器。

配置 Context7

NextDevKit 预配置了 Context7:

# 应用 MCP 配置
ruler apply --with-mcp

# 仅应用到特定代理
ruler apply --agents cursor --with-mcp

需要手动启用

⚠️ 重要:运行 ruler 后,你必须在 AI IDE 设置中检查或者手动启用 MCP 功能。否则可能只是安装好了,但是并没有启用。

使用方法

配置完成后,向 AI 询问问题如:

  • "Context7 中查询 NextDevKit 如何配置身份验证?"

AI 将自动通过 Context7 查询 NextDevKit 文档。

总结

好了,这一步你已经完成了 AI Agents 的集成,并且可以开始使用 AI 来 Vibe Coding 了。

下一步你将理解 NextDevKit 代码的结构和组织方式,并且将在本地启动你的服务!