SuperAPI AI 工具集

simplify

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:该技能用于降低代码复杂度,同时严格保持原有行为不变。目标不是减少行数,而是让代码更易读、易理解、易修改和易调试。判断标准是:新成员能否比原代码更快理解它。

适用场景:功能已可运行且测试通过但实现偏重时;代码评审指出可读性或复杂度问题时;遇到深层嵌套逻辑、超长函数或命名不清时;重构赶工写下的代码时;合并相关分散逻辑时;合并后引入重复或不一致时。

不适用:代码已清晰可读;尚未理解代码行为;性能关键且简化版会明显变慢;即将整体重写该模块。

五项原则:一、严格保持行为,输入、输出、副作用、错误行为和边界情况必须完全一致,不确定则不修改;二、遵循项目约定,先阅读 AGENTS.md 与邻近代码风格,保持导入、命名、函数风格、错误处理和类型注解一致;三、清晰优先于技巧,用可读控制流替代嵌套三元,用命名中间步骤替代密集内联转换;四、保持平衡,避免过度简化,不要内联掉有意义的命名、合并无关逻辑、移除有助测试或扩展的抽象,也不要只追求行数;五、限定范围,默认只简化近期修改的代码,不做无关顺手重构。

流程:先理解代码职责、调用关系、边界与错误路径、相关测试及如此编写的原因;再寻找简化机会,如深层嵌套、职责混杂的长函数、嵌套三元、布尔标志参数、重复条件、含糊命名、重复逻辑、死代码和无价值封装;随后逐步修改,每次只做一处简化并验证,尽量将重构与功能开发分开;最后确认代码确实更易理解、差异清晰可评审、符合项目约定、行为与副作用未变。

本仓库指引:优先使用直白的 TypeScript 而非巧妙压缩,保留现有运行时行为、测试和钩子,在提升可读性时偏好显式命名和更小的专注辅助函数,重构范围紧扣任务或评审反馈。结尾验证:对最终差异采用按比例的执行计划,运行仓库与发布说明要求的检查,仅在变更范围或存在不确定时补充或重复证据。

限制:资料未提供具体安装命令、依赖或平台信息,暂未提供。