工程开发
refactoring-patterns avatar

refactoring-patterns

通过 TDD 循环与自动化测试验证,安全地重构代码以提升结构与可维护性,同时确保功能行为不变。

简介

重构模式 (Refactoring Patterns) 技能提供了一套结构化的框架,用于在不改变系统行为的前提下改进现有软件,解决代码异味 (Code Smells)。此技能专为软件工程师、质量工程师与维护者设计,确保技术债的清理工作是有条理、安全且可验证的。它核心原则在于重构必须始终由强大的测试套件支撑,提倡“红-绿-重构”(Red-Green-Refactor) 的工作流程,将代码演进过程中的风险降至最低。

通过使用此技能,用户能将复杂或恶化的代码转变为干净、模块化且高效的实现。它提供识别常见代码异味的指引(如过长的方法、过大的类、嵌套条件式),并将其映射至经过验证的重构技术(如提取方法、提取类、引入参数对象、以 Pipeline 取代循环)。此方法优先采用小规模、渐进式的变更,并确保频繁提交,以确保每次转换都维持测试的完整性。

  • 自动识别与解决代码异味:过长方法、大型类、魔法数字、重复代码。

  • 强制执行“三次法则”(Rule of Three) 以防止过早抽象化与不必要的代码复杂度。

  • 与 QE 代理 (qe-code-reviewer, qe-quality-analyzer, qe-test-refactorer) 整合,针对现有测试套件验证代码变更。

  • 安全优先的生命周期管理:确保测试通过、进行小幅度变更、执行测试、提交进度、循环执行。

  • 提供常见重构模式的最佳实践文档:提取方法、以多态取代条件式、Pipeline 重构。

  • 防范反模式:消除与“大爆炸”式重写、缺乏测试下重构以及完美主义过度工程相关的风险。

  • 当清理遗留系统、减少技术债或在功能开发期间改进代码可维护性时,应使用此技能。

  • 严禁在没有测试的情况下使用此技能;若测试覆盖率不足,用户必须先编写测试。

  • 非常适合搭配 Jest, Vitest, Playwright 或标准 CI/CD 测试执行器使用,以确保高信心的重构。

  • 典型输出包含更干净的代码结构、降低环路复杂度、提升可读性,以及为未来功能开发提供更高的信心水平。

  • 用户应通过定义的内存命名空间 (aqe/refactoring/) 监控重构历史,以追踪模式与建议。

仓库统计

Star 数
329
Fork 数
65
Open Issue 数
4
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年4月29日 07:07
在 GitHub 查看