从深度代码结构分析与DDD模式识别、技术债务评估与架构反模式检测、SOLID/整洁代码/整洁架构原则指导、经典重构模式与遗留代码改造技术,到系统架构与模块化设计、不改变行为的代码简化重构执行的完整代码重构工作流。支持复杂度分析、依赖关系可视化、设计模式应用和渐进式重构策略。
概述
你现在要完成一次全面的代码重构任务。你已安装以下 Skill,请按步骤串联使用:
步骤 1:深度代码结构分析(获取层)
使用 Code Analyzer 完成:
- 对目标代码进行深度结构分析,识别类/函数/模块的职责分布
- 运用 DDD(领域驱动设计)模式识别领域边界和聚合根
- 分析代码复杂度(圈复杂度、认知复杂度)
- 绘制依赖关系图,标记高耦合区域
- 识别重复代码段和相似逻辑片段
输出代码结构分析报告和复杂度热力图。
步骤 2:技术债务与架构反模式检测(获取层)
使用 Agent Git Oracle 完成:
- 分析 Git 历史,识别频繁修改的热点文件
- 检测技术债务累积区域(高变更频率 + 高复杂度)
- 识别架构反模式(循环依赖、上帝类、过度耦合)
- 评估代码腐化程度和重构优先级
- 标记风险最高的模块和函数
输出技术债务评估报告和重构优先级排序。
步骤 3:整洁代码与 SOLID 原则评审(分析层)
使用 Uncle Bob 完成:
- 基于 SOLID 原则(单一职责、开闭、里氏替换、接口隔离、依赖倒置)逐项评审
- 按整洁代码(Clean Code)标准审查命名、函数长度、注释质量
- 运用整洁架构(Clean Architecture)评估分层是否合理
- 识别违反设计原则的具体代码位置
- 给出符合原则的重构方向建议
输出 SOLID 合规报告和原则性重构建议。
步骤 4:重构模式与技术选型(分析层)
使用 Code Refactoring 完成:
- 针对步骤 2-3 识别的问题,匹配经典重构模式(Extract Method、Move Field、Replace Conditional with Polymorphism 等)
- 制定遗留代码改造策略(Strangler Fig、Branch by Abstraction)
- 设计渐进式重构路径,确保每步可独立验证
- 评估重构风险和回归测试需求
- 生成重构操作清单(按优先级排序)
输出重构模式匹配表和分步操作计划。
步骤 5:系统架构与模块化设计(输出层)
使用 System Architect 完成:
- 基于重构目标设计新的模块化架构
- 定义清晰的模块边界、接口契约和依赖方向
- 规划组件拆分策略和通信机制
- 设计面向扩展的架构(插件化、微服务化等)
- 输出架构图(模块关系图、分层图、数据流图)
输出目标架构设计文档和模块拆分方案。
步骤 6:代码简化与重构执行(输出层)
使用 Simplify 完成:
- 在不改变外部行为的前提下简化代码实现
- 消除冗余逻辑、合并重复代码、简化条件表达式
- 优化函数签名和参数传递
- 提升代码可读性和可维护性
- 验证重构后代码的功能等价性
输出简化后的代码和变更说明。
最终输出
将以上步骤的结果整合为完整的代码重构包,交付以下文件:
- 代码结构分析报告:复杂度热力图、依赖关系图、重复代码清单
- 技术债务评估报告:债务分布、风险等级、重构优先级排序
- SOLID 合规报告:原则违反清单和修正方向
- 重构操作计划:分步重构清单、模式匹配、风险评估
- 目标架构设计:模块化架构图、接口契约、迁移路径
- 重构后代码:简化优化后的代码实现和变更日志
技能模块
这个专家包由 6 个技能串联而成,按下面的顺序依次调用即可跑通整套工作流。点击卡片可看单个技能的完整说明。
Code Analyzer
深度代码分析工具。分析代码架构、执行流程、数据流、业务规则、外部依赖、数据模型,支持 DDD 模式识别(聚合根、实体、值对象、领域服务、仓储、领域事件、限界上下文)。使用场景:新代码库熟悉、架…
Agent Git Oracle
高级仓库分析与重构指南。基于AI推理识别技术债务与架构反模式。
Uncle Bob
应用 Robert C. Martin (Uncle Bob) 的整洁代码原则、SOLID 设计原则和整洁架构。适用场景:(1) 评审或重构代码以提升质量,
Code Refactoring
代码重构模式与技术,在不改变行为的前提下提升代码质量,适用于清理遗留代码、降低复杂度或改善可维护性。
System Architect
充当高级系统架构师,设计健壮、可扩展且易于维护的软件架构。遵循行业标准(Python 的 PEP 8、JS/TS 的 ESLint),采用模块化设计并落实安全最佳实践。适用于用户想启动新项目、…
simplify
Simplify and refine recently modified code for clarity, consistency, reuse, and maintainability …
下载 Zip 包
解压到你的项目目录即可使用,包内结构与 SkillHub 原包一致:manifest.json + skillsets/ + skills/。
https://www.zhengdianxue.com/wp-content/uploads/skillpackage/tech-code-refactoring.zip将提示词发送给你的 AI 安装该专家包
把下面这段提示词复制给你的 AI 助手(WorkBuddy、Claude Code、Codex 等均可),它会按 SkillHub 官方安装说明把整套专家包装好。
请根据 https://skillhub.cn/install/skillhub-pack-install.md,安装 tech-code-refactoring。