教程概览

🧠 创建 SKILL

定义 AI 的专业能力,让 Trae 按照你的工作流程执行任务。

📋 创建规则

建立项目规范,确保 AI 生成的代码符合你的设计标准。

🔗 绑定 WordPress

配置 WP 环境变量,让 AI 能够直接操作你的网站。

🎨 设计系统

定义颜色、字体、全局组件,建立统一的视觉语言。

学习目标

完成本教程后,你将能够:创建自定义 SKILL、配置项目规则、绑定 WordPress、建立设计系统,并通过对话让 AI 自动生成符合规范的网站代码。

第一步:创建 SKILL

什么是 SKILL?

SKILL 是 Trae 的"插件系统",你可以定义 AI 的专业能力、工作流程和输出格式。创建 SKILL 后,AI 会自动按照你定义的规则执行任务。

SKILL 文件结构

每个 SKILL 都是一个独立的文件夹,包含一个 SKILL.md 文件。文件使用 Markdown 格式,包含以下部分:

SKILL.md
---
name: my-custom-skill
description: A brief description of what this skill does
version: 1.0.0
author: Your Name
---

# Skill Name

## Description
Explain what this skill does in detail.

## When to Use
Describe the scenarios where this skill should be invoked.

## Workflow
1. Step 1
2. Step 2
3. Step 3

## Output Format
Describe the expected output format.

## Examples
Provide example prompts and responses.

创建你的第一个 SKILL

让我们创建一个简单的 SKILL,用于生成符合 B2B 风格的产品描述:

You
Prompt 复制代码 请帮我创建一个 SKILL,名称为 "b2b-product-writer",功能是生成 B2B 产品描述。要求:1. 使用专业商务语言 2. 包含产品规格 3. 突出核心卖点 4. 字数控制在 200-300 字。
重要提示

SKILL 文件必须放在 .trae/skills/ 目录下,Trae 才能识别。建议每个 SKILL 单独一个文件夹,便于管理。

SKILL 目录结构示例

DIRECTORY
.trae/
└── skills/
    ├── b2b-product-writer/
    │   └── SKILL.md
    ├── seo-content-writer/
    │   └── SKILL.md
    └── ui-ux-pro-max/
        └── SKILL.md

第二步:创建规则

什么是规则?

规则文件定义了项目的编码标准、设计规范、SEO 要求等。AI 在生成代码时会自动读取这些规则,确保输出符合你的项目标准。

规则文件命名规范

规则文件使用数字前缀命名,便于排序和识别:

  • 01- 全局规则(语言、编码规范)
  • 02- 设计系统(颜色、字体、间距)
  • 03- 布局规范(网格、响应式)
  • 04- 组件规范(按钮、卡片、表单)
  • 05- SEO 规范(元数据、结构化数据)
  • 06- 业务规则(品牌信息、CTA 策略)

创建颜色系统规则

让我们创建一个颜色系统规则文件:

You
Prompt 复制代码 请帮我创建一个颜色系统规则文件,命名为 "03-color-system.md"。要求:1. 定义 CSS 变量 2. 包含主色、辅助色、背景色、文字色 3. 提供使用示例 4. 包含深色模式支持。

规则文件示例

03-color-system.md
# Color System

## CSS Variables
```css
:root {
    --primary: #3b82f6;
    --secondary: #6366f1;
    --accent: #8b5cf6;
    --success: #10b981;
    --warning: #f59e0b;
    --danger: #ef4444;
    
    --bg-body: #ffffff;
    --bg-card: #f9fafb;
    --text-main: #1f2937;
    --text-muted: #6b7280;
    --border: #e5e7eb;
}

[data-theme="dark"] {
    --bg-body: #0f172a;
    --bg-card: #1e293b;
    --text-main: #f1f5f9;
    --text-muted: #94a3b8;
    --border: #334155;
}
```

## Usage Guidelines
- Use `--primary` for main CTAs and important actions
- Use `--secondary` for secondary actions
- Use `--accent` for highlights and special elements
- Always use CSS variables, never hardcode colors
规则文件位置

所有规则文件必须放在 .trae/rules/ 目录下。Trae 会自动读取 these 规则,并在生成代码时应用。

第三步:绑定 WordPress

为什么要绑定 WordPress?

绑定 WordPress 后,AI 可以直接读取你的网站数据、上传图片、创建页面,实现真正的自动化开发流程。

创建环境变量文件

在项目根目录创建 .env 文件,存储 WordPress 连接信息:

.env
# WordPress Configuration
WP_URL=https://your-site.com
WP_USERNAME=your-username
WP_PASSWORD=your-application-password
WP_API_KEY=your-rest-api-key

# Optional: Custom Post Type
WP_POST_TYPE=page

# Optional: Custom Taxonomy
WP_TAXONOMY=category

获取 WordPress 凭证

01

登录 WordPress 后台

访问 https://your-site.com/wp-admin 并登录

02

生成应用密码

进入 用户 → 个人资料,滚动到"应用密码"部分,点击"创建新应用密码"

03

复制密码到 .env

将生成的密码复制到 .env 文件的 WP_PASSWORD 字段

安全提示

不要使用你的 WordPress 登录密码!必须使用应用密码。应用密码可以随时撤销,更加安全。同时,.env 文件应该添加到 .gitignore,避免泄露。

测试 WordPress 连接

You
Prompt 复制代码 请测试一下我的 WordPress 连接是否正常。使用 .env 文件中的配置,尝试获取最新的 5 篇文章列表。

第四步:设定颜色系统

为什么需要颜色系统?

统一的颜色系统确保品牌一致性,提高开发效率,便于主题切换(如深色模式)。

定义颜色变量

在规则文件中定义完整的颜色系统:

CSS VARIABLES
:root {
    /* Brand Colors */
    --brand-primary: #2563eb;
    --brand-secondary: #4f46e5;
    --brand-accent: #7c3aed;
    
    /* Semantic Colors */
    --color-success: #10b981;
    --color-warning: #f59e0b;
    --color-error: #ef4444;
    --color-info: #3b82f6;
    
    /* Neutral Colors */
    --color-white: #ffffff;
    --color-gray-50: #f9fafb;
    --color-gray-100: #f3f4f6;
    --color-gray-200: #e5e7eb;
    --color-gray-300: #d1d5db;
    --color-gray-400: #9ca3af;
    --color-gray-500: #6b7280;
    --color-gray-600: #4b5563;
    --color-gray-700: #374151;
    --color-gray-800: #1f2937;
    --color-gray-900: #111827;
    
    /* Background Colors */
    --bg-primary: #ffffff;
    --bg-secondary: #f9fafb;
    --bg-tertiary: #f3f4f6;
    
    /* Text Colors */
    --text-primary: #111827;
    --text-secondary: #4b5563;
    --text-tertiary: #6b7280;
    --text-inverse: #ffffff;
    
    /* Border Colors */
    --border-light: #e5e7eb;
    --border-medium: #d1d5db;
    --border-dark: #9ca3af;
}

深色模式支持

DARK MODE
[data-theme="dark"] {
    --bg-primary: #0f172a;
    --bg-secondary: #1e293b;
    --bg-tertiary: #334155;
    
    --text-primary: #f1f5f9;
    --text-secondary: #cbd5e1;
    --text-tertiary: #94a3b8;
    
    --border-light: #334155;
    --border-medium: #475569;
    --border-dark: #64748b;
}

让 AI 使用你的颜色系统

You
Prompt 复制代码 请帮我创建一个产品卡片组件。要求:1. 使用我定义的颜色变量(--bg-primary, --text-primary, --border-light)2. 卡片有 hover 效果 3. 包含产品图片、标题、价格、购买按钮。

第五步:设定字体系统

字体系统的重要性

统一的字体系统提升可读性,建立品牌识别,确保跨平台一致性。

定义字体变量

FONT VARIABLES
:root {
    /* Font Families */
    --font-display: 'Playfair Display', Georgia, serif;
    --font-heading: 'Inter', -apple-system, sans-serif;
    --font-body: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
    --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
    
    /* Font Sizes */
    --text-xs: 0.75rem;
    --text-sm: 0.875rem;
    --text-base: 1rem;
    --text-lg: 1.125rem;
    --text-xl: 1.25rem;
    --text-2xl: 1.5rem;
    --text-3xl: 1.875rem;
    --text-4xl: 2.25rem;
    
    /* Font Weights */
    --font-light: 300;
    --font-normal: 400;
    --font-medium: 500;
    --font-semibold: 600;
    --font-bold: 700;
    --font-extrabold: 800;
    
    /* Line Heights */
    --leading-tight: 1.25;
    --leading-normal: 1.5;
    --leading-relaxed: 1.75;
    
    /* Letter Spacing */
    --tracking-tight: -0.025em;
    --tracking-normal: 0;
    --tracking-wide: 0.025em;
}

字体使用规范

  • Display Font: 用于大标题、Hero 区域
  • Heading Font: 用于 H1-H6 标题
  • Body Font: 用于正文、段落
  • Mono Font: 用于代码、数据、技术内容

导入 Google Fonts

HTML
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Playfair+Display:wght@400;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">

第六步:全局组件

全局组件的作用

全局组件(Header、Footer)在所有页面共享,确保导航一致性,减少重复代码,便于统一维护。

全局组件目录结构

DIRECTORY
website/
├── global/
│   ├── header.html
│   ├── footer.html
│   └── styles.css
└── pages/
    ├── home/
    ├── about/
    └── contact/

创建全局 Header

You
Prompt 复制代码 请帮我创建一个全局 Header 组件。要求:1. 包含 Logo、导航菜单、CTA 按钮 2. 响应式设计(移动端汉堡菜单)3. 使用我定义的颜色和字体变量 4. 滚动时添加阴影效果。

创建全局 Footer

You
Prompt 复制代码 请帮我创建一个全局 Footer 组件。要求:1. 包含公司信息、快速链接、社交媒体图标 2. 4 列布局 3. 使用我定义的颜色和字体变量 4. 包含版权信息。
全局组件规范

全局组件应该放在 website/global/ 目录下,所有页面通过 include 或引用的方式使用。确保只修改颜色变量,不改变结构和 ID。

实战完整工作流

本流程基于真实的 B2B 网站开发案例,展示了从原始业务资料到生成高转化全站代码的完整闭环。学员可直接参考此流程进行项目开发:

01

业务资料深度分析

将客户提供的原始业务手册交给 AI,提取公司核心信息、产品分类、目标受众及 SEO 关键词,为后续设计奠定基础。

You
Prompt 复制代码 我有一份业务文档《官方核心资料手册.md》。请帮我分析并提取:1. 公司核心信息 2. 产品分类 3. 目标受众 4. SEO 关键词。
02

可视化架构与树状系统

设计符合 B2B 采购逻辑的页面层级,并通过“树状系统”建立清晰的网站框架文件(WEBSITE_ARCHITECTURE.md)。

You
Prompt 复制代码 请先用树状系统给我列出网站框架。包含页面层级、SEO 关键词分配,并确保符合用户意图(信息型、商业型、交易型)。
03

视觉风格研究与设计系统

调研行业顶尖风格(如“大厂”或“奢侈品”风),确定配色方案与字体,并同步更新到项目规则(.trae/rules)中。

You
Prompt 复制代码 根据我们的产品,使用调研工具帮我查找符合我们网站的配色和字体,我们必须要“大厂”风格。确定后更新到项目规则中。
04

全局组件与物理目录生成

创建响应式的全局 Header/Footer,并利用文件操作工具一键生成全站所有的页面文件夹。

You
Prompt 复制代码 请帮我创建全局 Header 和 Footer,包含 Schema 标记,并帮我生成整个网站的页面文件夹。
05

AIDA 高转化内容创作

为每个页面编写完整的 Markdown 内容,严格遵循 AIDA 模型,并根据不同页面的用户意图(如解决方案页、产品页)进行差异化创作。

You
Prompt 复制代码 为所有页面编写 AIDA 框架内容。要求使用专业 B2B 语境,并针对 SEO 和 GEO(生成式引擎优化)进行内容增强。
06

转换规则与 SEO/GEO 深度优化

制定严格的转化规则(如一屏一询盘),并利用 SEO 技能进行最后的深度审计,确保内容能够被 AI 引擎(如 Perplexity/ChatGPT)高效抓取。

You
Prompt 复制代码 再次用 SEO 和 GEO 方向优化内容。每一个 Section 都必须有一个指向询盘的 Button,并把这个规则永久写入项目规则库。

对话流程全记录(对话示例)

以下是本次项目从 0 到 1 的核心对话流程,建议学员按照此节奏与 AI 沟通:

1. 资料分析与需求对齐

You
Prompt 复制代码 请认真阅读我的业务手册,开始为我设计网页框架。

2. 提取核心商业要素

You
Prompt 复制代码 请帮我提取:1. 公司核心信息 2. 产品分类 3. 目标受众 4. SEO 关键词。

3. 生成架构与树状系统

You
Prompt 复制代码 先用树状系统给我列出网站框架,并帮制作一个文件专门放置这个树状系统。

4. 针对性调整架构

You
Prompt 复制代码 移除原有的 Resources,加入一个“解决方案”页面针对我们的用户对象设计。再加入一个 Blog 页面。

5. 视觉调研与风格确认

You
Prompt 复制代码 查找符合我们网站的配色和字体,给我们例子,我们必须要“大牌”或者“大厂”风格。

6. 更新项目全局规则

You
Prompt 复制代码 把确定的配色和字体更新到规则去,但保持移动端的间距和按钮规则不要改变。

7. 全站内容生成与优化

You
Prompt 复制代码 帮我生成全部页面的 AIDA 框架和内容。再次调用 SEO/GEO 工具深入研究,确保每个 Section 都有且只有一个引导询盘的按钮。

常见问题

Q1: SKILL 和规则有什么区别?

A: SKILL 定义 AI 的专业能力和工作流程,而规则定义项目的编码标准和设计规范。SKILL 是"怎么做",规则是"做什么"。

Q2: 如何调试 SKILL 不生效的问题?

A: 检查以下几点:1. SKILL 文件是否在 .trae/skills/ 目录下 2. 文件名是否正确(SKILL.md) 3. YAML frontmatter 是否完整 4. 重新加载 Trae IDE。

Q3: 可以同时使用多个 SKILL 吗?

A: 可以。Trae 会根据任务类型自动选择合适的 SKILL。你也可以在对话中明确指定使用哪个 SKILL。

Q4: 如何确保 AI 生成的代码符合我的设计规范?

A: 创建详细的规则文件,包括颜色、字体、间距、组件规范等。AI 会自动读取这些规则并应用。

Q5: WordPress 连接失败怎么办?

A: 检查:1. .env 文件是否正确配置 2. 应用密码是否有效 3. WordPress REST API 是否启用 4. 网络连接是否正常。

Q6: 如何备份我的 SKILL 和规则?

A: 将 .trae/ 目录添加到 Git 仓库,定期提交。建议使用版本控制管理所有配置文件。

Q7: 可以分享 SKILL 给团队成员吗?

A: 可以。将 SKILL 文件夹复制到团队成员的 .trae/skills/ 目录即可。也可以通过 Git 共享。

Q8: 如何更新 SKILL?

A: 直接编辑 SKILL.md 文件,保存后 Trae 会自动重新加载。建议在更新前备份原文件。

Q9: 支持哪些编程语言?

A: Trae 支持所有主流编程语言,包括 HTML、CSS、JavaScript、Python、PHP、React、Vue 等。

Q10: 如何获取更多帮助?

A: 查看 Trae 官方文档、社区论坛,或联系技术支持团队。