SuperAPI AI 工具集

feature-builder

编程与开发

查看项目

更新于 10-16 05:57

技能介绍

用途

Feature Builder 用于把功能需求转化为完整、可运行的 React 功能实现,强调分层架构与关注点分离。它面向的是“完整功能”而非单个 UI 组件,例如用户认证、购物车、带筛选的商品列表、文件上传、实时通知等。当用户提出“实现”“构建”“创建功能”类请求,且涉及业务逻辑与数据管理时,适合使用该技能。

主要能力

该技能按三层架构组织代码:

  • 表现层:React 组件与 Tailwind CSS,负责界面呈现。
  • 业务逻辑层:Zustand 状态、hooks、校验与数据转换。
  • 数据访问层:API 客户端、React Query 的查询与变更。

它覆盖的能力包括:UI 组件生成、业务逻辑(hooks、stores、校验、转换)、API 集成(数据获取、变更、缓存)、状态管理(Zustand 管理全局状态,React Query 管理服务端状态)、错误处理与 TypeScript 类型安全。

使用方式

技能内置一套工作流:

  1. 分析功能请求:判断功能类型(认证/授权、CRUD、文件处理、实时更新、搜索/筛选、复杂工作流)、所需层级、依赖关系。
  2. 规划架构:按 features/[feature-name]/ 目录组织 components、hooks、stores、api、utils、types 与入口文件。
  3. 交互式澄清需求:通过 AskUserQuestion 询问需要管理的数据、所需操作、是否需要认证、附加要求等。
  4. 生成功能代码:按类型(types)→ API 层(api client、React Query hooks)→ 业务逻辑层(Zustand stores、自定义 hooks、Zod 校验)→ 表现层(React 组件)的顺序生成。
  5. 提供实现指南:包括安装依赖、项目集成方式、使用示例与测试建议。

示例安装命令为:npm install @tanstack/react-query zustand zod axios。集成时通过 QueryClientProvider 包裹应用。

适用场景

适用于需要完整功能实现的 React 项目,尤其是涉及业务逻辑与数据管理的场景。文档给出的示例包括:实现用户认证、构建购物车、创建带筛选的商品列表、添加文件上传功能、实现实时通知。也适用于从设计稿实现功能(配合 ui-analyzer 提取 UI 结构)或在需求模糊时先澄清再构建(配合 prompt-optimizer)。

限制

资料未提供该技能的收费、价格、平台支持范围、性能指标或效果保证等信息。其生成代码依赖 React、TypeScript、Tailwind CSS、React Query、Zustand、Zod、axios 等技术栈;具体项目适配情况需结合实际环境判断。资料未说明对非 React 技术栈的支持情况。