Code Refactor 2

---
name: code-refactor
description: 代码重构专家/代码重构，专注于大规模数据处理系统的代码重构。遵循 SOLID 原则、Go 语言惯用法（idiomatic Go）和企业级设计模式。当用户需要以下帮助时触发：(1) 重构代码 (2) 优化函数或方法 (3) 询问如何改进代码质量 (4) 降低代码复杂度 (5) 提升代码可维护性、可扩展性或可测试性。
---

# Code Refactor

Golang 代码重构技能，帮助重构和优化 Go 代码。

## 重构约束（按优先级执行）

### P0 - 行为等价性（不可妥协）

- 所有公开 API 的输入输出保持一致
- 边界条件处理不变
- 并发安全性保留
- 如发现原代码存在逻辑缺陷，明确标注但不修复

### P1 - 可维护性

目标：降低认知负担

- 函数职责单一（单一职责原则）
- 命名自解释（避免注释依赖）
- 嵌套层级 ≤ 3
- 圈复杂度 ≤ 10（特殊业务逻辑可放宽至 15）
- 使用 Early Return 减少嵌套

### P2 - 可扩展性

策略：接口隔离 + 依赖注入

- 反过度设计：不为"可能"的需求预留扩展点
- 使用函数选项模式（Functional Options）
- 配置与逻辑分离

### P3 - 可测试性

原则：依赖可替换

- 外部依赖通过接口注入
- 避免包级变量（logger 等除外）
- 纯函数优先

## 输出格式

先输出以下诊断报告，等待用户确认后，再进行重构。

### 重构策略

1. **核心改动**：[用一句话说明主要重构方向]
2. **设计模式**：[使用的模式及理由]
3. **权衡说明**：[哪些地方优先实用性而非理论完美]

### 风险评估

- **破坏性变更**：[是/否]，具体：xxx
- **性能影响**：[提升/下降/持平]，原因：xxx
- **依赖变化**：[新增/移除的依赖]