面试官：你管这叫AI编程？

.trae/
├── README.md                          # 本文档（综合规范介绍）
├── hooks.json                         # 钩子配置（提交前提醒）
│
├── rules/                             # 规则文件（每次对话自动加载）
│   ├── project_rules.md               #   项目总则（技术栈、编码规则、文档约定）
│   ├── handler.md                     #   Handler 层规则（api/handler/）
│   ├── service.md                     #   Service 层规则（internal/service/）
│   ├── repository.md                  #   Repository 层规则（internal/repository/）
│   ├── domain.md                      #   Domain 层规则（internal/ragplatform/domain/）
│   ├── milvus.md                      #   Milvus 检索核心规则（internal/milvus/）
│   ├── rag.md                         #   RAG 编排层规则（internal/rag/）
│   └── frontend.md                    #   前端规则（admin/src/）
│
├── skills/                            # 技能（开发者手动调用）
│   ├── gen-plan/                      #   生成标准化开发计划
│   │   ├── SKILL.md                   #     技能定义和执行流程
│   │   ├── template.md                #     计划文档模板
│   │   └── examples/
│   │       └── example-feature.md     #     完整示例
│   └── layer-check/                   #   分层依赖校验
│       ├── SKILL.md                   #     技能定义和执行流程
│       └── layer_rules.json           #     分层规则配置（层级映射、允许/禁止依赖）
│
└── agents/                            # 子代理（SOLO Agent 自动调用）
    ├── plan-review.md                 #   文档计划审核子代理
    └── test-compliance.md             #   测试及合规检测子代理

                    ┌──────────┐
                    │   cmd    │  程序入口（装配点，可依赖所有内部包）
                    └────┬─────┘
                         │
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
    ┌──────────┐  ┌───────────┐  ┌───────────┐
    │ router   │  │ ragrouter │  │  handler  │  HTTP 路由层
    └────┬─────┘  └─────┬─────┘  └─────┬─────┘
          │              │              │
          │              │         ┌────┴─────┐
          │              │         ▼          ▼
          │              │    ┌────────┐ ┌─────────┐
          │              │    │response│ │middleware│
          │              │    └────────┘ └────┬────┘
          │              │                    │
          │              │              ┌─────┴─────┐
          │              │              │   auth    │
          │              │              └─────┬─────┘
          │              │                    │
          │              ▼                    │
          │         ┌──────────┐              │
          └────────►│ service  │◄─────────────┘
                    └────┬─────┘
                         │
          ┌──────────────┼──────────────┐
          ▼              ▼              ▼
    ┌──────────┐  ┌───────────┐  ┌───────────┐
    │repository│  │   model   │  │   rag     │  业务/数据层
    └────┬─────┘  └───────────┘  └─────┬─────┘
         │                             │
         ▼                             ▼
    ┌──────────┐                 ┌───────────┐
    │  model   │                 │  milvus   │  核心/基础层
    └──────────┘                 └───────────┘

{
  "layers": { ... },        // 文件路径 → 层级映射（29 个层）
  "allowed": { ... },       // 允许依赖（12 个核心层配置，其余走 needs-review）
  "forbidden_cross": { ... }, // 禁止依赖（4 条核心 BLOCK 规则）
  "ignore": [ ... ]         // 忽略的文件（测试文件、vendor 等）
}

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "prompt",
            "prompt": "项目使用 Go(Hertz) + Next.js 双栈。修改后端代码前确认遵守 .trae/rules/handler.md 等分层规则；修改前端前确认遵守 .trae/rules/frontend.md。新代码必须配套测试，注释用中文。"
          }
        ]
      }
    ]
  }
}

1. 开发者口述需求
   "实现知识库告警列表的分页查询接口，支持按状态、严重度筛选"

2. 生成计划（skill）
   /gen-plan
   → AI 按模板生成开发计划，包含分层落点、接口契约、测试要求、验收清单
   → 文档保存到 Docs/

3. 审核计划（subagent，自动触发）
   → SOLO Agent 自动调用 plan-review
   → 技术可行性分析、风险识别、测试方案补全
   → 输出审核报告

4. 管理员评审
   → 人工确认审核报告，通过后进入开发

5. 代码编写
   → AI 按 handler.md / service.md / repository.md 规则编写代码
   → rules/ 中的规则全程自动生效

6. 分层校验（skill）
   /layer-check
   → 扫描 diff 文件的 import
   → 检查是否违反 forbidden_cross
   → BLOCK 违规必须修复

7. 测试合规（subagent，自动触发）
   → SOLO Agent 自动调用 test-compliance
   → 编译检查 → 执行测试 → 合规检测 → 自动修复
   → 输出综合报告

8. 提交 MR
   → 全部通过后提交代码