SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 11-12 06:46

技能介绍

code-simplifier 是一个代码简化技能,定位为“代码简化专家”,在保留原有功能与行为完全不变的前提下,改进代码的清晰度、一致性和可维护性。它偏向可读、显式的写法,而不是过度紧凑的技巧性代码。

用途 用于在开发过程中对代码做“清理与精炼”,典型触发场景包括被要求“简化代码(simplify code)”“清理代码(clean up)”等。它不改变代码做什么,只调整代码怎么写。

主要能力

  1. 保持功能不变:不改动原有特性、输出与行为,只调整实现方式。
  2. 应用项目规范:依据 CLAUDE.md 中的既有编码标准改写,包括使用 ES 模块并正确排序导入与扩展名、优先使用 function 关键字而非箭头函数、为顶层函数添加显式返回类型注解、遵循 React 组件模式并显式声明 Props 类型、采用合适的错误处理方式(尽可能避免 try/catch)、保持一致的命名约定。
  3. 提升清晰度:降低不必要的复杂度与嵌套层级;删除冗余代码与抽象;通过清晰的变量名和函数名提升可读性;合并相关逻辑;删除描述显而易见代码的多余注释;避免嵌套三元运算符,多条件时优先使用 switch 或 if/else 链;在简洁与清晰之间选择清晰。
  4. 保持平衡:避免过度简化导致可读性或可维护性下降,避免产生难以理解的“聪明”写法,避免把过多关注点合并进单个函数或组件,避免删除有助于组织代码的抽象,避免为追求行数少而牺牲可读性(如嵌套三元、密集单行)。
  5. 控制范围:默认只精炼当前会话中最近修改或触碰过的代码,除非被明确要求审查更大范围。

使用方式 按以下流程执行:识别最近修改的代码段;分析可提升优雅度与一致性的机会;应用项目专属最佳实践与编码标准;确保所有功能保持不变;验证改写后的代码更简单、更易维护;仅记录影响理解的重要变更。资料中未提供安装命令、调用接口或具体命令示例。

示例(资料原文) 嵌套三元改为清晰分支: const status = isLoading ? 'loading' : hasError ? 'error' : isComplete ? 'complete' : 'idle'; 改为: function getStatus(isLoading: boolean, hasError: boolean, isComplete: boolean): string { if (isLoading) return 'loading'; if (hasError) return 'error'; if (isComplete) return 'complete'; return 'idle'; } 过度紧凑改为分步: const result = arr.filter(x => x > 0).map(x => x * 2).reduce((a, b) => a + b, 0); 改为: const positiveNumbers = arr.filter(x => x > 0); const doubled = positiveNumbers.map(x => x * 2); const sum = doubled.reduce((a, b) => a + b, 0); 冗余抽象改为直接判断: function isNotEmpty(arr: unknown[]): boolean { return arr.length > 0; } if (isNotEmpty(items)) { ... } 改为: if (items.length > 0) { ... }

适用场景 适用于已有代码的重构清理环节,尤其是代码审查后、提交前的整理,或需要在团队统一规范下改写近期改动代码时。适合 JavaScript/TypeScript 与 React 项目,也适合需要按项目约定风格统一代码风格的场景。

限制 资料未提供支持的编程语言范围、运行环境、平台集成方式、收费标准与价格信息,暂未提供。其规范示例基于 CLAUDE.md 与 ES 模块、React 等前端技术栈,其他语言或框架下的具体规范资料中未说明。默认作用范围限于近期修改的代码,不主动做全局重构。