SuperAPI AI 工具集

code-simplify

编程与开发

查看项目

更新于 11-06 16:22

技能介绍

用途

code-simplify 用于对最近修改的代码进行简化与精炼(simplify/refine)。它调用 code-simplifier 智能体处理目标代码,在保持功能不变的前提下改善代码的可读性、一致性和可维护性。当用户说出 "code-simplify" 或提出简化代码的需求时使用。

主要能力

  • 调用 code-simplifier 子智能体对指定范围的代码进行精炼。
  • 支持通过可选参数 scope 指定要处理的目录或文件模式。
  • 未指定 scope 时自动检测目标范围:
    • 存在未提交修改时,使用 git diff --name-only 与 git diff --name-only --cached 的结果(staged 与 unstaged 均包含)。
    • 没有未提交修改时,使用最近一次提交的变更文件,即 git diff --name-only HEAD~1...HEAD 的结果。
    • 若检测结果为空,则告知用户没有可精炼的目标文件并结束。

使用方式

  1. 确定目标范围:用户指定 scope 时直接使用该值;否则按上述优先级自动检测。
  2. 通过 Agent 工具调用 code-simplifier 子智能体(subagent_type 为 code-simplifier),在提示中明确包含:目标文件列表、不得改变功能(行为、返回值、API 契约、外部副作用保持不变)、遵循项目编码规范(如 CLAUDE.md)、可读性与清晰性优先于简洁、禁止过度简化(避免嵌套三元表达式、过度压缩的单行代码等)。
  3. 智能体完成后输出变更文件列表及各文件的主要精炼内容摘要。
  4. 向用户简要汇报:变更文件数量与路径、主要改进点(1~2 行),并建议查看 git diff 及运行测试。

适用场景

适用于清理和精炼刚完成或未提交的代码改动,让代码更清晰、更一致、更易维护,同时确保原有功能不受影响。

限制与注意事项

  • code-simplifier 不改变功能,只调整代码结构与表达。
  • 精炼后应运行测试,确认没有引入回归。
  • 关于支持的平台、收费方式、性能效果等,本资料暂未提供。