Packwerk 包边界守护

问题

Rails 单体应用在业务增长时，服务层、模型、表单对象与任务代码会逐步渗透彼此的领域。短期看似方便，长期却让依赖方向变得模糊：一次无关修改可能触发连锁反应，测试开始变慢，代码审查也难以判断边界是否合理。

技能如何工作

这个技能以 Packwerk 为核心，在项目内部显式定义包（packs），并建立包间可见性与依赖规则。它会：

• 按 Zeitwerk 约定识别类与常量所属的包
• 检查跨包访问是否违反 depends_on、visibility 等约束
• 输出违规列表，帮助团队在重构前定位耦合点
• 指导开发者补充或调整包定义，使边界回到可审查状态

运行前提包括：Ruby 2.7+、启用 Zeitwerk 的 Rails 6+ 应用、已安装 packwerk gem，以及可访问待分析的 monorepo。

适用边界与注意点

Packwerk 依赖 Zeitwerk 的加载约定。通过显式 require 等方式加载的代码往往不符合这些规则，可能不会被完整识别。它更适合作为静态分析与团队规约工具，而不是替代必要的架构重构。若项目尚未划分 packs，需要先建立初步边界，再持续迭代规则。