让 AI 帮你重构代码,保持功能不变的同时提升代码质量
一、这是什么?
code-simplifier 是 Claude Code 官方插件市场提供的一个 Agent 插件,由 Anthropic 官方开发维护。
它的核心能力是:
在保持代码功能完全不变的前提下,简化和优化代码结构,提升可读性、一致性和可维护性。
简单来说,它就像一个经验丰富的代码审查员,专门帮你:
- 消除不必要的复杂度和嵌套
- 删除冗余代码和过度抽象
- 改善变量和函数命名
- 统一代码风格
- 移除描述显而易见逻辑的多余注释
二、怎么使用?
1. 安装插件
在 Claude Code 中执行:
bash
/plugin install code-simplifier
或者通过插件发现界面:
bash
/plugin discover
搜索 code-simplifier 并安装。
2. 调用方式
安装后,你可以通过以下方式使用:
方式一:直接 @mention 调用
css
@code-simplifier 帮我优化这段代码
方式二:在写完代码后让 Claude 自动调用
Claude 在合适的时机可能会自动调用这个 agent 来优化你刚写的代码。
方式三:指定文件范围
bash
@code-simplifier 优化 src/utils/helpers.ts 这个文件
3. 注意事项
- 默认只优化最近修改的代码,除非你明确指定更大的范围
- 使用 Opus 模型执行,保证优化质量
- 所有优化都不会改变代码的功能行为
三、核心提示词解析
以下是 code-simplifier 的完整系统提示词(翻译+注释版):
markdown
你是一位专注于提升代码清晰度、一致性和可维护性的代码简化专家,
同时严格保持代码的原有功能不变。
你的专长在于应用项目特定的最佳实践来简化和改进代码,而不改变其行为。
你优先选择可读性强、显式的代码,而非过度紧凑的解决方案。
## 你的优化原则:
1. **保持功能不变**
- 永远不改变代码做什么,只改变怎么做
- 所有原有特性、输出和行为必须保持不变
2. **应用项目标准**
- 遵循 CLAUDE.md 中建立的编码标准
- 包括:ES modules、import 排序、函数声明方式、类型注解等
3. **增强清晰度**
- 减少不必要的复杂度和嵌套
- 消除冗余代码和抽象
- 改善命名
- 合并相关逻辑
- 移除描述显而易见代码的注释
- **重要:避免嵌套三元运算符**,优先使用 switch 或 if/else
- 选择清晰而非简短 ------ 显式代码通常优于过度紧凑的代码
4. **保持平衡,避免过度简化**
- 不要创建过于"聪明"的难以理解的解决方案
- 不要把太多关注点合并到单个函数或组件
- 不要为了"更少行数"而牺牲可读性
- 不要让代码变得更难调试或扩展
5. **聚焦范围**
- 只优化最近修改或当前会话中涉及的代码
- 除非明确要求审查更大范围
## 优化流程:
1. 识别最近修改的代码段
2. 分析改进优雅性和一致性的机会
3. 应用项目特定的最佳实践
4. 确保所有功能保持不变
5. 验证优化后的代码更简单、更可维护
6. 仅记录影响理解的重要变更
四、我的使用感受与建议
适用场景
| 场景 | 推荐度 |
|---|---|
| 刚写完一段功能代码,想快速优化 | ⭐⭐⭐⭐⭐ |
| 接手他人的"祖传代码"需要重构 | ⭐⭐⭐⭐ |
| PR 前的代码自检 | ⭐⭐⭐⭐⭐ |
| 学习如何写出更好的代码 | ⭐⭐⭐⭐ |
优点
- 安全性高 ------ 严格保持功能不变,不会引入 bug
- 使用 Opus 模型 ------ 优化质量有保障
- 自动聚焦 ------ 默认只处理最近修改的代码,不会乱改
- 风格统一 ------ 会参考项目的 CLAUDE.md 配置
注意事项
- 不要期望它能重构架构 ------ 它只做代码层面的简化,不会改变设计
- 建议配合 Git 使用 ------ 方便对比优化前后的差异
- 适度使用 ------ 过度优化反而可能让代码过于"精简"而难以理解
最佳实践
bash
# 推荐工作流
1. 写完功能代码
2. git add . && git commit -m "feat: 完成xxx功能"
3. @code-simplifier 优化刚才的代码
4. 检查 diff,确认优化合理
5. git commit -m "refactor: 简化xxx代码"
五、总结
code-simplifier 是一个非常实用的代码优化助手,特别适合:
- 追求代码质量的开发者
- 需要维护大量代码的团队
- 想学习代码优化技巧的新手
它的核心理念 ------ 清晰优于简短 ------ 也值得我们在日常编码中借鉴。