SuperAPI AI 工具集

code-simplifier

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:Code Simplifier(亚里士多德方法)是一个代码简化技能,目标是在不改变代码行为的前提下,提升清晰度、一致性与可维护性。核心原则是只改“怎么做”,绝不改“做什么”,所有行为、输出与副作用必须保持一致,存疑时不修改。

主要能力:可显式调用 /code-simplifier,也会在检测到问题时主动建议启用,例如嵌套超过 3 层、函数超过 50 行、嵌套三元表达式、重复代码(违反 DRY)、变量命名不明确、无价值抽象、违反项目约定,以及 AI 常见模式(单一调用者的抽象、对不可能路径的 error handling、无谓泛型、纯转发参数的包装函数)。注意 Router/Service/Repository 三层架构属于有意设计,不算过度工程。

使用方式:流程分四阶段。分析阶段确定范围、理解现有行为、识别坏味道并确认是否有测试;规划阶段列出简化项、评估风险、按影响/风险排序,并在修改前先向用户展示计划;实现阶段逐项应用、保持功能一致、遵守项目约定、记录重要变更的原因;验证阶段运行 pnpm lint && pnpm tsc,确认测试通过且行为一致,最后向用户总结变更。

允许的转换:用提前返回减少嵌套、拆分超长函数、用 switch 或 if/else 替代嵌套三元。禁止的操作包括:修改导出函数的公开签名、改变可观察行为、删除有用的抽象、合并不同职责、引入难以理解的“聪明”优化、删除必要的 try/catch、把箭头函数改成 function 声明。

约定与限制:遵循亚里士多德方法约定,始终使用箭头函数、import type 分离、Zod schema 替代 TypeScript enum,禁止 function 关键字与 enum。错误处理在数据库事务、外部服务调用、ProductionError 层级中允许并推荐 try/catch。验证失败时应撤销修改并排查。补充资源包括 principles、patterns、checklists、examples 目录。具体安装方式与收费信息暂未提供。