网易首页 > 网易号 > 正文 申请入驻

800行AGENTS.md:免费Next.js模板AI说明书对比

0
分享至

如果你用 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)是本次找到最完整的。如果你要的是一个做完、设计好的产品,且智能体清楚知道哪些部分是演示桩、怎么把它们变成真的,那正是自家模板围绕搭建的方向。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
炸锅!复旦教授竟否认黄岩岛属中国?网友怒骂卖国贼

炸锅!复旦教授竟否认黄岩岛属中国?网友怒骂卖国贼

平老师666
2026-11-19 22:22:59
她是首位被枪毙的女星,曾火遍大江南北,临终前称我是有功之臣

她是首位被枪毙的女星,曾火遍大江南北,临终前称我是有功之臣

史明人生
2026-11-01 21:50:17
国际油价,巨震!中东,大消息!

国际油价,巨震!中东,大消息!

新浪财经
2026-11-20 20:32:29
印度尼西亚总统公开表示:印尼坚定奉行一个中国政策,认为台湾是中华人民共和国的一个省

印度尼西亚总统公开表示:印尼坚定奉行一个中国政策,认为台湾是中华人民共和国的一个省

吉刻新闻
2026-11-20 15:33:46
邝港智再曝猛料:蔡天凤见邝球前还活着,在庭上与邝港杰相视而笑

邝港智再曝猛料:蔡天凤见邝球前还活着,在庭上与邝港杰相视而笑

娱站
2026-11-20 12:46:52
震惊!珠海头部国企突发暴雷,为什么直接砸穿你的理财产品?

震惊!珠海头部国企突发暴雷,为什么直接砸穿你的理财产品?

干货收并购
2026-11-20 10:39:16
北京49岁岳母自述:从前并不觉得世上有天生坏种,直到遇到了他

北京49岁岳母自述:从前并不觉得世上有天生坏种,直到遇到了他

温情邮局
2025-05-12 15:59:16
养老金若不再大幅上调,真正承压的,可能不是已经退休的老人

养老金若不再大幅上调,真正承压的,可能不是已经退休的老人

你在偷看谁
2026-10-31 19:07:37
俄罗斯2027年军费暴增32%,医疗、养老金相关支出和住房预算却要削减

俄罗斯2027年军费暴增32%,医疗、养老金相关支出和住房预算却要削减

桂系007
2026-11-21 00:08:16
不够硬!国少惨败西班牙,输在三点:裁判争议大,犯规咋比对手少

不够硬!国少惨败西班牙,输在三点:裁判争议大,犯规咋比对手少

南海浪花
2026-11-21 00:45:31
凯尔特人终于找到了罗宾逊的使用手册!他与塔图姆确实不搭

凯尔特人终于找到了罗宾逊的使用手册!他与塔图姆确实不搭

夜白侃球
2026-11-20 22:05:09
三星代工叫停?GPU赛道全线暴跌!燧原科技20cm跌停,官媒辟谣了

三星代工叫停?GPU赛道全线暴跌!燧原科技20cm跌停,官媒辟谣了

金石随笔
2026-11-20 07:18:15
董明珠突然卸任

董明珠突然卸任

新行情
2026-09-23 14:30:37
微信上这样回复你的人,其实是看不起你,不要犯傻了

微信上这样回复你的人,其实是看不起你,不要犯傻了

十指说情
2026-10-08 09:08:08
秦主任跳舞为什么会爆火?

秦主任跳舞为什么会爆火?

廖保平
2026-10-16 08:40:35
英国向乌克兰提供千枚导弹!美国会计划7.5亿援乌资金

英国向乌克兰提供千枚导弹!美国会计划7.5亿援乌资金

项鹏飞
2026-11-18 20:26:13
赛季三分50中22!为何波普在76人又成顶级3D?詹姆斯有他的说明书

赛季三分50中22!为何波普在76人又成顶级3D?詹姆斯有他的说明书

小路看球
2026-11-21 00:03:24
古人有多会玩?动物的器官做工具,让人在快乐中窒息而死

古人有多会玩?动物的器官做工具,让人在快乐中窒息而死

赵枹是个热血青年
2026-11-17 14:56:15
杯水车薪,隐患重重!俄罗斯计划投入74亿美元修缮桥梁,89%濒临坍塌桥梁却不在修缮清单内

杯水车薪,隐患重重!俄罗斯计划投入74亿美元修缮桥梁,89%濒临坍塌桥梁却不在修缮清单内

军迷战情室
2026-11-19 21:31:42
李奇微晚年亲口坦言,志愿军把重伤员安置在公路上等候美军接走撤离,全程未开一枪,这样的举动远比胜仗更令美军后背发凉

李奇微晚年亲口坦言,志愿军把重伤员安置在公路上等候美军接走撤离,全程未开一枪,这样的举动远比胜仗更令美军后背发凉

唠叨说历史
2026-11-09 20:04:03
2026-11-21 02:24:49
闪存猎手
闪存猎手
全网蹲好价的野生捕手,算力与羊毛都不可辜负。
280文章数 84关注度
往期回顾 全部

科技要闻

Anthropic收涨17.1%,市值一度破2万亿美元

头条要闻

历时14小时特朗普返回美国 刚下飞机就发布"重大预告"

头条要闻

历时14小时特朗普返回美国 刚下飞机就发布"重大预告"

体育要闻

脚步未停!西班牙摩托车手赤脚徒步入境中国

娱乐要闻

官媒发文 官宣赵丽颖新身份,进步很大

财经要闻

最大回撤超37%,黄金崩盘了吗?

汽车要闻

35万级MPV的满配答案 享界V8正式上市售31.98万起

态度原创

时尚
亲子
艺术
公开课
军事航空

《后会友期》的癫,还得她们治

亲子要闻

为什么儿童烫伤后要立即冲凉水?专家释疑

艺术要闻

2026 研究与超越——中国小幅油画作品双年展 油画选(二)

公开课

李玫瑾:为什么性格比能力更重要?

军事要闻

沙特首都第一高楼遭袭:炮弹从天而降

无障碍浏览 进入关怀版