improve-codebase-architecture：抢救大泥球

improve-codebase-architecture：抢救大泥球

improve-codebase-architecture 会扫描代码库，找出可以「 deepening（深化）」的模块机会，生成可视化 HTML 报告，再陪你逐个 grill 选定要改造的点。建议每隔几天对你的代码库跑一次。

定期给代码库做体检：找出变「大泥球」的风险点，陪你决定先深化哪一个。

它解决什么问题

AI 加速了写码，也加速了软件熵增——代码库以空前速度变复杂、变难改。很多用代理搭出来的应用最终都成了「大泥球」。

何时使用

• 感觉代码越来越难改、模块边界模糊
• 想周期性地主动投资代码设计，而不是等崩了再救
• 需要一份可视化的架构现状报告来说服团队

核心工作流

关键原则与反模式

• 设计是每天要投资的事，不是等项目烂了才救
• 报告只是起点，真正的决策靠人和代理一起 grill 出来
• 与 codebase-design 的深模块理念同源：用简单接口藏住大量行为

与其他技能的配合

它和 codebase-design 共享「深模块」设计哲学。改造计划落地时，可以接 to-spec / to-tickets / implement，并用 code-review 把关。

相关技能：

• codebase-design：深模块设计
• to-spec：把对话变成规格
• implement：按规格构建
• code-review：双轴代码审查

常见问题

多久跑一次比较合适？

作者建议每隔几天对你的代码库跑一次，把它当成常规的架构体检，而不是救火手段。

它真的会改我的代码吗？

不会直接改。它先出报告，再和你逐个 grill 选定改造点，真正的修改由后续构建流程完成。

返回章节：工程技能完全指南