mcpField
T
trae-project-setup

trae-project-setup

github.com/boshi-xixixiエージェントワークフロー28039 回インストール24 週間前に更新
リポジトリ

trae-project-setup について

Trae プロジェクトの設定を作成・検証する Skill です。プロジェクトルールやユーザー設定を統一したい開発者向けで、Skill と Agent のディレクトリやファイルのテンプレートも用意します。

主な機能

  1. 01.trae 設定ディレクトリの初期化
  2. 02プロジェクト設定の検証
  3. 03設定とプロジェクトルールのテンプレート作成
  4. 04Skill ディレクトリの初期化
  5. 05Skill と Agent のテンプレート提供

活用シーン

  1. 01新規プロジェクトの Trae 設定
  2. 02既存プロジェクト設定の適合確認
  3. 03カスタム Skill の構成作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/boshi-xixixi/traeskill --skill trae-project-setup

インストール後、Claude Code で/trae-project-setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
skill_development_guide.md
trae_configuration_spec.md
scripts/
init_trae_project.py
validate_trae_project.py
templates/
AGENTS.md.template
SKILL.md.template
USER_PREFERENCES.md.template
project_rules.md.template

詳細

プロジェクトの README より

Trae Project Setup

本 Skill 用于快速生成 Trae 项目所需的规范化配置文件,帮助项目实现标准化开发流程。

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

核心配置文件详解

USER_PREFERENCES.md

用户偏好文件,定义全局行为模式。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.md

项目规则文件,定义项目特定的开发规范。

关键配置项:

# 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

使用初始化脚本
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 格式
---
name: skill-name
description: Skill 描述,包含触发条件和使用场景
---

# Skill Title

## Overview
简要说明 Skill 功能

## Workflow
1. 步骤一
2. 步骤二
AGENTS.md 格式
---
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 模板

参考文档

详细规范请参阅:

コメント