如果你用 Claude Code、Cursor 或 Codex 写代码,起手选哪个模板,意义已经变了:智能体会先读仓库再动手,它读到什么,决定了第一处改动是贴合你的代码库,还是跟它打架。

现在越来越多模板开始附带智能体指令文件——AGENTS.md、CLAUDE.md、Cursor 规则、Claude 技能,甚至 MCP 服务器。但文件存在,说明不了太多。这次盘点把它们逐个打开看:每个模板都在 2026年11月核验过,行数和内容直接取自文件本身,自家模板也一并列入,标准相同。

先说结论:最彻底的免费选项是 Kiranism 的 next-shadcn-dashboard-starter,一份约 800行的 AGENTS.md,外加八个 Claude 技能。做商店的话,Your Next Store 和 vercel/shop 都附带了详细且针对项目的指南。付费套件里 MakerKit 走得最远:AGENTS.md、CLAUDE.md、GEMINI.md、Claude 技能与智能体,再加一个 MCP 服务器。TheKitBase 的模板篇幅更短、没有技能,但会明确告诉智能体哪些是模拟的、改哪个文件能变成真的。

先看一个前提:每个新 Next.js 应用都自带 AGENTS.md

从 Next.js 16.2 起,框架会在 node_modules/next/dist/docs 里附带与版本匹配的文档,create-next-app 和 next dev 都会在项目根目录写入一个受管理的 AGENTS.md 区块,提示智能体写代码前先读这些文档。该区块标题是「This is NOT the Next.js you know」,由 next dev 重新生成,可通过 next.config 里的 agentRules 选项关闭。

Claude Code、Cursor、Codex 和 Copilot 都读 AGENTS.md,不少模板会加一行 CLAUDE.md 来导入它。这就把问题换了个问法:任何跑在 Next.js 16.2 或更高版本的模板,第一次运行就拿到这份基线。真正值得比较的,是模板在此之上为自己代码追加的部分。

挑模板的智能体文件,看这几项

  • 项目地图:跑什么命令、东西放在哪、智能体该照抄而不是重新发明的约定。
  • 边界:智能体不许改的文件(生成代码、平台托管文件),以及哪一层归谁管。
  • 哪些是模拟的:AI、支付或数据如果是演示桩,智能体得在往上盖楼之前知道,最好还知道该替换哪个文件。
  • 怎么验证改动:智能体收工前该跑的 lint、测试或无障碍命令。
  • 工具专属附加项:Claude 技能(.claude/skills)和 MCP 服务器确实有用,但技能只在 Claude Code 里生效。AGENTS.md 才是 Claude Code、Cursor、Codex、Copilot 都读的那一个文件。
  • 单一事实来源:导入 AGENTS.md 的 CLAUDE.md 能保持同步,复制一份的 CLAUDE.md 会漂移。

免费模板

next-shadcn-dashboard-starter(github.com/Kiranism/next-shadcn-dashboard-starter):免费模板里最彻底的智能体配置。AGENTS.md 约 800 行,涵盖项目概览、技术栈细节、结构、命令和模式,旁边配一份 CLAUDE.md,.claude/skills 下有八个 Claude 技能,覆盖 shadcn、TanStack Query 与 Form、Next.js 最佳实践以及项目自身约定。它是一个能跑的管理后台(MIT,Next.js 16),认证、组织和计费跑在 Clerk 上。

Your Next Store(github.com/yournextstore/yournextstore):为智能体而生的电商模板。440 行 AGENTS.md 覆盖命令、关键文件、一份「平台托管文件——请勿修改」清单、项目模式、预渲染外壳、性能与无障碍基线,以及它的电商 SDK;CLAUDE.md 导入它,.claude 里有 Claude 技能。MIT,Next.js 16,运行需要 YNS 电商服务的 API 密钥。

vercel/shop(github.com/vercel/shop):Vercel 的 Shopify 店面,架构指引是这组里最清楚的。AGENTS.md 围绕三个归属方组织——Shopify 管电商、Next.js 管应用、eve 管购物智能体——每层都有边界规则,还有发布与测试策略以及 Next.js 受管理区块。它也附带 Claude 技能。MIT,Next.js 16,且很新,预计还会变。

ixartz 的 Next.js Boilerplate(github.com/ixartz/Next-js-Boilerplate):把这件事做好的紧凑范例。约 70 行,讲原则、命令、提交约定、环境、样式、React、i18n 和测试规则,其中有一小节讲 token 效率;CLAUDE.md 导入 AGENTS.md。没有技能,但也没浪费。MIT,Next.js 16。

付费套件

MakerKit:它的 Next.js 套件(Supabase、Drizzle 或 Prisma)附带本次盘点中最宽的智能体配置。Drizzle 套件的文档列出:AGENTS.md 管项目规则,CLAUDE.md 作入口,GEMINI.md 给 Gemini,.claude 文件夹里有智能体、命令和技能(drizzle-expert、frontend-design、playwright-e2e-expert、react-form-builder、server-actions-expert),以及通过 .mcp.json 接入的 MCP 服务器;具体技能因套件而异。MakerKit 注明技能仅限 Claude Code,其他智能体用 AGENTS.md 和 MCP 服务器。Pro 版标价 349美元一次性买断。

supastarter:官方称每个起步套件——Next.js、Nuxt 和 TanStack Start——都附带维护中的 AGENTS.md 加 Agent Skills,旁边还有 Cursor 规则。SaaS 起步套件 Solo 版标价 349美元一次性。仓库是私有的,文件本身没法查看,以上来自 supastarter 自己的文档。

DirStarter:一个 Next.js 16 目录模板,对智能体的切入角度不同——用 MCP 服务器让 Claude Code 或 Cursor 从 URL 添加、描述和排期目录条目,Pro 版还有面向 Claude、Cursor 和 Codex 的 AI 技能。如果智能体要运营这个目录而不只是搭建它,会有用。付费;核验时定价在促销,现价请看官网。

TheKitBase(自家):全部 14 个付费模板都附带 AGENTS.md、CLAUDE.md 和 .cursorrules,各约 70 行,覆盖命令、东西放在哪、设计系统、约定、怎么加页面和无障碍。想强调的是「支付与 AI」那一节:直白告诉智能体哪些是真的、哪些是演示,以及在哪改。比如 Keel 的模板写明助手跑在 src/lib/ai.ts 的模拟引擎上、不发起任何模型调用,计费没有接支付服务商,startCheckout() 在 src/lib/billing.ts 里、是接支付的地方。每个模板还会给智能体一条 UI 改动后要跑的无障碍测试(npm run test:a11y)。

不足之处也说清楚:没有 Claude 技能,没有 MCP 服务器,CLAUDE.md 是 AGENTS.md 的副本而非导入,.cursorrules 是 Cursor 的旧格式(Cursor 也读 AGENTS.md)。Next.js 受管理区块没有提交进仓库,但 next dev 首次运行会加上。官网的 /ai-ready 页面把每个模板的智能体文件与实际 AI 状态并排列出——哪些跑真模型、哪些跑基于规则或预置的演示、哪些完全没有 AI 功能。

几个要留意的坑

  • 库仓库不等于模板:Fumadocs 和 shadcn/ui 也有 AGENTS.md,但那是给库的贡献者看的,不是给你用它搭出来的应用看的。
  • 复制来的文件:TailAdmin 的免费 Next.js 后台附带一份标题为「TailAdmin Pro」的 AGENTS.md,所以得确认智能体文件描述的是你手上这份代码。
  • 只有 lint 规则的规则:vercel/chatbot 的 .cursor/rules 装的是 Ultracite 的格式与 lint 规则,有用,但不是项目指南。
  • 技能是工具专属的:.claude/skills 只帮 Claude Code,别的都不管。团队混用工具的话,AGENTS.md 才是大家共享的那份。

怎么选

想要免费且最丰富的智能体上下文,从 Kiranism 的后台起步模板开始;做电商就看 Your Next Store 或 vercel/shop。如果付费买整套 SaaS 套件、又同时用多个智能体,MakerKit 的配置(带 MCP)是本次找到最完整的。如果你要的是一个做完、设计好的产品,且智能体清楚知道哪些部分是演示桩、怎么把它们变成真的,那正是自家模板围绕搭建的方向。