SuperAPI AI 工具集

new-component

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:按项目约定创建一个新的 React 组件,并同时生成 TypeScript 类型接口、单元测试和 barrel 导出文件。

主要能力与流程:

  1. 确定位置:判断属于 UI 组件(src/components/ui/)还是功能组件(src/components/features/);不明确时会询问。
  2. 创建文件:ComponentName.tsx 组件实现、ComponentName.test.tsx 单元测试、index.ts barrel 导出。
  3. 生成模板:组件使用 forwardRef 转发 DOM 引用,使用 type ComponentPropsWithoutRef 定义 Props 并扩展自 'div',通过 cn 工具函数合并样式类;支持 variant(default/primary/secondary)与 size(sm/md/lg)两个可选属性,设置 displayName,并以 JSDoc 注释文档化 Props。
  4. 测试:基于 @testing-library/react 和 @testing-library/user-event,覆盖子元素渲染、默认 variant 样式、自定义 variant、size 类、自定义 className 合并以及 ref 转发。

使用方式:将组件名作为参数 $ARGUMENTS 传入,技能据此命名文件与组件。

检查清单:已创建含 TypeScript Props 接口的组件;DOM 元素组件使用 forwardRef;已添加 displayName;已创建较全面的测试;已添加 barrel 导出;已用 JSDoc 记录 Props。

适用场景:在遵循上述目录约定和 React + TypeScript 技术栈的项目中快速搭建新组件。

限制:资料仅给出模板与流程,未提供安装命令、依赖版本、运行测试的命令,也未说明价格、适用平台或具体效果;不明确位置时会询问用户。