乐于分享
好东西不私藏

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

Trae Rules 进阶:5个实用模板+高级技巧
Trae Rules 进阶:5个实用模板+高级技巧
💡 适合人群:Trae 用户、想让 AI 更懂你项目的开发者、团队技术负责人
01
为什么你的 Trae 总是"不听话"?
你有没有遇到过这种情况:
每次让 Trae 写代码,它总是用你不喜欢的命名规范;让它生成接口,它总是漏掉错误处理;让它写文档,它总是用英文……
问题不在 Trae,在你没有配置 Rules。
Rules 是什么?
打个比方——Rules 就像是给新员工的入职手册。新员工刚来,不知道团队规范,你得告诉他:
• 代码用驼峰命名
• 每个函数必须有注释
• 错误处理用 try-catch
• ……
Rules 也一样。你把团队规范写进去,Trae 就会自动遵循,不用每次都在 Prompt 里重复。
三种 Rules 类型:
类型文件名作用范围
个人规则user_rules.md所有项目
项目规则project_rules.md当前项目
目录规则(v3.3.51+)任意 .md 文件特定子目录
02
快速上手:创建你的第一个 Rule
步骤 1:打开 Rules 配置
1. 点击 Trae 右上角的「设置」按钮
2. 选择「规则」
3. 点击「创建 user_rules.md」或「创建 project_rules.md」
步骤 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 配置模板
场景推荐规则
Vue 3 项目Composition API + TypeScript + Element Plus
React 项目Hooks + TypeScript + Ant Design
Node.js 后端Express/Koa + TypeScript + MySQL
全栈项目前后端分离 + TypeScript + Docker
复杂项目6A 工作流规则
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 配置?欢迎在评论区分享!

相关学习资料