网站架构设计完整教程
从零开始,教你如何使用 Trae 创建自定义 SKILL、配置规则、绑定 WordPress,并建立完整的设计系统。小白也能轻松上手!
教程概览
🧠 创建 SKILL
定义 AI 的专业能力,让 Trae 按照你的工作流程执行任务。
📋 创建规则
建立项目规范,确保 AI 生成的代码符合你的设计标准。
🔗 绑定 WordPress
配置 WP 环境变量,让 AI 能够直接操作你的网站。
🎨 设计系统
定义颜色、字体、全局组件,建立统一的视觉语言。
完成本教程后,你将能够:创建自定义 SKILL、配置项目规则、绑定 WordPress、建立设计系统,并通过对话让 AI 自动生成符合规范的网站代码。
第一步:创建 SKILL
SKILL 是 Trae 的"插件系统",你可以定义 AI 的专业能力、工作流程和输出格式。创建 SKILL 后,AI 会自动按照你定义的规则执行任务。
SKILL 文件结构
每个 SKILL 都是一个独立的文件夹,包含一个 SKILL.md 文件。文件使用 Markdown 格式,包含以下部分:
---
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 风格的产品描述:
SKILL 文件必须放在 .trae/skills/ 目录下,Trae 才能识别。建议每个 SKILL 单独一个文件夹,便于管理。
SKILL 目录结构示例
.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 策略)
创建颜色系统规则
让我们创建一个颜色系统规则文件:
规则文件示例
# 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 后,AI 可以直接读取你的网站数据、上传图片、创建页面,实现真正的自动化开发流程。
创建环境变量文件
在项目根目录创建 .env 文件,存储 WordPress 连接信息:
# 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 凭证
登录 WordPress 后台
访问 https://your-site.com/wp-admin 并登录
生成应用密码
进入 用户 → 个人资料,滚动到"应用密码"部分,点击"创建新应用密码"
复制密码到 .env
将生成的密码复制到 .env 文件的 WP_PASSWORD 字段
不要使用你的 WordPress 登录密码!必须使用应用密码。应用密码可以随时撤销,更加安全。同时,.env 文件应该添加到 .gitignore,避免泄露。
测试 WordPress 连接
第四步:设定颜色系统
统一的颜色系统确保品牌一致性,提高开发效率,便于主题切换(如深色模式)。
定义颜色变量
在规则文件中定义完整的颜色系统:
: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;
}
深色模式支持
[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 使用你的颜色系统
第五步:设定字体系统
统一的字体系统提升可读性,建立品牌识别,确保跨平台一致性。
定义字体变量
: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
<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)在所有页面共享,确保导航一致性,减少重复代码,便于统一维护。
全局组件目录结构
website/
├── global/
│ ├── header.html
│ ├── footer.html
│ └── styles.css
└── pages/
├── home/
├── about/
└── contact/
创建全局 Header
创建全局 Footer
全局组件应该放在 website/global/ 目录下,所有页面通过 include 或引用的方式使用。确保只修改颜色变量,不改变结构和 ID。
实战完整工作流
本流程基于真实的 B2B 网站开发案例,展示了从原始业务资料到生成高转化全站代码的完整闭环。学员可直接参考此流程进行项目开发:
业务资料深度分析
将客户提供的原始业务手册交给 AI,提取公司核心信息、产品分类、目标受众及 SEO 关键词,为后续设计奠定基础。
可视化架构与树状系统
设计符合 B2B 采购逻辑的页面层级,并通过“树状系统”建立清晰的网站框架文件(WEBSITE_ARCHITECTURE.md)。
视觉风格研究与设计系统
调研行业顶尖风格(如“大厂”或“奢侈品”风),确定配色方案与字体,并同步更新到项目规则(.trae/rules)中。
全局组件与物理目录生成
创建响应式的全局 Header/Footer,并利用文件操作工具一键生成全站所有的页面文件夹。
AIDA 高转化内容创作
为每个页面编写完整的 Markdown 内容,严格遵循 AIDA 模型,并根据不同页面的用户意图(如解决方案页、产品页)进行差异化创作。
转换规则与 SEO/GEO 深度优化
制定严格的转化规则(如一屏一询盘),并利用 SEO 技能进行最后的深度审计,确保内容能够被 AI 引擎(如 Perplexity/ChatGPT)高效抓取。
对话流程全记录(对话示例)
以下是本次项目从 0 到 1 的核心对话流程,建议学员按照此节奏与 AI 沟通:
1. 资料分析与需求对齐
2. 提取核心商业要素
3. 生成架构与树状系统
4. 针对性调整架构
5. 视觉调研与风格确认
6. 更新项目全局规则
7. 全站内容生成与优化
常见问题
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 官方文档、社区论坛,或联系技术支持团队。