菜单
Trae 项目规范化配置专家。用于快速初始化 Trae 项目配置文件、生成项目规则、用户偏好设置和 Skill 模板。当用户需要：(1) 初始化新项目的 Trae 配置 (2) 生成 .trae 目录结构 (3) 创建 USER_PREFERENCES.md 用户偏好文件 (4) 创建 project_rules.md 项目规则文件 (5) 创建新的 Skill 模板 时使用此 Skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | trae-project-setup |
| description | Trae 项目规范化配置专家。用于快速初始化 Trae 项目配置文件、生成项目规则、用户偏好设置和 Skill 模板。当用户需要：(1) 初始化新项目的 Trae 配置 (2) 生成 .trae 目录结构 (3) 创建 USER_PREFERENCES.md 用户偏好文件 (4) 创建 project_rules.md 项目规则文件 (5) 创建新的 Skill 模板 时使用此 Skill。 |
本 Skill 用于快速生成 Trae 项目所需的规范化配置文件，帮助项目实现标准化开发流程。
Trae 通过 .trae 目录管理项目配置，支持以下核心文件：
| 文件路径 | 用途 | 优先级 |
|---|---|---|
.trae/USER_PREFERENCES.md | 用户偏好设置（语言、技术栈、交互风格） | 最高 |
.trae/rules/project_rules.md | 项目特定规则（lint、typecheck、构建命令） | 高 |
.trae/Skills/ | 自定义 Skill 目录 | 中 |
运行初始化脚本，自动创建完整的 .trae 目录结构：
python scripts/init_trae_project.py --path /path/to/project
脚本会自动创建：
.trae/USER_PREFERENCES.md - 用户偏好模板.trae/rules/project_rules.md - 项目规则模板.trae/Skills/ - Skill 存放目录验证现有配置是否符合规范：
python scripts/validate_trae_project.py --path /path/to/project
用户偏好文件，定义全局行为模式。Trae 会在所有操作中优先遵循此文件的设置。
关键配置项：
# User Preferences
## 1. 技术栈偏好 (Tech Stack)
* **CSS Framework**: Tailwind CSS
* **State Management**: Zustand (React), Riverpod (Flutter)
* **Testing**: Vitest
* **Language**: TypeScript (Strict Mode)
## 2. 交互风格 (Communication Style)
* **Language**: 中文回复，技术术语保留英文
* **Detail Level**: 资深开发者模式，直接给代码
* **Emoji**: 禁用
## 3. 角色覆盖 (Role Overrides)
* **@Backend Developer**: 优先使用 FastAPI
## 4. 禁令 (Constraints)
* 严禁使用 `any` 类型
* 严禁创建 `.env` 文件
项目规则文件，定义项目特定的开发规范。
关键配置项：
# Project Rules
## 构建与验证命令
* **Lint**: npm run lint
* **TypeCheck**: npm run typecheck
* **Test**: npm run test
* **Build**: npm run build
## 代码规范
* **函数注释**: 必须添加函数级注释
* **语言**: 中文注释，外链库需在中国可用
## Git 规范
* **Commit**: 遵循 Conventional Commits
* **Branch**: feature/*, fix/*, docs/*
python scripts/init_trae_skill.py <skill-name> --path .trae/Skills
skill-name/
├── SKILL.md # 必需：Skill 主文件
├── scripts/ # 可选：可执行脚本
├── references/ # 可选：参考文档
├── assets/ # 可选：资源文件
└── AGENTS.md # 可选：Agent 定义
---
name: skill-name
description: Skill 描述，包含触发条件和使用场景
---
# Skill Title
## Overview
简要说明 Skill 功能
## Workflow
1. 步骤一
2. 步骤二
---
name: agent-name
description: Agent 描述
---
# Agent Title
## 角色定义
* **专长**: 描述专业领域
* **风格**: 描述工作风格
## 工作流程
1. 步骤一
2. 步骤二
完整的模板文件存放在 templates/ 目录：
USER_PREFERENCES.md.template - 用户偏好模板project_rules.md.template - 项目规则模板SKILL.md.template - Skill 模板AGENTS.md.template - Agent 模板详细规范请参阅：
当用户需要创建新 Skill 或更新现有 Skill 时使用。此 Skill 提供技能创建的完整工作流指导，包括需求分析、编写规范、工程化构建、质量评估和迭代优化。
当用户需要将需求转化为可执行任务、进行技术选型或协调多个专业 Skill 协作时使用。此 Skill 充当任务调度中心，接收需求文档并智能路由到合适的专业领域。
当用户需要从零开始构建完整项目或需要多角色协作时使用。此 Skill 充当全能开发团队，包含产品经理、架构师、设计师、开发者和测试人员，指导从想法到上线的全过程。
当用户在项目初期或重大功能迭代时需要进行技术选型时使用。此 Skill 根据需求自动生成 2-3 套技术方案对比，涵盖前端、后端、数据库及中间件，并提供优劣势分析和最终选型建议。
当用户在开始开发前需要搜索现有的开源库、工具、MCP Server 或最佳实践代码时使用。帮助避免重复造轮子，找到最适合当前需求的现成解决方案。
当用户需要进行创意发散、需求探索或产品规划时使用（无论是创建功能、构建组件、添加功能还是修改行为）。此 Skill 通过协作对话将想法转化为完整的设计方案和需求规格说明书。