用途:在改动前后强制检查 Next.js 项目架构,先确认项目是否使用 App Router、Pages Router 或混合模式,再按触碰面应用最小规则集,覆盖路由文件约定、Server/Client 组件边界、数据与缓存、Server Actions、Route Handlers、Proxy 及平台环境安全。
主要能力:提供架构规则文件,包括 architecture-rules.md 与 rules/ 下的 routes、project-structure、services、hooks、db、execution-model、data-fetching、server-actions、route-handlers、platform、validation,并提供官方参考文档。内置快速选择表,例如 UI 写操作用 Server Action、webhook/CORS/公开 API 用 Route Handler、初始页面数据用 Server Component、缓存用 cacheComponents 与 use cache/cacheTag/cacheLife。
使用方式:先用 rg -n '"next"' package.json、find 查找 app/、src/app/、pages/ 目录,以及 test -f next.config.ts 等命令确认项目与路由模式;随后按需加载对应规则文件执行检查,变更后运行 validation.md 相关检查,技能目录变化时运行 scripts/validate-nextjs-architecture-skill.mjs。
限制:不适用于通用 React、Remix、TanStack Start 项目,也不用于纯文档总结或纯文案编辑。Pages Router 项目只应用共享安全检查,不强制 App Router 文件约定,除非用户要求迁移。官方文档优先于本地约定,本地目录约定不得表述为官方规则;破坏性迁移、凭据、生产副作用与大规模 codemod 需人工把关。面向用户的产出默认韩语,除非用户明确要求其他语言。默认每次请求只执行一次强制检查。