SuperAPI AI 工具集

component-design

设计与创作

查看项目

更新于 10-16 06:23

技能介绍

用途:为 Next.js App Router 项目设计 React 组件时提供指导,重点在组件 API 表面、组合方式以及 Server/Client 边界。

主要能力:

  1. 默认使用 Server Component,仅在需要交互(hooks、事件处理、浏览器 API)时才用 Client Component。
  2. 下推客户端边界:把交互部分抽成尽量薄的 Client 包装,其余保留在服务端。
  3. 接口优先:先定义公开接口,包括 props(必填与可选、类型)、children 组合模型(插槽、render props、复合组件)、ref 转发策略,以及 loading、empty、error 状态。
  4. 通过接口测试:若测试需要访问内部状态或私有方法,说明接口设计有问题,公开 API 应是唯一测试面。

使用方式:资料给出 Server/Client 决策树——组件是否需要 hooks、事件或浏览器 API;不需要则用 Server Component;需要则用 Client Component,并判断交互部分能否隔离,能则抽成薄 Client 包装,不能则整体作为 Client 但保持聚焦;若需把服务端数据传入,则由服务端父组件以 props 传递。

接缝放置:layout.tsx 用于持久外壳与跨路由共享 UI,loading.tsx 用于路由段流式回退,error.tsx 用于路由段错误边界,not-found.tsx 用于 404 边界,组件 props 用于多态,插槽 props(children、具名插槽)用于以组合代替配置。

检查清单:能否作为 Server Component;Client 边界是否尽量薄;是否覆盖所有状态(loading、empty、error、边界情况);接口是否为唯一测试面;组件是否可组合或可配置(优先组合);命名是否反映功能而非渲染方式;删除该组件时调用方是否会不可预测地出错(删除测试)。

限制:资料未提供具体安装命令、依赖版本、收费信息或平台支持范围,暂未提供。