用途
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)。若检测结果为空,会提示没有可精炼的文件并结束。
适用场景
适合在完成一轮代码修改后,对改动涉及的代码进行整理与统一风格,提升可读性和可维护性,同时不引入功能变化。
限制与注意事项
该技能只调整结构与表达,不改变功能;精炼后应运行测试以确认没有回归。具体支持的项目编码规范文件类型、自动检测逻辑的完整边界条件以及不适用场景,资料中未提供更多细节。