SuperAPI AI 工具集

skill-clean-architecture

设计与创作

查看项目

更新于 10-16 06:23

技能介绍

用途:在任意代码库中执行 Clean Architecture 与领域驱动设计原则。调用后可识别当前软件架构(或缺失情况),检测分层违规与反模式,并在不改变原有架构的前提下给出改进建议,或按项目规模与复杂度推荐更合适的架构。该技能强调仅采用必要的四层模型(Domain、Application、Infrastructure、Interface),不做过度工程。触发词包括 clean architecture、DDD、analyze architecture、layer violations、dependency rule、refactor architecture、identify architecture、recommend architecture、architecture audit。

主要能力:按模式(identify 识别当前架构、recommend 推荐架构、enforce 应用 Clean Architecture 模式)输出结果,包括架构识别块(架构名、置信度、发现的信号、违规项)、架构推荐块(推荐架构、理由、迁移路径、应避免项)、改进路线图(按风险/影响矩阵排序,优先低风险高影响)以及代码示例(文件头模板、层结构、违规修复片段)。工作流程为先采集信号、按信号数量判定置信度(3 个以上为高、1-2 个为中、0 个或来自 3 种以上架构为低),再检测跨层违规(如 Domain 导入 Infrastructure 或框架、Controller 直连仓库、用例含 SQL/ORM 调用、业务逻辑写在 HTTP 处理器中、循环引用、实体被 ORM 装饰器标记等),最后输出固定格式的识别结果;若置信度低则自动进入架构推荐。

使用方式:需要访问项目源码,需确认项目源代码目录(根路径或 src/);框架/语言自动检测(依据 package.json、文件扩展名、配置文件);模式为可选参数。分析时优先在 src/、app/、lib/、codebase/、packages/、src/main/、src/app/ 查找源码,若无标准目录则查找根目录下 .ts、.js、.py、.java 文件,或依据 package.json 的 main 入口与导入链追溯主源码目录。可选推荐基于项目特征(规模、团队、领域复杂度、流量、框架、异步/事件、多上下文)套用决策矩阵。层文档规则为强制:每个文件必须以其所属层注释开头,可用标签为 Domain、Application、Infrastructure、Interface。

适用场景:需要审查代码库架构、检测分层违规、为项目选择架构、规划渐进式重构路径的团队。限制:不适用于过小项目——少于约 10 个源码文件或纯 CRUD 且无业务规则的场景不建议 Clean Architecture、DDD 或微服务;检测到循环依赖会标记为严重违规且不会静默修复;出现多个有效架构时会报告全部候选并要求用户确认上下文;未找到源码文件时要求用户确认路径。资料未提供具体收费、价格与平台信息。