SuperAPI AI 工具集

code-simplify

编程与开发

查看项目

更新于 11-06 16:21

技能介绍

用途

code-simplify 是一个代码精炼技能,用于对最近修改过的代码进行简化和整理。它的目标不是改变功能,而是在保持行为一致的前提下,改善代码的可读性、一致性和可维护性。

主要能力

  • 自动识别精炼范围:支持通过参数指定目录或文件模式;未指定时按优先级检测未提交的修改(staged 与 unstaged),若没有未提交修改则取最近一次提交的变更文件。
  • 按项目规范精炼:在分析目标文件后,遵循项目既有编码标准(如 CLAUDE.md)。
  • 可读性优先:强调清晰与可读,而非单纯缩短代码长度,避免嵌套三元运算符或过度压缩的一行代码。
  • 保持功能不变:不改变程序行为、返回值、API 约定与外部副作用。
  • 结果汇报:列出变更文件路径,概述主要精炼内容,并建议查看 git diff 与运行测试。

使用方式

调用时可选传入 scope 参数,用于指定要精炼的目录或文件模式。若省略,技能会自动检测目标文件:优先处理未提交的修改(git diff --name-only 与 git diff --name-only --cached 的结果),没有未提交修改时则使用最近一次提交的变更文件(git diff --name-only HEAD~1...HEAD)。若检测结果为空,会提示没有可精炼的文件并结束。

适用场景

适合在完成一轮代码修改后,对改动涉及的代码进行整理与统一风格,提升可读性和可维护性,同时不引入功能变化。

限制与注意事项

该技能只调整结构与表达,不改变功能;精炼后应运行测试以确认没有回归。具体支持的项目编码规范文件类型、自动检测逻辑的完整边界条件以及不适用场景,资料中未提供更多细节。