SuperAPI AI 工具集

api-enrichment

编程与开发

查看项目

更新于 10-15 21:39

技能介绍

用途:在 UI 切版预览确认后(vue3-layout 断点 B),补充 API 对应、数据模型、State 结构与错误处理方案,产出 enriched-spec.md,供下游 logic-coder 直接注入 API 逻辑。

主要能力:读取 spec.md 的推测字段、待定数据模型清单与 Open Questions;解析 OpenAPI/Swagger 提取相关 Endpoint、Request/Response Schema、错误码与依赖关系;将 Figma UI 元件与 API 字段对齐;规划 Vue 3 + TypeScript 的 API State、页面 State(loading/error/分页)与衍生 State;定义 API Response → UI Props 的 Mapping 与格式化规则;制定 HTTP 状态码与 UI 呈现的对应表。

使用方式:先确认输入来源(spec_path、component_paths、figma_node_ids、preview_verified,以及可选的 api_documentation、figma_link),缺少 spec.md 时输出 blocked 并停止。有 OpenAPI 时进入解析模式;无文档时反推数据模型候选提案并等待用户确认。随后对齐 API 与设计稿、规划 State、定义 Mapping 与错误处理,输出含 10 个章节的 enriched-spec.md,并进入断点 B-C 等待 Approve。

适用场景:Vue 3 前端项目在切版完成后、编写业务逻辑前的规格补充阶段。

限制:只记录 OpenAPI 中确实存在的信息,不得凭空假设;无法推导的项标记 [Assumption] 或 [Open Question];未收到 Approve 前不继续下游产出;具体命令、依赖与安装方式暂未提供。