为什么 AI 编码代理需要架构编译器（我已经构建了一个）

Source: Dev.to

没人提及的问题

AI 编码代理写代码非常快——太快。经过几次会话后，你会得到：

• 调用特性模块的工具函数
• 将特性逻辑嵌入 CLI 入口点
• 三层深的循环依赖
• 在纯函数内部实例化数据库客户端

没有 linter 能捕捉到这些。没有 formatter 能修复它们。代码库还能运行，但正慢慢变得难以维护，而帮助你的代理没有结构化的反馈来纠正方向。

Atomadic Forge：架构编译器

Atomadic Forge 是一个架构编译器。指向任意 Python 或 JavaScript 仓库，它可以：

1. Scouts – 绘制每个符号、层级、依赖和语言的映射。
2. Wires – 找出所有违反组合律的 import。
3. Certifies – 给出 0‑100 的评分并附带 SHA‑256 收据。
4. Enforces – 自动就地修复违规（安全的 dry‑run）。

它以 MCP 服务器的形式运行，这样你在 Cursor、Claude Code 等工具中的代理就可以直接调用 certify、wire、recon、enforce 以及其他 25+ 工具。

层级结构

a0_qk_constants/     # 零逻辑。纯数据：常量、枚举、TypedDict。
a1_at_functions/       # 纯无状态函数。仅导入 a0。
a2_mo_composites/      # 有状态类、客户端、注册表。导入：a0 + a1。
a3_og_features/        # 由 composites 组装的特性。导入：a0‑a2。
a4_sy_orchestration/   # CLI、入口点、顶层 wiring。导入：a0‑a3。

每个文件只能属于一个层级。层级只能向上组合。

示例用法

forge certify --project ./my-ai-built-app
{
  "score": 47,
  "issues": [
    "a1 imports from a3: utils.py -> feature_pipeline.py (7 occurrences)",
    "circular dependency: auth_client  user_service",
    "a4 contains 340 lines of business logic (belongs in a2/a3)"
  ]
}

forge enforce --apply --source ./src
{
  "score": 91,
  "pre_violations": 34,
  "post_violations": 3,
  "auto_fixed": 31
}

安装

pip install atomadic-forge
forge certify --project .
forge wire --source ./src --suggest-repairs

MCP 配置

{
  "mcpServers": {
    "atomadic-forge": {
      "command": "forge",
      "args": ["mcp", "serve", "--project", "/your/project"],
      "env": { "FORGE_API_KEY": "your-key" },
      "type": "stdio"
    }
  }
}

功能一览

• 944 个测试（单元、集成、MCP 协议、stdio 循环）
• 29 个标准 MCP 工具 / 35 个 Forge Deluxe 工具
• 支持 Python 与 TypeScript/JavaScript
• 在线演示：免费扫描任意公开仓库
• 开源

在评论区留下问题——我会阅读每一条。