代码库架构重构诊断
输入目标代码库或变更热点,自动扫描浅层模块与架构耦合摩擦,生成包含前后对比图的可视化HTML审查报告并协助推演重构方案。
功能与用途
该功能基于软件设计中的“深模块(Deep Module)”理论与项目既有的领域模型,针对代码库近期高频变动区域或指定子系统展开深度扫描。它会识别过度拆分导致的高认知负担、浅层模块、测试接口泄漏以及缺乏局部性的紧耦合代码;随后将发现的重构机会生成一份包含前后结构对比图、局部性与杠杆分析的可视化单文件 HTML 报告;最后引导用户对选定方案展开推演研讨,并自动同步更新领域词汇表与架构决策记录(ADR)。
适用场景
- 高频变更热点治理:通过分析提交历史定位频繁变动的代码热点,扫描过度碎片化的浅层模块,寻找重构收益最高的深化改造机会。
- 低可测试性与高耦合诊断:排查因过度拆分或接口泄漏导致的测试困难与紧耦合模块,生成带前后对比图的可视化HTML报告辅助方案评估。
- 重构推演与架构决策沉淀:选定目标重构方案后展开多维度约束推演,推导深模块接口形态,并同步更新领域模型词汇表与ADR架构决策记录。
适用人群
- 资深软件工程师
- 系统架构师
- 技术负责人(Tech Lead)
- 参与大型单体或多模块重构的开发者
使用步骤
- 指定扫描范围(特定子系统、痛点模块或让系统根据 Git 提交热点自动确定)。
- 后台子代理遍历分析代码结构与接口复杂度,应用删除测试验证模块深度与局部性摩擦。
- 系统在系统临时目录生成自包含 Tailwind 与 Mermaid 图表的 HTML 报告并自动调用默认浏览器打开。
- 在报告中挑选候选重构项,针对其约束条件、测试收益与模块新边界展开推演并同步更新 ADR 与领域模型。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-24
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
依赖与权限
- REPORT
- 读取用户主动提供的内容