用途:该技能面向 Next.js App Router 的路由处理器(route handler)开发,适用于创建或重构 app/api/**/route.ts、实现 API 端点、校验请求输入、返回标准化 JSON 响应,以及判断服务端与客户端组件边界。
主要能力:强调路由处理器必须轻薄——只做输入校验、调用 services/ 中的函数、返回响应,不在处理器内直接写业务逻辑或 IO;绝不返回未校验的请求输入。提供标准 JSON 响应结构:成功用 { data },错误用 { error: { code, message } },并使用合适 HTTP 状态码(200、201、204、400、401、403、404、409、500)。同时覆盖 Server/Client 组件默认值与边界:app/**/page.tsx 和 layout.tsx 默认是服务端组件,仅在需要状态、事件处理、副作用或浏览器专属 API 时使用客户端组件;'use client' 形成边界,应保持客户端岛尽量小;从服务端传入客户端的 props 必须可序列化。
使用方式:按规则文件查阅细节,如 rules/nextjs-thin-handler-rule.md、rules/nextjs-response-shapes.md、rules/nextjs-validation-boundaries.md。相关规则还涉及路由放置与页面冲突、支持的 HTTP 方法、缓存模型、校验位置与模式、校验辅助函数,以及保护仅服务端代码不被客户端导入等。相关技能包括 busirocket-react、busirocket-validation、busirocket-core-conventions。
限制:资料未提供具体安装命令、价格或平台信息;具体代码示例需查阅各规则文件,此处不展开。