SuperAPI AI 工具集

code-simplification

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:对当前候选差异(recently changed code)做聚焦简化,让意图更清晰。它不负责选取工单、扩展范围、验收评审、产出 QA/审计材料、提交代码、推送或创建 PR,也不最终确定流程状态。

输入要求:需要改动差异、允许修改的路径、语义不变量、项目约定,以及当前已通过的检查。若候选状态不是 GREEN,则不做编辑直接返回。

主要能力与做法:

  • 在上下文中阅读改动代码,识别具体重复、不必要的间接层、令人困惑的命名、可局部避免的分支。
  • 优先采用能令意图明显的最小改动;不引入猜测性抽象、大规模格式化改动、兼容性垫片或架构级重写。
  • 每次连贯编辑后运行最相关的狭窄检查;若无法证明行为等价,则回退该简化。
  • 返回改动路径、所做简化、观察到的检查结果和残余限制。

必须保留:外部可观察行为与公开契约;错误、校验顺序、副作用、重试与持久化语义;安全与数据完整性边界;工单范围与无关用户改动;测试与项目约定。

容量边界(易变输入上限):每次调用 max_volatile_bytes 为 103232 个规范化 UTF-8 字节;max_single_output_bytes 为 32596。所有差异、文件切片、粘贴交接、证据正文与工具结果在 CRLF 或孤立 CR 统一为 LF 后计数。先读清单,命令输出在进入上下文前截断,较大差异按文件或 hunk 切片。优先使用路径加 SHA-256 引用而非粘贴产物,仅在内容确有必要时计数。若下一次必需读取将超出任一上限,应在读取或编辑前停止,返回确切的剩余引用并标记 budget-exhausted,后续调用可继续。该上限不允许省略保留职责,或未经证据声称等价。

限制:不做验收评审或审计产出,不提交、不推送、不开 PR,不扩展范围。任何编辑都会产生新的 CandidateRef,并使调用方此前的评审/QA/审计证据失效。不得在无观察证据的情况下声称等价或检查通过。