SuperAPI AI 工具集

software-architecture

设计与创作

查看项目

更新于 10-16 09:28

技能介绍

用途:在用户写代码、设计架构或分析代码时,提供以质量为中心的软件架构指导,核心理念来自整洁架构与领域驱动设计。

主要能力:给出代码风格与架构规则,包括优先使用提前返回以减少嵌套、通过可复用函数和模块消除重复、将超过八十行的组件或函数拆分、超过二百行的文件拆分为多文件、尽量使用箭头函数。强调库优先:写自定义代码前先搜索现有方案,检查 npm 现成库、评估现成服务或 SaaS、考虑第三方 API;仅在特定领域业务逻辑、性能关键路径、外部依赖过重、安全敏感需完全控制、或经充分评估现有方案不满足时,才自写代码。架构上要求领域实体与基础设施分离、业务逻辑独立于框架、明确并隔离用例;命名避免 utils、helpers、common、shared 等泛化名,改用 OrderCalculator、UserAuthenticator 这类领域专名;禁止业务逻辑与 UI 混写、控制器内直接查数据库。反模式包括重复造轮子(如自建认证而非用 Auth0/Supabase)与泛化文件堆积。

使用方式:在用户请求写代码、设计架构或分析代码时调用该技能;示例调用为在任务中使用 @software-architecture。

适用场景:需要保持一致代码质量与清晰边界的开发任务。

限制:仅当任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。