用途:对代码库进行系统化重构机会分析,依据 Martin Fowler《重构:改善既有代码的设计》第2版,产出可执行、按优先级排序的重构报告。
主要能力:先确定分析范围(目录、模块、功能区域或整个项目)并识别语言与范式;探索目录结构、入口点与共享模块;按优先级检测坏味道,包括膨胀类(长函数、大类、长参数列表、数据泥团、基本类型偏执)、变更阻止类(发散式变化、霰弹式修改)、可删除类(重复代码、死代码、臆测性泛化)、耦合类(依恋情结、内部交易、消息链、中间人)、条件复杂度(嵌套条件、重复 switch、缺失卫语句)、DRY 违规等。随后映射推荐重构手法(如 Extract Function、Introduce Parameter Object、Replace Conditional with Polymorphism、Replace with Guard Clauses 等),评估耦合与内聚、DRY 机会,并在领域项目中做 SOLID 分析。
使用方式:按步骤执行,最终按影响、频率、工作量打分,分为 P0 至 P3 优先级,报告保存至 docs/_refacs/<YYYYMMDD>-<slug>.md,并输出执行摘要与建议重构顺序。
限制:目标超过 50 个文件时需缩小范围或确认抽样扫描;无测试覆盖时会警告重构风险;遇到不熟悉的框架或模式会在报告中标注而非猜测;对可能是有意设计的坏味道标记为“潜在”。