Trae Rules 进阶：5个实用模板+高级技巧

Trae Rules 进阶：5个实用模板+高级技巧

适合人群：Trae 用户、想让 AI 更懂你项目的开发者、团队技术负责人

01 为什么你的 Trae 总是"不听话"？

你有没有遇到过这种情况：

每次让 Trae 写代码，它总是用你不喜欢的命名规范；让它生成接口，它总是漏掉错误处理；让它写文档，它总是用英文……

问题不在 Trae，在你没有配置 Rules。

Rules 是什么？

打个比方——Rules 就像是给新员工的入职手册。新员工刚来，不知道团队规范，你得告诉他：

• 代码用驼峰命名
• 每个函数必须有注释
• 错误处理用 try-catch
• ……

Rules 也一样。你把团队规范写进去，Trae 就会自动遵循，不用每次都在 Prompt 里重复。

三种 Rules 类型：

02 快速上手：创建你的第一个 Rule

步骤 1：打开 Rules 配置

步骤 2：编写规则

个人规则示例（适合所有人）：

# 基本要求
– 使用中文回复
– 代码注释用中文
– 优先使用 const，其次 let，禁止 var
– 每个函数必须有 JSDoc 注释
– 错误处理必须用 try-catch

# 代码风格
– 使用驼峰命名法
– 字符串优先使用单引号
– 语句末尾不加分号（除非必要）

项目规则示例（适合特定项目）：

# 技术栈
– Vue 3 + TypeScript + Vite
– UI 框架：Element Plus
– 状态管理：Pinia
– 请求库：Axios

# 代码规范
– 组件文件使用 PascalCase 命名
– 工具函数使用 camelCase 命名
– 常量使用 UPPER_SNAKE_CASE 命名

# 目录结构
– src/components/ — 公共组件
– src/views/ — 页面组件
– src/utils/ — 工具函数
– src/api/ — 接口定义

步骤 3：保存并测试

保存规则后，直接在对话框中测试：

帮我写一个用户登录组件

你会发现，Trae 生成的代码自动遵循了你的规则！

03 实战场景：5 个实用规则模板

场景 1：Vue 3 项目规则

适用场景：Vue 3 + TypeScript + Element Plus 项目

# Vue 3 项目规范

## 技术栈
– Vue 3.3+ (Composition API)
– TypeScript 5.0+
– Vite 5.0+
– Element Plus
– Pinia (状态管理)
– Vue Router 4

## 代码规范
– 使用 `<script setup>` 语法
– 组件文件使用 PascalCase 命名（如 UserProfile.vue）
– 工具函数使用 camelCase 命名
– 常量使用 UPPER_SNAKE_CASE 命名

## 组件规范
– 每个组件必须有 `<template>`、`<script setup>`、`<style scoped>`
– Props 必须定义类型和默认值
– 事件使用 emit 触发，命名使用 kebab-case

## 样式规范
– 使用 scoped 样式
– 优先使用 Element Plus 组件
– 自定义样式使用 BEM 命名规范

## 接口规范
– 所有接口使用 Axios 封装
– 统一错误处理
– 请求和响应使用 TypeScript 类型定义

场景 2：React 项目规则

适用场景：React 18 + TypeScript + Ant Design 项目

# React 项目规范

## 技术栈
– React 18+ (Hooks)
– TypeScript 5.0+
– Vite 5.0+
– Ant Design 5
– React Router 6
– Zustand (状态管理)

## 代码规范
– 函数组件使用箭头函数
– 组件文件使用 PascalCase 命名
– 自定义 Hook 使用 use 前缀
– 工具函数使用 camelCase 命名

## 组件规范
– 优先使用函数组件
– 使用 React.memo 优化性能
– 复杂状态使用 useReducer
– 副作用使用 useEffect，注意清理

## 样式规范
– 使用 CSS Modules
– 优先使用 Ant Design 组件
– 自定义样式使用 BEM 命名规范

## 接口规范
– 使用 React Query 或 SWR 管理数据
– 统一错误处理和 Loading 状态
– 请求和响应使用 TypeScript 类型定义

场景 3：Node.js 后端项目规则

适用场景：Express/Koa + TypeScript + MySQL 项目

# Node.js 后端项目规范

## 技术栈
– Node.js 20+
– Express 4 / Koa 2
– TypeScript 5.0+
– MySQL 8.0
– TypeORM / Prisma

## 代码规范
– 使用 async/await，避免回调地狱
– 错误处理使用 try-catch
– 日志使用 Winston 或 Pino
– 配置使用环境变量

## 目录结构
– src/controllers/ — 控制器
– src/services/ — 业务逻辑
– src/models/ — 数据模型
– src/middlewares/ — 中间件
– src/utils/ — 工具函数

## API 规范
– RESTful 风格
– 统一响应格式：{ code, message, data }
– 错误码统一管理
– 请求参数验证使用 Joi 或 Zod

## 数据库规范
– 表名使用复数形式（如 users）
– 字段名使用 snake_case
– 必须有 created_at 和 updated_at
– 软删除使用 deleted_at

场景 4：全栈项目规则

适用场景：前后端分离的全栈项目

# 全栈项目规范

## 技术栈
– 前端：Vue 3 / React 18 + TypeScript
– 后端：Node.js + Express/Koa + TypeScript
– 数据库：MySQL / PostgreSQL
– 部署：Docker + Nginx

## 代码规范
– 前后端都使用 TypeScript
– 统一使用 ESLint + Prettier
– 提交前必须通过 lint 检查

## 接口规范
– 前后端接口统一定义在 src/types/api.ts
– 使用 OpenAPI/Swagger 生成接口文档
– 错误码统一管理

## 部署规范
– Docker 容器化部署
– 环境变量统一管理
– 日志统一收集

## Git 规范
– 分支命名：feature/xxx、bugfix/xxx、release/xxx
– 提交信息：type(scope): description
– PR 必须通过 Code Review

场景 5：6A 工作流规则（高级）

适用场景：复杂项目，需要 AI 按照专业流程执行

# 6A 工作流规则

## 激活方式
用户输入 6A 开头的内容即可启动工作流。

## 身份定义
你是一位资深的软件架构师和工程师，具备丰富的项目经验和系统思维能力。

## 6A 工作流执行规则

### 阶段 1: Align（对齐）
– 分析现有项目结构、技术栈、架构模式
– 创建 docs/任务名/ALIGNMENT_[任务名].md
– 主动询问关键决策点

### 阶段 2: Architect（架构）
– 设计技术方案
– 创建 docs/任务名/ARCHITECTURE_[任务名].md
– 说明为什么选择这个方案

### 阶段 3: Atomize（原子化）
– 大任务拆分成小任务
– 创建 docs/任务名/TASK_[任务名].md
– 每个任务明确输入、输出、验收标准

### 阶段 4: Approve（审批）
– 人工检查计划
– 等待用户确认后继续

### 阶段 5: Automate（执行）
– 按文档执行
– 每完成一个任务都要验证

### 阶段 6: Assess（评估）
– 质量验收
– 不合格就重来

04 高级技巧：让 Rules 更强大

技巧 1：规则嵌套（v3.3.51+）

从 v3.3.51 起，Trae 支持规则嵌套，可以为不同目录配置不同规则。

目录结构：

.trae/
├── rules/
│ ├── project_rules.md # 项目通用规则
│ ├── frontend_rules.md # 前端规则
│ ├── backend_rules.md # 后端规则
│ └── components_rules.md # 组件规则

使用方式：
– 项目通用规则：自动应用
– 前端规则：只在 src/components/ 和 src/views/ 下生效
– 后端规则：只在 server/ 下生效

技巧 2：用 AI 生成规则

如果你不知道怎么写规则，可以让 Trae 帮你：

#workspace

分析这个项目的代码规范，帮我生成 project_rules.md

或者：

#File:src/utils/helper.ts

根据这个文件的代码风格，帮我生成项目规则

技巧 3：从开源项目学习

参考开源项目的规则，学习其规范描述方法：

• Ant Design：文档和 Changelog 规范
• Vue.js：代码风格指南
• React：最佳实践

学习方法：
1. 找到开源项目的 .trae/rules/ 目录
2. 复制其规则到你的项目
3. 根据你的项目需求修改

技巧 4：团队规范转换

如果你已经有团队规范文档，可以转换成 Rules：

#Doc:团队规范文档

我想把这个文档变成一个团队规范，请帮我聚合以及凝练一下。

技巧 5：Rules + Prompt 配合

Rules 负责"长期规范"，Prompt 负责"临时需求"。

示例：
– Rules：代码用驼峰命名、每个函数有注释
– Prompt：这个函数用下划线命名、不需要注释

Prompt 会覆盖 Rules，但只在当前对话生效。

05 常见错误：5 个坑你一定要避开

错误 1：规则太长

❌ 写了 1000 行规则，Trae 记不住
✅ 精简到 100-200 行，核心规则

错误 2：规则太模糊

❌ "代码要规范"
✅ "使用驼峰命名、每个函数有 JSDoc 注释"

错误 3：没有测试规则

❌ 写完规则就不管了
✅ 写完后测试一下，看看 Trae 是否遵循

错误 4：频繁修改规则

❌ 每天都改规则，Trae 会混乱
✅ 规则确定后尽量不改，改前先和团队沟通

错误 5：没有版本控制

❌ 规则文件不提交到 Git
✅ 规则文件必须提交，团队共享

06 速查表：Rules 配置模板

07 总结

Rules 的核心价值：
1. 一致性：确保所有代码遵循相同规范
2. 自动化：不用每次都在 Prompt 里重复规范
3. 可追溯：规则文件本身就是项目文档

快速上手：
1. 打开设置 → 规则
2. 创建 user_rules.md 或 project_rules.md
3. 编写规则并保存
4. 测试一下效果

高级技巧：
1. 规则嵌套（v3.3.51+）
2. 用 AI 生成规则
3. 从开源项目学习
4. Rules + Prompt 配合

08 关于我

国内某互联网上市公司高级研发工程师、研发组长，致力于 AI 方面的研究和学习分享。关注我，一起学习成长。《MC AI技术开发》

你有什么好用的 Rules 配置？欢迎在评论区分享！