SuperAPI AI 工具集

adr-scaffold

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:为 Gravito 项目生成遵循 Action-Domain-Responder(ADR)模式的样板代码,适用于按 ADR 架构新增功能或模块的场景。

主要能力:按“ADR 标准”目录结构组织代码,包括 src/actions/(领域层:业务逻辑)、src/controllers/(响应层:HTTP 处理器)、src/models/(Atlas 模型)、src/repositories/(数据访问)、src/types/(requests 请求类型与 responses 响应类型契约)、src/routes/(路由定义)。层规则要求:Actions 层每次业务操作对应一个 Action 类,实现 execute 方法,保持与框架无关,多行操作在 actions 内使用 DB.transaction;Controllers 层为薄响应层,不含业务逻辑,流程为解析参数、调用 Action、返回格式化 JSON。

典型用法(Standard Operating Procedure,工作流):

  1. 在 src/models/ 定义 Atlas 模型;
  2. 在 src/repositories/ 构建仓储;
  3. 在 src/types/ 定义请求/响应类型;
  4. 在 src/actions/[Domain]/ 实现单个 Action;
  5. 在 src/controllers/ 创建控制器进行粘合;
  6. 在 src/routes/api.ts 映射路由。

基础 Action 蓝图:

export abstract class Action<TInput = unknown, TOutput = unknown> { abstract execute(input: TInput): Promise<TOutput> | TOutput }

典型 Action 实现:

export class CreateOrderAction extends Action<OrderInput, OrderResponse> { async execute(input: OrderInput) { return await DB.transaction(async (trx) => { // 1. Validate... // 2. Persist... // 3. Trigger events... }) } }

限制:所给资料未说明安装命令、收费模式、支持平台或具体版本要求,这些信息暂未提供。