AEO Architecture：让 AI 给你的代码做架构体检

代码烂得一批？让 AI 先替你「踩一脚」

写代码最怕什么？不是写不出功能，是架构悄悄烂掉——循环依赖悄悄爬进来，layer 违规一层叠一层，等你发现的时候整个代码库已经是一团浆糊。

今天推荐一个专门干这事的 Skill：AEO Architecture。

这玩意儿干的事情很简单：给你的代码做「架构体检」。它能自动检测两类致命问题——

• 循环依赖（Circular Dependencies）：A→B→C→A，死循环。模块无法单独测试，编译顺序全乱。
• Layer 违规（Layer Violations）：Domain 层直接 import 了 Infrastructure，职责边界全破。

它的工作逻辑很清晰：先读取你定义的 aeo-layers.yaml 架构分层配置（presentation / domain / application / infrastructure），然后扫描源码的 import 语句，生成依赖图，检测是否有跨层引用或者循环链条。

比如它抓到问题会直接告诉你：

⚠️ LAYER VIOLATION DETECTED
File: src/components/UserList.tsx:5
Import: import db from ‘../infrastructure/database.js’
正确姿势应该是让 UserList 通过 UserService 拿数据，而不是直接摸数据库。

配置也很简单，在 $PAI_DIR/USER/aeo-layers.yaml 定义各层的路径和允许/禁止的导入关系：

layers:
  - name: "domain"
    path: "src/domain/"
    may_import: []
    may_not_import: ["presentation", "application", "infrastructure"]
  - name: "infrastructure"
    path: "src/infrastructure/"
    may_import: ["domain"]
    may_not_import: ["presentation", "application"]

如果没配置，它退化为只检测循环依赖——开箱即用，不配置也能跑。

最推荐的用法是把它接进 git commit hook 或者 CI pipeline，每次提交前自动跑一次，等于给代码加了架构守护神。循环依赖和分层违规这些问题在代码审查阶段就能抓出来，不用等到上线之后。

支持 Claude Code、Cursor、Copilot、Windsurf、OpenClaw 等主流 AI 编程工具。

一句话总结：AEO Architecture 就是代码的「架构 CT 扫描仪」——帮你在架构腐烂的早期发现它，而不是等它烂到无法收拾。

GitHub 仓库 →

GitHub: https://github.com/ivzc07/aeo-skills/tree/main/skills/aeo-architecture