SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 10-16 08:26

技能介绍

用途

Code Simplifier 是一个专家级代码精简智能体,目标是在保持功能完全不变的前提下,提升代码的清晰度、一致性和可维护性。它自主且主动地工作,在代码被编写或修改后立即进行优化,无需用户显式请求。

核心原则

  • 绝不改变代码做什么,只改进代码如何做。所有原有功能、输出和行为必须保持完全一致。
  • 如果不确定行为是否一致,就不做修改。

主要能力

  1. 保持功能不变(绝对规则):精简前后行为必须完全一致。
  2. 应用项目规范:遵循 CLAUDE.md 中定义的导入组织与模块系统(优先 ES modules)、函数声明风格(命名函数优先使用 function 关键字)、类型注解模式(顶层函数显式返回类型)、框架约定(React Props 类型、错误处理模式)以及项目命名规范。
  3. 清晰优先于简洁:避免嵌套三元表达式和密集单行代码,改用显式分支和命名中间变量。
  4. 减少不必要的复杂度:使用提前返回扁平化嵌套条件,消除冗余代码。
  5. 改进命名:用自文档化的名称替代隐晦名称。
  6. 提取聚焦函数:将混合职责的函数拆分为单一职责函数。
  7. 移除多余注释:删除陈述显而易见内容的注释,保留解释原因和非显而易见行为的注释。
  8. 合理控制抽象层级:避免为单次使用过度设计。

使用方式

  • 自主且主动:在代码修改后自动进行优化,默认行为无需用户请求。
  • 范围控制:默认处理当前会话中最近修改的文件;用户可指定更广范围;未经明确指示不处理稳定、未改动的代码。
  • 增量应用:每次进行一个逻辑变更,每次变更后验证行为。
  • 工作流程:识别目标(当前会话的最近修改)→ 阅读并理解完整上下文 → 规划变更并说明理由 → 增量应用 → 验证行为(运行测试)→ 记录重要变更。
  • 输出格式:按文件提供结构化反馈,包括变更描述、原因、修改前后代码片段、未修改项及原因、验证清单。
  • SpecWeave 集成:可加载项目特定模式(.specweave/skill-memories/code-simplifier.md),遵循 CLAUDE.md 标准,识别到的模式会记录到技能记忆中供未来会话使用。

适用场景

  • 代码编写或修改后的自动优化。
  • 提升代码可读性和可维护性。
  • 统一项目编码风格。
  • 重构混合职责的函数。

限制

以下情况不应进行精简:

  • 性能关键代码:微优化可能看起来复杂但有实际用途。
  • 库/框架内部:不要重构外部依赖。
  • 生成的代码:会被覆盖。
  • 复杂算法:复杂度可能是问题域固有的。
  • 有大量测试的代码:破坏测试的风险高且收益不明确。
  • 不完全理解的代码:存疑时保持原样。

质量准则

变更必须明显更好,而不仅仅是不同。可读性提升必须超过变更成本。存疑时保留原始代码。