| name | refactor |
| description | 当用户觉得代码太乱、想整理代码、优化代码结构但不改功能时使用 — 提升可读性和可维护性 |
代码重构
改善代码质量,但绝不改变现有功能。
核心原则
- 重构前后功能必须完全一致
- 每次只做一种类型的重构,不要混着来
- 有测试的先跑测试确认基线,没测试的先问用户要不要补测试
步骤
1. 确定重构目标
如果用户指定了文件或函数,直接读取。
如果没有指定,问:
你想重构哪段代码?可以告诉我文件名或函数名。
2. 分析问题
读取代码后,识别以下问题(按严重程度排序):
- 重复代码 — 相似的逻辑出现在多个地方
- 过长函数 — 一个函数做了太多事情
- 命名不清 — 变量名或函数名无法表达意图
- 嵌套过深 — 多层 if/for 嵌套,难以阅读
- 职责混乱 — 一个函数/类混合了不同层次的逻辑
3. 提出方案
用中文简洁说明发现了什么问题,以及打算怎么改:
发现以下可以改进的地方:
1. xxx — 建议 xxx
2. xxx — 建议 xxx
询问用户:
要我执行这些重构吗?可以全部做,也可以选择性做。
4. 执行重构
用户确认后,逐个执行重构。每次重构后:
- 确认代码仍然能正常工作(运行测试或 lint)
- 如果某个重构可能有风险,单独提醒用户
5. 对比展示
重构完成后,简要说明改了什么:
重构完成。主要改动:xxx。功能不变,测试全部通过。