SuperAPI AI 工具集

simplify

编程与开发

查看项目

更新于 10-24 16:20

技能介绍

用途

simplify 用于在重构、简化或清理现有代码实现时提升代码质量。它明确不负责查找正确性缺陷,那属于 /code-review 的职责范围。它的目标是审查变更代码在复用、简化、效率和实现层次方面的问题,并修复发现的问题。

主要能力

该技能通过四个并行的清理代理从不同角度审查代码变更:

  • 复用(Reuse):标记重新实现了代码库已有功能的新代码,通过 Grep 搜索共享/工具模块和变更附近的文件,并指出应改用的现有辅助函数。
  • 简化(Simplification):标记 diff 引入的不必要复杂度,包括冗余或可推导的状态、略有差异的复制粘贴、深层嵌套、遗留的死代码,并给出完成相同工作的更简单形式。
  • 效率(Efficiency):标记 diff 引入的浪费性工作,包括冗余计算或重复 I/O、顺序执行的独立操作、添加到启动或热路径的阻塞工作,并给出更经济的替代方案。
  • 实现层次(Altitude):检查每处变更是否在正确的深度实现,而非脆弱的补丁。在共享基础设施上叠加特例通常意味着修复不够深入,应优先泛化底层机制而非添加特例。

每个代理返回的发现包含文件、行号、一行摘要以及具体成本(重复、浪费或更难维护的内容)。

使用方式

调用方式为 /simplify。执行流程分为三个阶段:

阶段 0 — 收集 diff:运行 git diff @{upstream}...HEAD(若无 upstream,则用 git diff main...HEAD 或 git diff HEAD~1)获取待审查的统一 diff。如果有未提交的更改,或范围 diff 为空,还会运行 git diff HEAD 并将工作区更改纳入范围——审查常在提交前运行。如果传入了 PR 编号、分支名或文件路径作为参数,则改为审查该目标。将此 diff 视为审查范围。

阶段 1 — 审查(4 个清理代理并行):通过 Agent 工具在单条消息中启动 4 个独立审查代理,使其并发运行。将 diff 和上述四个角度之一分别传给每个代理。

阶段 2 — 应用修复:等待四个代理全部完成,对指向同一行或同一机制的发现去重,然后直接修复每个剩余问题。跳过任何修复会改变预期行为、需要改动审查 diff 之外的内容、或判断为误报的发现——记录跳过而非争辩。最后简要总结修复了什么、跳过了什么(或确认代码本就干净)。

适用场景

适用于在提交代码前对变更进行清理,或对已有实现进行重构、简化和整理。

限制

该技能不查找正确性缺陷。对于修复会改变预期行为、需要改动审查 diff 之外的内容、或属于误报的发现,会被跳过。