网站构建
构建独具特色、生产级别的网站,避免常见的“AI 泛滥”审美。每个选择——字体、色彩、动效、布局——都必须经过深思熟虑。部署为静态 HTML/CSS/JS 包到 S3。
此技能涵盖 Web 项目的所有内容。 当通过 load_skill("website-building") 加载时,所有文件都会被复制到 workspace/。根据你的项目类型按需读取子文件。对于 Web 应用,请加载子技能:load_skill("website-building/webapp")。
通用设计原则(色彩哲学、默认调色板、字体选择)通过 design-foundations 与其他技能共享。此技能的共享文件通过特定于 Web 的实现(CSS 变量、响应式令牌、基础样式表)扩展了这些基础。你无需单独加载 design-foundations——shared/ 中的 Web 特定版本已经足够全面。
请使用完整路径进行 read 操作,例如 shared/01-design-tokens.md
项目类型路由
步骤 1:识别项目类型并加载领域特定的指导:
| 项目类型 | 操作 | 示例 |
|---|---|---|
| 信息型网站 | read informational/informational.md | 个人网站、作品集、社论/博客、小型企业、落地页 |
| Web 应用 | load_skill("website-building/webapp") | SaaS 产品、仪表盘、管理面板、电子商务、品牌体验 |
| 浏览器游戏 | read game/game.md + game/game-testing.md | 2D Canvas 游戏、Three.js/WebGL、HTML5 游戏、互动式 3D 体验 |
步骤 2:读取共享文件——首先读取 shared/01-design-tokens.md 和 shared/02-typography.md(所有项目类型,包括 Web 应用,都必须读取)。这些文件确立了 Nexus 设计系统的默认值和适用于所有项目的排版规则。对于 Web 应用和仪表盘,请跳过下面标有 † 的文件——这些文件包含已在全栈模板中预配置的实现细节。
如果用户只说“网站”或“站点”而没有提供任何细节,请询问类型或默认为信息型。
子文件参考
共享 (shared/) —— 每个项目
| 文件 | 覆盖内容 | 加载 |
|---|---|---|
shared/01-design-tokens.md | 字号、间距、Nexus 调色板、base.css | 始终加载 |
shared/02-typography.md | 字体选择、搭配、加载、黑名单 | 始终加载 |
shared/04-layout.md | 空间构成、响应式、移动优先 | 始终加载 † |
shared/05-taste.md | 骨架加载器、空/错误状态、打磨 | 始终加载 |
shared/08-standards.md | 无障碍、性能、反模式 | 始终加载 |
shared/09-technical.md | 项目结构、沙箱、部署、检查清单 | 始终加载 † |
shared/03-motion.md | 滚动动画、Motion 库、GSAP SVG 插件、悬停/光标 | 需要动画时加载 |
shared/06-css-and-tailwind.md | Tailwind CSS v3、shadcn/ui、现代 CSS | 使用 Tailwind 时加载 |
shared/07-toolkit.md | CDN 库、React、Three.js、图标、地图、SVG 图案/滤镜、esm.sh | 选择库时加载 |
shared/10-charts-and-dataviz.md | Chart.js、Recharts、D3、KPI、迷你图 | 需要数据可视化时加载 |
shared/11-web-technologies.md | 框架版本、浏览器兼容性 | 检查兼容性时加载 |
shared/12-playwright-interactive.md | 持久性 Playwright 浏览器 QA、截图、视觉测试 | 需要测试时加载 |
shared/19-backend.md | FastAPI/Express/Flask 服务器、WebSocket、SSE、端口转发 | 需要后端时加载 |
shared/20-llm-api.md | LLM 聊天、图像/视频/音频生成、转录——模型、凭证、SDK 助手 | 网站使用 AI/LLM API 时加载 |
所有路径均相对于 ``。
† 对于 Web 应用和仪表盘跳过 —— 实现细节已在全栈模板中预配置。设计令牌和排版不会被跳过——它们为所有项目类型提供权威的设计系统默认值和字体选择指导。
领域特定 —— 加载其中一个
| 文件 | 何时加载 |
|---|---|
load_skill("website-building/webapp") | SaaS、仪表盘、管理后台、电子商务、品牌体验(包含全栈模板的子技能) |
skills/website-building/webapp/dashboards.md | 仪表盘或数据密集界面(与 webapp 配合使用) |
informational/informational.md | 个人网站、作品集、社论、小型企业、落地页 |
game/game.md | 浏览器游戏、Three.js、WebGL、互动式 3D |
game/2d-canvas.md | 2D Canvas 游戏(与 game.md 配合使用) |
game/game-testing.md | 任何浏览器游戏——与 game.md 一起加载 |
交互式 QA: 读取 shared/12-playwright-interactive.md 以获取使用 Playwright 的持久浏览器自动化(截图、功能测试、视觉 QA)。游戏测试必备,对任何复杂网站都很有用。
工作流程
- 设计方向:明确用途,选择审美方向
- 版本控制:搭建后,在项目目录中运行
git init。在每个主要里程碑后,用简短信息提交更改。 - 构建:逐页构建网站,通过 Playwright 截图进行视觉 QA
- 发布:提交所有更改,然后
deploy_website()返回公共 URL
使用每一个工具
- 先做研究。 在设计之前,先在网络上搜索参考网站、趋势和竞品示例。浏览特定网站类型的获奖范例。获取用户提供的任何 URL。
- 慷慨生成真实资产。 为 Hero 区域、章节插图、社论特色视觉、氛围背景生成图像——不仅仅是一个 Hero 图像。每个长页面都应有视觉节奏,并且生成的图像要与网站的艺术方向相匹配。不要使用占位符。为每个项目生成一个自定义 SVG Logo(见下文)—— SVG 仅用于 Logo,除非用户特别要求 SVG 输出。保存用于指导方向的 Web 参考图像。
- 通过 Playwright 截图(仅限复杂网站)。 对于多页面网站、Web 应用、仪表盘和游戏,请读取
skills/website-building/shared/12-playwright-interactive.md以在桌面(1280px+)和移动端(375px)进行截图。对于简单的单页静态网站,跳过 Playwright——请参见下面的视觉 QA。 - 直接编写生产级代码。 HTML、CSS、JS、SVG。对构建工具和文件处理使用 bash。
SVG Logo 生成
每个项目都获得一个自定义的内联 SVG Logo。永远不要用样式化的文本标题替代。
- 理解品牌 —— 目的、基调、一个定义性的词
- 直接编写 SVG —— 几何形状、字母形式或抽象标记。一个令人难忘的形状。
- 原则: 几何/极简(Paul Rand、Vignelli)。在 24px 和 200px 下都能正常工作。先单色——再添加颜色作为增强。使用
currentColor适配深色/浅色模式。 - 内联实现,包含
aria-label、viewBox、fill="none"、currentColor描边 - 生成一个 favicon —— 如果需要,简化为 32x32 版本
关于 SVG 动画(DrawSVG、MorphSVG),请参见 shared/03-motion.md。关于 SVG 图案/滤镜,请参见 shared/07-toolkit.md。
视觉 QA 测试流程
何时使用 Playwright QA
简单网站跳过 Playwright。 单页静态网站不需要 Playwright 截图。直接审查代码,然后部署。Playwright QA 会增加大量时间,对于简单的静态内容来说不值得。
对复杂网站使用 Playwright。 多页面网站、Web 应用、仪表盘、游戏以及任何具有交互功能(表单、购物车、筛选器、图表、拖放)的网站必须使用 Playwright QA。读取 skills/website-building/shared/12-playwright-interactive.md 以获取持久浏览器自动化。
Playwright QA 流程(仅限复杂网站)
循环: 构建 → Playwright QA → 评估 → 修复 → 重复 → 准备就绪后部署
阶段 1:逐页 QA
构建每个页面后:
- 通过 Playwright 在桌面(1280px+)和移动端(375px)截图
- 批判性评估: 它看起来是专业设计的(而不是 AI 生成的)吗?排版有特色吗?空白空间慷慨吗?是否有清晰的视觉层次?
- 在继续之前修复所有问题。 不留视觉债务。
阶段 2:最终 QA(发布前)
- 在桌面和移动端截图每个页面
- 检查跨页面的一致性(间距、颜色、排版处理)
- 验证深色模式(至少为首页截图两种主题)
- 检查交互状态:悬停、焦点、激活、加载、空状态、错误状态
- 冷启动第一印象测试: 它给人的感觉是精致且经过深思熟虑的吗?
QA 失败项: 文本溢出、间距不一致、非令牌颜色、缺少深色模式、移动端被压缩、看起来像通用 AI、存在占位内容、缺少 Logo。
步骤 1:艺术方向——先推断,再询问,最后回退
每个网站都应该有一个从内容推导出的视觉身份。不要直接跳到 Nexus 备用调色板。 Nexus 调色板是在推断和询问都已失败时的最后手段,而不是一个方便的默认选项。
- 从主题推断。 一个咖啡烘焙商网站 → 大地色系的棕色、暖奶油色、手绘感。一个金融科技仪表盘 → 冷石板色、锐利无衬线字体、数据密集。一个儿童学习应用 → 明亮原色、圆润字体、俏皮动效。内容本身会在用户开口之前告诉你调色板、排版和间距。
- 检查艺术方向表格。 每个领域文件(
informational.md、webapp/SKILL.md、game/game.md)都有一个艺术方向表,将网站/产品类型映射到概念驱动的方向和令牌起点。将这些作为出发点。 - 推导五大支柱: 色彩(暖/冷、从主题中提取强调色)、排版(衬线/无衬线、显示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/纯文本)。
- 如果主题确实不明确,就询问 —— “你想要什么氛围?”以及“有参考网站吗?”问一个问题就足够了。
- Nexus 备用 —— 仅在推断和询问都无果时使用。 如果已经询问过用户但没有得到方向,并且主题内容也没有给出明确的信号,那么就回退到 Nexus/Swiss 默认值。
备用方案:简洁 & Swiss(最后手段)
当推断没有给出明确方向,并且询问用户后也没有得到风格指导时,请使用 shared/01-design-tokens.md 中的默认值,并遵循以下原则:
- 排版: Satoshi 或 General Sans 正文(Fontshare —— 首选),或 Inter/DM Sans。强调字重对比而不是字体对比。最多 3-4 种大小。保持文本紧凑——
--text-3xl/--text-hero仅用于信息型网站的 Hero 区域。 - 色彩: Nexus 调色板。中性表面 + 一个仅用于 CTA 的青色强调色。
- 布局: 网格对齐。宽边距。在有趣的地方使用不对称。
- 动效: 极简、功能性的。仅使用平滑的状态过渡。
- 图像: 生成干净、相关的视觉元素。不要用图库照片。
艺术方向——避免 AI 审美
完整的反模式列表请参见 shared/08-standards.md。
步骤 2:发布
调用 deploy_website(),传入项目路径和网站名称。返回一个公共 S3 URL。若要更新,请编辑本地文件并使用相同路径重新部署。具体的调用方式和示例请参见 shared/09-technical.md。