AI编码代理擅长局部改写却破坏全局架构边界

dev.to · AI#AI编程#架构守护#Agent

Editor brief · 编辑速览

作者开发了 Archfit 工具来检测 AI Agent 在完成局部任务时绕过了模块公共API、损害系统整体架构的问题，提供了架构守护的工程解法。

文章思维导图

Knowledge map

拖拽缩放

Full translation

完整中文译文

这个变更能保持架构健康吗？archfit 给出答案——用决策，而非数字。

archfit 是一个一键式架构健康度 CLI。它从语言分析器（如 go list、dependency-cruiser、ast-grep、grimp）读取代码的实际依赖关系，与你在 .archfit.yaml 中声明的架构进行比对，然后给出明确的裁决：决策结论、CI 关卡、带状评分卡，以及——当 AI Agent 破坏边界时——结构化的修复任务。

为 AI Agent 和 CI 工作流而生：确定性输出、管道友好的结果，直接告诉你该怎么做。

$ archfit
ARCHFIT RESULT

Decision   ACCEPTABLE WITH WATCH ITEMS
Gate       PASS  ·  0 blocking
Warnings   55 advisory
Score      43 / 100  mixed

Acceptable with watch items. Monitor flagged areas.

No blockers. Use this run for architecture-improvement planning,
not to stop development.

RECOMMENDATIONS

  MUST FIX
    none
  SHOULD FIX
    · bc/imbalanced_coupling — high fan-in into session state
  WATCH