SuperAPI AI 工具集

simplify

编程与开发

查看项目

更新于 10-16 03:28

技能介绍

Simplify 是一个面向代码改动的质量优化技能,核心目标是在不改变代码预期行为的前提下,简化已修改的代码。它不用于查找正确性缺陷,而是专注于清理复用、不必要的复杂度、效率问题和抽象层级。

用途

该技能用于对已改动的代码进行质量提升。调用方式为 /simplify [target]。如果提供了目标,则使用该目标;否则审查当前工作区以及分支相对其基线的差异。工作范围通常限制在改动代码的足迹内,除非仓库中已有的辅助工具是更简单的替代方案。

主要能力

Simplify 从四个角度对改动进行审查:

  • 复用:当使用现有辅助工具、实用函数、类型或已安装依赖更清晰且能保持行为时,用它们替换新引入的重复代码。
  • 简化:移除冗余或可推导的状态、不必要的分支或嵌套、复制粘贴式变体、间接层,以及改动引入或暴露的死代码。
  • 效率:移除已证实的重复工作、不必要的 I/O、内存分配或过于宽泛的操作;不进行推测性的微优化。
  • 抽象层级:将策略、编排和底层机制保持在适当的现有边界内;移除泄漏或直通的抽象,而不是增加新层。

每个审查者只返回带有位置、一行结论、具体成本、证据和最小行为保持修复方案的问题,或者返回“无发现”。审查者不编辑、提交、发布或委托他人。

使用方式

该技能有两种模式:

  • 报告模式:当父工作流或调用方设置仅报告边界时使用。返回已验证的问题和被拒绝的声明及其理由。如果干净则返回“无发现”。并声明目标未被修改。此模式是一个复合审查技能,来源包括顶层 Simplify 审查者和四个角度的审查者。
  • 应用模式:将每个已验证的清理作为最小的连贯编辑应用。运行最窄的相关测试、lint 和类型检查,以及对任何已更改输出表面的直接检查。仅当检查通过且预期行为仍可证明未变时保留编辑。最后简要列出修复、跳过的发现及原因和检查项,或确认代码已经干净。历史记录和发布留给调用方:不提交、变基、评论或推送。

审查流程

首先阅读完整差异、其调用方、相关仓库说明以及建立预期行为的测试或文档。然后为每个角度分配一个全新的、仅报告的审查者。在容量允许时并发运行,仅在需要时串行化;容量永远不会移除某个角度。

随后进行综合:对命名相同机制的问题去重,并对照源代码和预期行为验证每个问题。仅当成本具体、修复方案在范围内且预期行为保持不变时保留该问题。拒绝误报、纯风格改动、推测性灵活性以及需要广泛相邻重构的修复方案。

适用场景

适用于对已改动代码进行质量清理,例如在提交前简化新代码、移除重复逻辑、减少不必要的复杂度或优化已证实的低效操作。不适用于查找正确性缺陷;如果怀疑存在正确性缺陷,应推荐代码审查,而不是将其伪装成清理。

限制

该技能不修改目标(报告模式),不提交、变基、评论或推送代码。它不处理正确性缺陷。它不进行推测性微优化。它不添加新抽象层。它不执行需要广泛相邻重构的修复。