SuperAPI AI 工具集

develop-clean-architecture

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:把 Clean Architecture(Robert C. Martin)、DDD 战术模式、六边形/显式架构(Herberto Graca)与 Clean Code 实践应用到 TypeScript 代码库,用于设计新模块/限界上下文、审查依赖方向违规、重构耦合系统、实现实体与用例、审计 tsconfig 严格度。不适用于纯框架组件渲染、构建部署任务、一次性脚本或原型。

主要能力与规则:共 76 条规则、11 个分类。硬性护栏包括:外层不得被内层导入(domain 不导入任何层,application 只导入 domain);domain 实体不得带 ORM 装饰器或 Prisma 类型;不用 null 表示领域错误,改用 Result<T, E>;无理由不得用 as any 或 @ts-ignore;领域事件在持久化后派发;跨层类型不复用;应用代码不用 barrel 文件(index.ts 的 export *);不在 domain/用例内校验,改在适配器边界用 Zod 解析;实体使用 # 私有字段;区分 Entity.create() 与 Entity.reconstitute();依赖在单一 composition root(main.ts)中组装;跨层类型导入用 import type;tsconfig 需 strict: true、noUncheckedIndexedAccess、exactOptionalPropertyTypes。

使用方式:先做模式检测(设计/审查/实现/重构),歧义时询问。步骤为分类任务、加载 references/ 下对应参考(主分类加一个相邻分类,如 dep-、entity-、usecase-、code-、ts-、pattern-、bound-、adapt-、frame-、test- 前缀)、执行、验证、交付。验证时优先使用项目原生 typecheck 命令(npm run typecheck、pnpm typecheck、tsc --noEmit -p tsconfig.json),并运行已有测试;无测试需明确说明。

限制与注意:低复杂度任务不建议强行套用完整分层,垂直切片加 Zod 与 Result 类型即可;缺少的收费、平台等信息暂未提供。