一个命令，20个AI专家为你工作！
官方 Trae AI 规范 · 100% 标准 · 开箱即用
技术操作指南请参考：.trae/README.md
| 🎯 核心优势 | 🚀 实际效果 |
|---|---|
| 20个AI专家 | 产品经理+架构师+开发工程师+测试工程师 |
| 一键启动 | 一个命令开始完整开发流程 |
| 零配置 | 复制即用，无需任何环境配置 |
| 跨平台 | Windows/Mac/Linux 完美兼容 |
| 7种技术栈 | Vue3/React/FastAPI/Node.js/Go/Rust/Flutter |
| 模板自动化 | 30秒生成完整项目框架 |
| 企业级标准 | 生产环境就绪的代码规范 |
| 中文优先 | 完整中文文档和示例 |
my-project/
├── .trae/ # 📦 项目配置（可复制）
│ ├── AGENTS.md # AI智能体定义
│ ├── CONSTITUTION.md # 🏛️ 宪法
│ ├── skills/ # 🎯 技能系统
│ ├── rules/ # 📋 协作规则
│ ├── docs/ # 📖 方法论文档
│ ├── workflows/ # ⚡ 工作流工具
│ ├── templates/ # 📝 项目模板
│ └── agent/ # 🤖 智能体配置
│
├── .trae-data/ # 🌱 项目私有数据（不复制）
│ ├── logs/ # 📊 操作日志
│ ├── cache/ # 💾 缓存数据
│ ├── learning/ # 🧠 学习记录
│ └── stats/ # 📈 统计数据
设计原则：
- 📦 项目独立 - 复制
.trae/到任何项目，立即获得完整 AI 能力 - 🔒 隐私保护 -
.trae-data/自动添加到.gitignore，保护用户数据 - 🌐 即插即用 - 智能检测项目类型、技术栈、环境配置
三大公理 + 六大原则 = 人机共生协作
| 公理 | 说明 |
|---|---|
| 意图主权公理 | 人类永远保留对"为什么"和"什么是正确"的最终决策权 |
| 信号可信公理 | AI的所有输出必须携带可追溯、可验证的原始信号链 |
| 认知可审计公理 | 所有AI协作过程必须支持"三秒回溯" |
- D1 - 讨论优先原则：所有项目创建和重大决策必须先讨论后执行
- D2 - 渐进增强原则：从最小可行开始，逐步迭代优化
- D3 - 透明决策原则：AI的每个建议都必须说明原因和依据
- D4 - 人工最终决策原则：人类保留最终否决权和修改权
- D5 - 持续学习原则：AI应记住用户的偏好和项目特点
- D6 - 效率优先原则：在保证质量的前提下，追求最高效率
| 角色 | 技术栈 | 专长领域 |
|---|---|---|
| Vue工程师 | Vue 3, TypeScript, Vite, Pinia | 组件设计、状态管理、性能优化 |
| React工程师 | React 18, Next.js, TypeScript | Hooks设计、SSR、状态管理 |
| FastAPI工程师 | FastAPI, Python, SQLAlchemy | API设计、数据库建模、性能优化 |
| NodeJS工程师 | Node.js, Express, Nest.js | 服务端开发、微服务架构 |
| Python工程师 | Python, Django, Flask | 全栈开发、数据处理 |
| Flutter工程师 | Flutter, Dart | 跨平台移动开发 |
| Go工程师 | Go, Gin | 高性能服务开发 |
| Rust工程师 | Rust, Actix | 系统编程、性能优化 |
| C++工程师 | C++, AI部署 | AI模型部署、推理优化 |
| Angular工程师 | Angular, TypeScript | 企业级应用开发 |
| UNIAPP工程师 | UNIAPP, Vue.js | 小程序开发 |
| 系统架构师 | 架构设计、技术选型 | 系统优化、风险评估 |
| 产品经理 | 需求分析、产品设计 | 用户故事、进度把控 |
| 测试工程师 | 单元测试、集成测试 | 测试策略、自动化测试 |
| DevOps工程师 | Docker, CI/CD, K8s | 部署流水线、监控告警 |
| UI/X设计师 | 交互设计、用户体验 | 设计系统、动效交互 |
| 技术文档工程师 | API文档、使用指南 | 文档驱动、清晰示例 |
| 项目协调工程师 | 项目协调、团队协作 | 跨团队沟通、进度跟踪 |
| 环境管理器 | 环境配置、依赖管理 | 开发环境、一键初始化 |
| AI工程师 | Python, AI/ML | 机器学习、模型开发 |
👔 专业角色 (8种)：专业助手、谦逊助手、友好伙伴、专家导师、创意艺术家、严格教师、搞笑演员、极简禅者
🌟 动漫风格 (13种)：可爱萝莉、御姐女王、完美女仆、赛博朋克黑客、魔法少女程序员、高冷学霸、暖男助手、精灵工程师、机械管家、古风书生、元气少女、神秘侦探、太空漫游者
| 技能 | 功能 | 使用场景 |
|---|---|---|
code-analyzer |
分析项目结构和技术栈 | 了解新项目、代码审计 |
readme-generator |
自动生成专业 README | 项目初始化、文档完善 |
project-scaffold |
生成项目脚手架 | 从零创建新项目 |
git-initializer |
Git 仓库初始化 | 项目版本控制 |
docker-generator |
生成 Docker 配置 | 容器化部署 |
# 在对话中直接使用
使用 code-analyzer 技能分析一下项目结构
帮我用 project-scaffold 创建一个 Vue 3 项目| 模板 | 用途 |
|---|---|
project-init-template.md |
项目初始化模板 |
agent-template.json |
AI智能体配置模板 |
api-spec-template.md |
API接口规范模板 |
code-review-template.md |
代码审查模板 |
database-design-template.md |
数据库设计模板 |
test-plan-template.md |
测试计划模板 |
requirements-template.md |
需求文档模板 |
Documentation → Interface → Backend → Everything
VIBE 是一种文档驱动的迭代开发方法：
| 阶段 | 名称 | 核心任务 |
|---|---|---|
| Phase 1 | 📝 Documentation | 需求文档、技术选型 |
| Phase 2 | 🎨 Interface | API设计、数据模型 |
| Phase 3 | 🧪 Backend | 单元测试、业务逻辑 |
| Phase 4 | 🎨 Frontend | UI组件、API对接 |
| Phase 5 | 🔄 Iteration | Bug修复、持续优化 |
| 工具 | 功能 |
|---|---|
trae-console.py |
AI 控制台，交互式操作入口 |
master.py |
Master 命令中枢，统一命令入口 |
agent-suite.py |
智能体套件，管理AI专家团队 |
template-manager.py |
模板管理器，快速生成项目模板 |
project-init.py |
项目初始化，一键创建项目结构 |
| 脚本 | 功能 |
|---|---|
console_utils.py |
控制台工具，彩色输出、进度条 |
data_manager.py |
数据管理器，日志记录、统计 |
learner.py |
学习模块，用户偏好记忆 |
smart-cleanup.py |
智能清理，缓存管理 |
smart-reminder.py |
智能提醒，进度跟踪 |
auto-test-runner.py |
自动测试，测试执行 |
.trae/
├── AGENTS.md # 🤖 AI智能体定义
├── CONSTITUTION.md # 🏛️ 宪法（三大公理+六大原则）
├── README.md # 🔧 技术操作指南
├── principles.md # 🎯 12个开发原则
│
├── agent/ # 🤖 AI专家配置（20个）
│ ├── vue-engineer.json
│ ├── react-engineer.json
│ ├── fastapi-engineer.json
│ ├── system-architect-engineer.json
│ ├── test-engineer.json
│ └── ... (共20个)
│
├── core/ # 🔧 核心脚本
│ ├── console_utils.py # 控制台工具
│ ├── data_manager.py # 数据管理
│ ├── learner.py # 学习模块
│ ├── smart-cleanup.py # 智能清理
│ ├── smart-reminder.py # 智能提醒
│ ├── auto-test-runner.py # 自动测试
│ ├── auto-environment-manager.py
│ ├── project-assistant.py
│ ├── cross-platform-adapter.py
│ ├── smart-requirements-clarifier.py
│ └── system-enhancer.py
│
├── docs/ # 📖 方法论文档
│ ├── VIBE_METHODOLOGY.md # 🚀 VIBE开发方法论
│ ├── PERSONA_SYSTEM.md # 🎭 人格角色系统
│ ├── ROLES.md # 角色定义文档
│ └── DUAL_DIRECTORY_DESIGN.md # 🏗️ 双目录架构
│
├── rules/ # 📋 协作规则
│ ├── principles.md # 开发原则
│ ├── agents.md # 智能体规则
│ ├── roles.md # 角色规则
│ ├── git-commit-message.md # Git提交规范
│ └── project_rules.md # 项目规则
│
├── skills/ # 🎯 技能系统
│ ├── code-analyzer/
│ │ └── SKILL.md
│ ├── project-scaffold/
│ │ └── SKILL.md
│ ├── readme-generator/
│ │ └── SKILL.md
│ ├── git-initializer/
│ │ └── SKILL.md
│ └── docker-generator/
│ └── SKILL.md
│
├── templates/ # 📝 项目模板
│ ├── project-init-template.md
│ ├── api-spec-template.md
│ ├── code-review-template.md
│ ├── database-design-template.md
│ ├── test-plan-template.md
│ ├── requirements-template.md
│ ├── tech-choice-template.md
│ ├── deployment-template.md
│ ├── html-composition-template.md
│ └── principle-driven-template.json
│
├── workflows/ # ⚡ 工作流
│ ├── trae-console.py # AI控制台
│ ├── master.py # 命令中枢
│ ├── agent-suite.py # 智能体套件
│ ├── template-manager.py # 模板管理
│ ├── project-init.py # 项目初始化
│ └── universal-env-manager.py
│
├── user-data/ # 👤 用户数据
│ ├── projects.json
│ ├── projects.json.example
│ ├── user_preferences.json
│ └── user_preferences.json.example
│
├── install.sh # 🚀 Linux/macOS安装脚本
├── install.bat # 🚀 Windows安装脚本
├── setup-trae.sh # 🔧 配置脚本
├── start.sh / start.bat # 🚀 启动脚本
├── trae.py # 🐍 主入口
├── mcp-config.json # MCP协议配置
└── .trae-config.json # 📋 Trae配置
💡 详细操作指南请参考 .trae/README.md
# 1. 复制 .trae 文件夹
cp -r .trae /path/to/your/project/
# 2. 进入项目目录
cd your-project
# 3. 安装依赖（可选）
./.trae/install.sh # Linux/macOS
# 或
./.trae/install.bat # Windows
# 4. 启动 Trae AI
python .trae/trae.py start# 1. 创建新目录
mkdir my-project && cd my-project
# 2. 复制 .trae 配置
cp -r /path/to/this/repo/.trae .
# 3. 开始使用
python .trae/trae.py start帮我用 Vue 3 开发一个用户管理组件 → Vue 工程师模式
帮我设计一个 RESTful API → FastAPI 工程师模式
帮我分析一下项目架构 → 系统架构师模式
帮我写单元测试 → 测试工程师模式
使用 project-scaffold 创建一个 Vue 3 项目
使用 code-analyzer 分析当前项目结构
使用 docker-generator 生成 Docker 配置
使用 readme-generator 生成项目 README
启动 VIBE 开发流程 → 文档驱动 → 接口设计 → 后端开发 → 前端实现 → 持续迭代
MIT License
✨ 现在开始享受 Trae AI 的强大功能吧！
技术操作指南请参考：.trae/README.md