SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 10-30 16:21

技能介绍

Code Simplifier 是一个专注于代码质量优化的技能,帮助提升代码的清晰度、一致性和可维护性,而不改变功能行为。

用途

该技能适用于代码审查和重构、提升代码可读性、统一代码风格、简化复杂逻辑、改善代码组织结构等场景。

核心原则

  1. 保持功能不变:仅优化代码质量,不改变业务逻辑,确保重构后行为与原代码一致,建议在重构后运行测试验证。
  2. 应用项目标准:优先遵循项目 CLAUDE.md 中的编码规范,保持与现有代码库风格一致;若项目无明确规范,则使用通用最佳实践。
  3. 增强清晰度:使用有意义的变量名和函数名,减少嵌套层级、使用 guard clauses,消除冗余代码和不必要的复杂性。
  4. 保持平衡:避免过度工程化,不为微小的可读性提升牺牲显著性能,在理想和现实之间取得平衡。
  5. 聚焦范围:仅优化明确指定的代码部分,不主动重构未涉及的代码,支持渐进改进而非一次性大规模重构。

工作流程

步骤 1:理解上下文,阅读项目 CLAUDE.md(如存在)了解编码标准,分析现有代码风格和模式,识别技术栈和框架。 步骤 2:识别优化点,扫描深层嵌套条件语句、复杂三元表达式、模糊变量命名、重复代码逻辑、过长函数或组件、不一致代码风格等问题。 步骤 3:评估影响,对每个潜在优化评估收益(可读性、可维护性提升程度)、风险(引入 bug 的可能性)和成本(改动复杂度和影响范围)。 步骤 4:提出改进方案,说明目标和理由,提供前后代码对比,解释如何符合项目标准,标注潜在影响。 步骤 5:实施优化,按安全改进(如变量重命名)、结构优化(减少嵌套、提取函数)、风格统一的优先级依次实施。 步骤 6:验证结果,确认功能未改变,检查是否符合项目标准,建议运行相关测试。

触发方式

该技能会在用户要求“简化代码”“优化代码”“重构代码”,提到“提升可读性”“改善代码质量”,或请求“代码审查”“代码清理”时自动激活,也可通过 /code-simplifier 命令明确调用。

参考资源

技能包的 references/ 目录提供 CLAUDE.md-example.md(项目编码标准配置示例)、coding-standards.md(通用编码标准参考)、simplification-examples.md(实际代码简化案例集),建议使用前查看。

使用示例

用户请求简化一段多层嵌套的 getUserStatus 函数时,Code Simplifier 会使用 guard clauses 提前返回以减少嵌套,保持功能完全一致,使代码更简洁易读。

限制与说明

注意:这是本地 fallback 版本,安装时会自动尝试从 Anthropic 官方仓库获取最新版本。此技能基于 Anthropic 官方 code-simplifier 插件,遵循其许可协议。上游源为 anthropics/claude-plugins-official,包主页为 @adonis0123/code-simplifier。