Trae Rules 进阶:5个实用模板+高级技巧
💡 适合人群:Trae 用户、想让 AI 更懂你项目的开发者、团队技术负责人
每次让 Trae 写代码,它总是用你不喜欢的命名规范;让它生成接口,它总是漏掉错误处理;让它写文档,它总是用英文……
打个比方——Rules 就像是给新员工的入职手册。新员工刚来,不知道团队规范,你得告诉他:
Rules 也一样。你把团队规范写进去,Trae 就会自动遵循,不用每次都在 Prompt 里重复。
| 类型 | 文件名 | 作用范围 |
| 个人规则 | user_rules.md | 所有项目 |
| 项目规则 | project_rules.md | 当前项目 |
| 目录规则(v3.3.51+) | 任意 .md 文件 | 特定子目录 |
3. 点击「创建 user_rules.md」或「创建 project_rules.md」
# 基本要求
- 使用中文回复
- 代码注释用中文
- 优先使用 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/ — 接口定义
你会发现,Trae 生成的代码自动遵循了你的规则!
适用场景: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 类型定义
适用场景: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 类型定义
适用场景: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
# 全栈项目规范
## 技术栈
- 前端: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
# 6A 工作流规则
## 激活方式
用户输入 6A 开头的内容即可启动工作流。
## 身份定义
你是一位资深的软件架构师和工程师,具备丰富的项目经验和系统思维能力。
## 6A 工作流执行规则
### 阶段 1: Align(对齐)
- 分析现有项目结构、技术栈、架构模式
- 创建 docs/任务名/ALIGNMENT_[任务名].md
- 主动询问关键决策点
### 阶段 2: Architect(架构)
- 设计技术方案
- 创建 docs/任务名/ARCHITECTURE_[任务名].md
- 说明为什么选择这个方案
### 阶段 3: Atomize(原子化)
- 大任务拆分成小任务
- 创建 docs/任务名/TASK_[任务名].md
- 每个任务明确输入、输出、验收标准
### 阶段 4: Approve(审批)
- 人工检查计划
- 等待用户确认后继续
### 阶段 5: Automate(执行)
- 按文档执行
- 每完成一个任务都要验证
### 阶段 6: Assess(评估)
- 质量验收
- 不合格就重来
从 v3.3.51 起,Trae 支持规则嵌套,可以为不同目录配置不同规则。
.trae/
├── rules/
│ ├── project_rules.md # 项目通用规则
│ ├── frontend_rules.md # 前端规则
│ ├── backend_rules.md # 后端规则
│ └── components_rules.md # 组件规则
• 前端规则:只在 src/components/ 和 src/views/ 下生效
#workspace
分析这个项目的代码规范,帮我生成 project_rules.md
#File:src/utils/helper.ts
根据这个文件的代码风格,帮我生成项目规则
• Ant Design:文档和 Changelog 规范
1. 找到开源项目的 .trae/rules/ 目录
如果你已经有团队规范文档,可以转换成 Rules:
#Doc:团队规范文档
我想把这个文档变成一个团队规范,请帮我聚合以及凝练一下。
Rules 负责"长期规范",Prompt 负责"临时需求"。
• Prompt:这个函数用下划线命名、不需要注释
Prompt 会覆盖 Rules,但只在当前对话生效。
❌ 写了 1000 行规则,Trae 记不住 ✅ 精简到 100-200 行,核心规则
❌ "代码要规范" ✅ "使用驼峰命名、每个函数有 JSDoc 注释"
❌ 写完规则就不管了 ✅ 写完后测试一下,看看 Trae 是否遵循
❌ 每天都改规则,Trae 会混乱 ✅ 规则确定后尽量不改,改前先和团队沟通
❌ 规则文件不提交到 Git ✅ 规则文件必须提交,团队共享
| 场景 | 推荐规则 |
| Vue 3 项目 | Composition API + TypeScript + Element Plus |
| React 项目 | Hooks + TypeScript + Ant Design |
| Node.js 后端 | Express/Koa + TypeScript + MySQL |
| 全栈项目 | 前后端分离 + TypeScript + Docker |
| 复杂项目 | 6A 工作流规则 |
2. 自动化:不用每次都在 Prompt 里重复规范
2. 创建 user_rules.md 或 project_rules.md
国内某互联网上市公司高级研发工程师、研发组长,致力于 AI 方面的研究和学习分享。关注我,一起学习成长。《MC AI技术开发》
你有什么好用的 Rules 配置?欢迎在评论区分享!