用途:把 Clean Architecture(Robert C. Martin)、DDD 战术模式、Hexagonal/Explicit Architecture(Herberto Graca)和 Clean Code 实践应用到 TypeScript 代码库,也可用于审计既有结构的架构违规。资料称包含 11 个类别、76 条规则。
主要能力与硬性约束:依赖只能向内,domain 不导入任何外层,application 只导入 domain;领域实体不得带 ORM 装饰器或 Prisma 类型,需在 infrastructure 用 mapper;领域错误不得返回 null,需用判别联合 Result<T,E>;禁止无注释的 as any 或 @ts-ignore;领域事件必须在 save() 之后拉取、commit 之后派发;跨 domain/API/DB 层不复用同一类型,接受重复;application 代码禁止 barrel index.ts,改用直接导入;不得在 domain 或用例内做校验,应在适配器边界用 Zod 解析;实体字段用 # 私有字段而非 private 关键字;区分 Entity.create()(校验并发事件)与 Entity.reconstitute()(从数据库加载、不发事件);依赖统一在 main.ts 组合根装配;跨层类型导入用 import type,并开启 verbatimModuleSyntax: true;tsconfig 需 strict: true、noUncheckedIndexedAccess、exactOptionalPropertyTypes。
使用方式:先判定模式——设计、评审、实现、重构,无法判断时先向用户澄清。再按任务主类别与一个相邻类别加载 references/ 下的参考文件,例如 dep-、entity-、usecase-、code-、ts-、pattern-、bound-、adapt-、frame-、test- 前缀规则,以及 decision-tables。若涉及既有代码,还需读取项目 tsconfig.json 与分层结构,并参考已有的 AGENTS.md 或架构文档。完成后运行项目原生的类型检查命令(如 npm run typecheck、pnpm typecheck、tsc --noEmit -p tsconfig.json),配置了测试则运行 npm test/pnpm test,否则明确说明改用构建与类型检查。
适用场景:新模块、服务或有界上下文设计;架构或依赖方向违规审查;将耦合系统重构为更清晰分层;实现实体、值对象、聚合、领域事件;审计 tsconfig 严格度、命名或函数设计;在分层架构与垂直切片之间选型。
限制:不用于纯 React/Vue/Angular 组件渲染、仅构建工具或 CI/CD 部署、无长期维护价值的一次性脚本或原型。低复杂度 CRUD 不应套用完整整洁架构,垂直切片加 Zod 与 Result 类型即足够;资料中未提供该技能的收费、价格与安装命令信息。