SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 10-16 04:06

技能介绍

用途

Code Simplifier 是一个代码简化与精炼技能,定位为“代码简化专家”。它的目标是在完整保留原有功能的前提下,提升代码的清晰度、一致性和可维护性。它不会改变代码做什么,只改变代码怎么做,所有原始功能、输出和行为都必须保持不变。

主要能力

该技能围绕以下几个方向对代码进行精炼:

  1. 保留功能:绝不改变代码行为,只调整实现方式。

  2. 应用项目规范:遵循 CLAUDE.md 或项目配置中已确立的约定,包括导入组织与模块模式、命名约定(变量、函数、类型、文件)、代码组织与文件结构、错误处理模式,以及在适用情况下的类型标注。

  3. 增强清晰度:通过减少不必要的复杂度和嵌套、消除冗余代码与抽象、使用清晰且具描述性的名称、合并相关逻辑、删除描述显而易见代码的注释、优先使用显式控制流(if/else、switch)而非嵌套条件、选择清晰而非简短(显式代码优于密集的一行写法)来简化代码结构。

  4. 附加技巧:提前返回/守卫子句(在顶部处理边界情况以减少嵌套)、删除死代码(未使用的变量、函数、导入)、提取常量(用命名常量替换魔法数字/字符串)、单一职责(每个函数只做好一件事)、模式一致(如果代码库以某种方式做 X,就遵循该模式)、合理规模(过长的函数通常意味着需要拆分)。

  5. 保持平衡:避免过度简化,防止降低清晰度或可维护性、制造难以理解的“聪明”解法、把过多关注点合并到单一单元、移除有用的抽象、以行数优先于可读性、让代码更难调试或扩展。

  6. 聚焦范围:除非明确指示审查更大范围,否则只精炼最近修改过的代码。

使用方式

该技能在代码编写或修改后自主运行。其精炼流程为:识别最近修改的代码段;分析清晰度与一致性方面的改进点;应用项目特定规范;确保所有功能不变;验证精炼后的代码更简单且更易维护;仅记录重要变更。

适用场景

适用于在完成代码编写或修改后,希望对最近改动的代码进行清理和规范化,使其符合项目约定并提升可读性与可维护性的场景。

限制

默认只处理最近修改的代码,除非被明确要求扩大审查范围。关于具体的安装命令、收费方式、支持平台等信息,资料中暂未提供。