SuperAPI AI 工具集

hello-arch

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:在重构代码、调整模块结构、管理依赖、拆分文件、提取组件、设计系统架构或做代码组织决策时使用,为架构相关变更提供统一规范。

主要能力与规范:编码前先画出当前到目标的依赖关系和变更路径,再写代码。遵循 SOLID 原则:单一职责(一个模块或类只做一件事,变更只有一个原因)、开闭原则(新功能通过扩展实现)、依赖倒置(高层与低层都依赖抽象接口或协议)。边界与分层方面,要求清晰的模块边界并通过接口通信,依赖方向为外层到内层(UI 到 Service 到 Repository),循环依赖视为架构问题必须解决,配置与代码分离并用环境变量管理。代码组织上按功能分组而非按类型分组,文件或类预警 300 行、强制拆分 400 行,函数预警 40 行、强制拆分 60 行,例外包括生成代码、大型测试夹具、迁移脚本、协议常量表;公共逻辑提取到 shared/,但避免过早抽象,三次重复才提取。变更策略要求评估影响范围,大重构分步进行且每步可独立验证和回滚,并区分真实外部契约与内部实现惯性。

交付检查:无循环依赖;文件或类不超过 400 行、函数不超过 60 行(例外类型除外);依赖方向正确;变更范围可控;技术方案符合 HelloAGENTS 技术选型原则。

限制:资料未提供具体安装命令、平台支持、收费方式或使用步骤,暂未提供相关信息。