SuperAPI AI 工具集

simplify-pass

编程与开发

查看项目

更新于 11-14 16:18

技能介绍

Simplify Pass 是一个代码简化技能,仅在用户主动调用时运行(例如使用 /simplify-pass)。其目标是在不改变可观察行为的前提下,提升所选代码的清晰度并去除不必要的复杂度。

用途与范围

该技能使用调用时提供的目标或代码范围。若未提供,则使用当前任务中改动的代码;若仍不明确,则检查已暂存和未暂存的改动以及相关的未跟踪文件。无关改动不纳入范围。若无法确定可识别的目标,应先向用户询问后再继续。

在编辑前,需要阅读受影响的代码、其调用方、项目说明以及最近的现有测试,识别必须保持不变的行为:公共 API、输出、副作用、错误、顺序、并发以及重要边界情况。当聚焦的现有检查能提供有用的基线时,应在编辑前运行它。

独立评审

通过宿主机的委派机制获取三份独立、只读的评估;若配置了评审者路由则使用该路由。在容量允许时并行运行,否则依次运行。每个子任务只能看到自己的简报,因此每份简报需自包含:相同的受限目标、相关项目约束、只读与禁止再委派的限制,以及返回格式。要求提供紧凑的发现,包含文件与行号引用、支持性证据和不确定之处;前两份评估还应提出具体改动建议。简报并不保证子任务在所有宿主机上都是只读的,因此当宿主机提供只读评审者角色或沙箱时应优先使用。

评审关注三个方向:

  • 复用与归属:寻找可替代重复代码的现有本地辅助函数或模式;标记当前没有需求的抽象,并为逻辑建议最简单的归属。
  • 直接简化:寻找冗余状态、分支、嵌套、间接层、注释和不必要的工作;倾向于清晰直接的代码而非更短的代码。
  • 行为契约:梳理可观察行为以及约束重构的测试;报告涉及校验、错误、类型安全、副作用、顺序、时序、安全和公共接口的具体不变量与风险区域。

在编辑前需等待三份评估全部可用。对失败或缺失的评估以相同范围重试一次。若仍有一份不可用,或宿主机无法委派,则报告评审不完整并在编辑前停止。

应用与验证

将每项提议的改动与契约映射和实际代码进行比对。仅应用简化收益具体且行为可被保留的改动。重叠或冲突的提议由主线程自行解决;不确定的提议不予应用。保持主线程只有一个写入者,进行最小化的聚焦编辑。保留有意义的测试和错误处理。不要仅为减少行数而添加抽象或依赖。

运行覆盖受影响行为的聚焦检查,检查最终差异的范围和意外改动,并使用独立的只读评审者对实质性最终差异进行评审。若检查失败或行为保留仍不确定,应修复问题或报告不完整的结果。最后总结哪些部分变得更简单、执行了哪些验证,以及哪些提议被有意保留未应用。

适用场景与限制

该技能适用于在已有测试和明确行为契约的前提下,对选定代码进行保守的简化重构。它要求宿主机支持委派机制以获取三份独立只读评审;若无法满足,则不会进行编辑。它不添加新抽象或依赖来减少行数,也不改变可观察行为。关于收费、价格、平台支持等具体信息,资料中暂未提供。