用途:为项目生成调用外部 REST API 的代码,风格为 axios + TypeScript,包含服务类、类型定义与测试文件。触发关键词包括外部 API 集成、支付 API 调用、短信发送 API 等。
主要能力:按模板生成 Service(静态方法、自带 JSDoc 注释、覆盖 GET/POST 等模式)、Type(含 CommonResDto<T> 泛型响应与请求/响应 DTO)以及基础测试结构(含 API 调用模拟)。支持方法、鉴权需求、请求/响应字段等配置,并做模板变量替换(模块名 kebab-case、Service 类名 PascalCase、环境变量 UPPER_SNAKE_CASE、方法名 camelCase、端点路径、DTO 名)。
使用方式:先收集模块名(必填)、Base URL 的环境变量名、端点列表、HTTP 方法、是否需要 Authorization、请求与响应字段;再读取参考模式,将文件生成到 api/src/modules/{{module-name}}/ 下的 service/、type/、test/ 目录;最后提示配置环境变量,例如在 env.{stage}.yml 中设置 {{ENV_VAR}}_API_URL。
验证:cd api && bun run build;cd api && bun run lint:fixed;cd api && bun test src/modules/[模块名]/test/。完成条件为构建成功、lint 通过、环境变量设置说明到位,并输出生成文件路径、测试运行方式与在 Controller 中使用 Service 的示例。
限制:面向固定目录与模板约定(api/src/modules/),依赖 bun 脚本;其余平台支持情况与收费暂未提供。