SuperAPI AI 工具集

clean-arch

编程与开发

查看项目

更新于 10-16 09:53

技能介绍

用途:在 Nuxt/TypeScript 全栈仓库中做架构审计与重构建议。触发场景包括架构评审、依赖检查、重构或改进代码结构。

主要能力:先加载同目录下的 clean-architecture-reference.md,再以 Explore 子代理深度扫描仓库,覆盖目录结构、服务端与客户端分层、依赖流向、类型共享、功能边界、超 500 行的混合职责文件、死代码、循环依赖、外部 API 访问方式与错误处理一致性,并将每个问题映射到具体的 Clean Architecture 原则。若架构健康则如实给出健康报告,不虚构问题;若发现问题则先汇总,再让用户选择范围。

四种范围:Cleanup 只做低风险清理(死代码、重复实现、命名与模式统一、重复类型、未用依赖),不改架构;Medium 移动逻辑到正确层、拆分 god 文件、统一错误处理、合并重叠状态、为直连外部 API 补抽象;Major 引入用例封装、基于接口的适配器、Screaming Architecture 目录重组、明确边界与依赖反转、Main 组件装配;Drastic 评估技术栈替换与并行重写,采用绞杀者模式增量迁移,仅在栈存在根本性约束时推荐。报告含执行摘要、逐条发现(违反原则、位置、问题、修复、风险、工作量)、依赖 ASCII 图与优先级顺序。

使用方式:在仓库中调用该技能,按提示选择范围;仅资料提供的流程,具体安装或命令暂未提供。

限制:每项发现须引用具体原则与文件路径;修复须给具体代码;尊重所选范围;显式标注破坏性变更;避免过度抽象(同类实例 3 个以上才建议抽象);兼顾框架惯例(如自动导入、基于文件路由)。其他收费、平台与命令信息暂未提供。