SuperAPI AI 工具集

code-simplifier

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:Code Simplifier 是一个代码简化专家技能,目标是在不改变代码行为的前提下,提升清晰度、一致性与可维护性。它默认只精炼最近修改的代码,除非被明确要求审查更大范围。

主要能力:围绕可读性与可维护性给出改进建议。命名上要求变量与函数描述其含义或行为(如 remaining_tasks、fetch_active_users),布尔值读作是非问题(is_valid、has_permissions),避免非通用缩写。结构上减少嵌套、使用提前返回与守卫子句,每个函数保持单一抽象层级,避免嵌套三元表达式,清晰优先于简短。降噪方面清理死代码、未使用导入与注释掉的代码块,删除描述显而易见行为的注释,保留解释“为什么”的注释。可维护性上强调小而可测试的单元、清晰的数据流、失败要显式、文件级单一职责、偏好朴素代码。

使用方式:先识别最近修改的代码段,检测语言并加载对应参考文件,分析清晰度与一致性改进点,按影响排序(命名 > 结构复杂度 > 风格细节),应用语言特定最佳实践,确保功能不变,并验证结果更简单可维护。参考文件包括 references/javascript-typescript.md、references/react.md、references/go.md、references/ruby-rails.md、references/additional-languages.md(Java、PHP/Laravel、Python、Svelte 5)。

适用场景:长时间编码会话结束时、合并复杂 PR 前、提交前的简化阶段、代码变得过于复杂时、实现功能后进入代码审查前。

限制:避免过度简化导致清晰度或可维护性下降、过度取巧、把过多关注点合并进单一函数、移除有益抽象、以行数少优先于可读性。需匹配仓库既有模式,不引入仓库未使用的模式。函数长度有参考阈值(Ruby <15 行、JS/TS <20 行、Go <30 行、React 组件 <80 行),超限时仅在可复用或可独立测试时才建议抽取。性能关键代码、待废弃代码、生成代码或第三方依赖、他人正在开发的代码、带解释注释的刻意复杂代码应跳过或标记而非修改。具体安装命令与收费信息暂未提供。