trae-project-setup: Скилл для быстрой настройки проектов

```markdown --- name: trae-project-setup description: Trae 项目规范化配置专家。用于快速初始化 Trae 项目配置文件、生成项目规则、用户偏好设置和 Skill 模板。当用户需要：(1) 初始化新项目的 Trae 配置 (2) 生成 .trae 目录结构 (3) 创建 USER_PREFERENCES.md 用户偏好文件 (4) 创建 project_rules.md 项目规则文件 (5) 创建新的 Skill 模板 时使用此 Skill。 --- # Trae Project Setup Этот Skill используется для быстрого создания стандартизированных конфигурационных файлов, необходимых для проекта Trae, что помогает реализовать стандартизированный процесс разработки. ## Обзор системы конфигурации Trae Trae управляет конфигурацией проекта через каталог `.trae` и поддерживает следующие основные файлы: | Путь к файлу | Назначение | Приоритет | |---------|------|--------| | `.trae/USER_PREFERENCES.md` | Настройки пользователя (язык, стек технологий, стиль взаимодействия) | Наивысший | | `.trae/rules/project_rules.md` | Правила, специфичные для проекта (lint, typecheck, команды сборки) | Высокий | | `.trae/Skills/` | Каталог для пользовательских Skill | Средний | ## Быстрый старт ### Инициализация конфигурации проекта Запустите скрипт инициализации, чтобы автоматически создать полную структуру каталога `.trae`: ```bash python scripts/init_trae_project.py --path /path/to/project ``` Скрипт автоматически создаст: - `.trae/USER_PREFERENCES.md` - Шаблон пользовательских настроек - `.trae/rules/project_rules.md` - Шаблон правил проекта - `.trae/Skills/` - Каталог для хранения Skill ### Проверка конфигурации проекта Проверьте, соответствует ли существующая конфигурация требованиям: ```bash python scripts/validate_trae_project.py --path /path/to/project ``` ## Подробное описание основных конфигурационных файлов ### USER_PREFERENCES.md Файл пользовательских настроек, определяющий глобальные шаблоны поведения. Trae будет отдавать приоритет настройкам, указанным в этом файле, во всех операциях. **Основные параметры конфигурации:** ```markdown # 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.md Файл правил проекта, определяющий специфические для проекта стандарты разработки. **Основные параметры конфигурации:** ```markdown # 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/* ``` ## Создание нового Skill ### Использование скрипта инициализации ```bash python scripts/init_trae_skill.py <skill-name> --path .trae/Skills ``` ### Структура каталога Skill ``` skill-name/ ├── SKILL.md # Обязательно: Основной файл Skill ├── scripts/ # Необязательно: Выполняемые скрипты ├── references/ # Необязательно: Справочные документы ├── assets/ # Необязательно: Ресурсы └── AGENTS.md # Необязательно: Определение Agent ``` ### Формат SKILL.md ```markdown --- name: skill-name description: Описание Skill, включая условия запуска и сценарии использования --- # Название Skill ## Обзор Краткое описание функциональности Skill ## Workflow 1. Шаг один 2. Шаг два ``` ### Формат AGENTS.md ```markdown --- name: agent-name description: Описание Agent --- # Название Agent ## Определение роли * **Специализация**: Описание области экспертизы * **Стиль**: Описание стиля работы ## Workflow 1. Шаг один 2. Шаг два ``` ## Файлы шаблонов Полные файлы шаблонов находятся в каталоге `templates/`: - `USER_PREFERENCES.md.template` - Шаблон пользовательских настроек - `project_rules.md.template` - Шаблон правил проекта - `SKILL.md.template` - Шаблон Skill - `AGENTS.md.template` - Шаблон Agent ## Справочная документация Подробные спецификации можно найти в: - [Спецификация конфигурации Trae](references/trae_configuration_spec.md) - [Руководство по разработке Skill](references/skill_development_guide.md) ```