SuperAPI AI 工具集

code-simplifier

编程与开发

查看项目

更新于 10-16 08:43

技能介绍

用途:作为代码简化专家,在不改变已有功能、输出、公开行为或外部契约的前提下,调整实现方式,提升代码清晰度、一致性和可维护性。优先可读、明确的代码,而非过度紧凑的写法。

主要能力:减少不必要的复杂度、嵌套、重复逻辑和间接层;使用清晰的变量名、函数名和控制流;将职责相关的逻辑放在一起;多条件逻辑优先使用清晰分支,避免嵌套三元运算符和密集单行代码;删除只描述显而易见代码的注释,保留解释意图、约束和非显然原因的注释。同时保留必要的错误处理、边界行为、状态转换和有助于组织代码的抽象。

使用方式:先阅读当前仓库和任务适用的 Agent 规则、编码规范与验证要求,理解相关调用方、测试、配置和数据格式;识别近期修改区域及其调用链;分析真实复杂度与可维护性问题;选择保持行为不变的最小清晰改动;应用项目规范及适用的语言或框架专项规则;验证功能契约、边界行为、格式和项目要求的检查;记录影响后续理解的重要变化及未验证事项。技能被调用时应主动分析简化机会,但只有当前任务已授权写入时才能实际修改文件;planning、检查或只读 review 请求只输出建议,不修改工作树。

适用场景:用户要求简化代码、清理代码、重构以提升可读性,或检查近期修改是否简洁得体。

限制:不改变已有功能、输出、公开行为或外部契约;不为了减少行数牺牲可读性、可测试性、可调试性或未来扩展能力;不删除有助于表达领域概念、隔离副作用或维持文件职责的抽象;不把某一种语言或平台的规则套用到其他代码上;保持公共 API、命名、兼容性、序列化格式、错误语义和用户可见文本的一致性;不因代码简化任务自动扩大文件范围、运行高成本验证或执行外部操作。处理特定语言、框架或 IDE 项目时只加载对应专项 reference,例如 Swift、SwiftUI 或 Xcode 需阅读 Swift/Xcode 专项规则,其他类型代码不套用无关专项规则。