SuperAPI AI 工具集

coding-standard

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:为编写设计良好、简单且可维护的代码提供专家级指导,覆盖面向对象设计、整洁代码原则、经典设计模式与函数级代码实践。核心理念包括“重复优于耦合”、先丑后重构、KISS 优先于 DRY、严格遵循 YAGNI。

主要能力:按规则类别组织,包括 SOLID 五原则(单一职责、开闭、里氏替换、接口隔离、依赖倒置);Clean Code 原则(KISS、YAGNI、DRY、Tell Don't Ask);设计模式(单例、工厂、观察者、策略、装饰器、仓储、依赖注入);函数与代码设计实践(纯函数、不可变性、函数单一职责、早返回、组合优于继承、循环控制流、避免全局变量、类设计、避免副作用、避免 getter/setter、避免模块级副作用、保持函数小、有意义命名、单一抽象层级)。每条规则配有独立规则文件与伪代码示例路径(references/rules 与 references/pseudo-examples)。

使用方式:代理先阅读 SKILL.md 摘要判断适用规则,仅在正在实现某模式、需澄清用法或调试相关代码时,才按需加载对应 references/rules 与伪代码示例,避免预先加载全部引用以节省上下文与 token。

适用与限制:适用于会演进的复杂业务逻辑、需多实现、团队协作需清晰边界、可测试性与长期可维护性优先的场景;简单 CRUD、小于 100 行的小工具、原型或 POC、性能关键且抽象会带来开销的代码不宜过度套用。原则冲突时优先 KISS,DRY 需满足三次法则后再抽象。原文未提供具体安装命令或收费信息,暂未提供。