Menu
代码重构指南和常见重构模式。用于改善代码质量、消除代码坏味道、优化代码结构。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
代码生成统一入口。生成 SQL、CRUD、API、枚举等代码。
基于 Git 提交和代码变更点同步需求/技术文档并补单元测试。用于修复或紧急改动后补文档、对齐代码与文档时使用。
技术方案设计与确认（阶段二）。基于已确认的需求，设计数据库、接口、代码结构，生成技术方案文档。
需求分析与确认（阶段一）。用于理解用户需求、澄清细节、明确功能边界，生成需求分析文档。
处理开发过程中的需求变更。用于开发过程中需求有调整、需要新增/删除/修改功能点、方案确认后发现遗漏。
查看公共类规范和使用方式。包括R响应类、ErrorCode错误码、异常处理、事务、缓存、并发控制、日志等。
| name | proj-refactor |
| description | 代码重构指南和常见重构模式。用于改善代码质量、消除代码坏味道、优化代码结构。 |
Step 0: 校验任务文档 → Step 1: 识别问题 → Step 2: 确定范围 → Step 3: 编写测试 → Step 4: 小步重构 → Step 5: 验证
同步任务文档：
问题： 方法超过 50 行
重构方法： 提取方法
// ✗ 重构前
public void processOrder(Order order) {
// 50+ 行代码...
}
// ✓ 重构后
public void processOrder(Order order) {
validateOrder(order);
calculatePrice(order);
saveOrder(order);
sendNotification(order);
}
问题： 类超过 500 行，职责过多
重构方法： 提取类
// ✗ 重构前
public class UserService {
// 用户管理 + 订单管理 + 支付管理...
}
// ✓ 重构后
public class UserService { /* 用户管理 */ }
public class OrderService { /* 订单管理 */ }
public class PaymentService { /* 支付管理 */ }
问题： 相同代码出现多处
重构方法： 提取公共方法
// ✗ 重构前
public void methodA() {
// 重复代码块
}
public void methodB() {
// 重复代码块
}
// ✓ 重构后
private void commonMethod() {
// 公共代码块
}
public void methodA() {
commonMethod();
}
public void methodB() {
commonMethod();
}
问题： 方法参数超过 4 个
重构方法： 引入参数对象
// ✗ 重构前
public void createUser(String name, String phone, String email,
String address, Integer age, Integer status) {}
// ✓ 重构后
public void createUser(UserCreateRequest request) {}
问题： 硬编码的数字或字符串
重构方法： 提取常量或枚举
// ✗ 重构前
if (status == 1) { }
if (type.equals("VIP")) { }
// ✓ 重构后
if (status == StatusEnum.ENABLE.getCode()) { }
if (type.equals(UserType.VIP)) { }
问题： if/for 嵌套超过 3 层
重构方法： 提前返回、提取方法
// ✗ 重构前
public void process(User user) {
if (user != null) {
if (user.isEnabled()) {
if (user.hasPermission()) {
// 业务逻辑
}
}
}
}
// ✓ 重构后
public void process(User user) {
if (user == null) return;
if (!user.isEnabled()) return;
if (!user.hasPermission()) return;
// 业务逻辑
}
问题： 用注释解释复杂代码
重构方法： 让代码自解释
// ✗ 重构前
// 检查用户是否有效
if (u != null && u.getS() == 1 && u.getD() == 0) { }
// ✓ 重构后
if (user.isValid()) { }
// User 类中
public boolean isValid() {
return this.status == StatusEnum.ENABLE && this.delFlag == 0;
}