网站构建
构建风格独特、生产级质量的网站,每个站点看起来都截然不同。每一个选择——字体、颜色、动效、布局——都必须源自其主题。运行调色板生成器(bun run shared/generate-palette.ts "关键词")为每个项目创建独一无二的配色方案。切勿在不同站点之间复用同一调色板。
此技能涵盖Web项目的所有内容。 根据项目类型,按需阅读本目录中的子文件。对于Web应用,还需阅读 skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md。
通用设计原则(色彩哲学、默认调色板、字体选择)通过 design-foundations 与其他技能共享。本技能的共享文件通过Web特定的实现(CSS变量、响应式令牌、基础样式表)扩展了这些基础。您无需单独加载 design-foundations——shared/ 中Web特定版本已足够全面。
使用 read 命令并指定完整路径,例如:skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md
项目类型路由
步骤1:识别项目类型并加载领域特定指南:
| 项目类型 | 操作 | 示例 |
|---|---|---|
| 信息型网站 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.md | 个人网站、作品集、编辑/博客、小企业、落地页 |
| Web应用 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS产品、仪表盘、管理面板、电商、品牌体验 |
| 浏览器游戏 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md | 2D Canvas游戏、Three.js/WebGL、HTML5游戏、交互式3D体验 |
步骤2:读取共享文件——首先读取 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md 和 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md(对于所有项目类型(包括Web应用)均为强制)。这些文件建立了全面适用的Kortix设计系统默认值和排版规则。对于Web应用和仪表盘,请跳过下方标记为 † 的文件——这些文件包含已在全栈模板中预配置的实现细节。
如果用户只说“网站”或“站点”但没有提供细节,请询问具体类型,或者默认为信息型。
子文件参考
共享文件 (shared/) —— 每个项目
| 文件 | 涵盖内容 | 加载 |
|---|---|---|
shared/01-design-tokens.md | 字体比例、间距、Kortix调色板、base.css | 始终 |
shared/02-typography.md | 字体选择、配对、加载、黑名单 | 始终 |
shared/04-layout.md | 空间构图、响应式、移动优先 | 始终 † |
shared/05-taste.md | 骨架屏加载器、空/错误状态、打磨 | 始终 |
shared/08-standards.md | 可访问性、性能、反模式 | 始终 |
shared/09-technical.md | 项目结构、沙盒、部署、检查清单 | 始终 † |
shared/head-defaults.html | <head> 的归属块 | 始终 † |
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/AI API集成参考 | 站点使用AI API时 |
所有路径均相对于 skills/GENERAL-KNOWLEDGE-WORKER/website-building/。
† Web应用和仪表盘跳过——实现细节已在全栈模板中预配置。设计令牌和排版不可跳过——它们为所有项目类型提供了权威的设计系统默认值和字体选择指南。
领域特定文件 —— 加载一个
| 文件 | 加载时机 |
|---|---|
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS、仪表盘、管理、电商、品牌体验(包含全栈模板的子技能) |
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: 阅读 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md 了解如何配合Playwright进行持久化浏览器自动化(截图、功能测试、视觉QA)。游戏测试必须使用,任何复杂站点都推荐使用。
工作流
步骤0:加载所有强制文件(请先执行此操作,可并行)
一次性读取所有以下文件——每个项目都必须执行:
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/04-layout.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/05-taste.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md")
然后从下面的步骤1加载领域特定文件(信息型、Web应用或游戏)。
步骤1:生成独一无二的调色板
使用描述主题的关键词运行调色板生成器:
bun run skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/generate-palette.ts "subject keywords here"
选择最和谐的配色方案,如有需要可自定义。
步骤2:设计与构建
使用生成的调色板构建网站,并遵循所有已加载的设计指南。
步骤3:预览
通过静态服务器展示:show(type: "url", url: "http://localhost:3211/open?path=/workspace/project/index.html")
使用所有工具
- 先做研究。 在设计之前,先搜索网络上的参考站点、趋势和竞品示例。浏览特定站点类型的获奖实例。获取用户提供的任何URL。
- 大方地生成真实资产。 为主图、章节插图、编辑功能图、氛围背景生成图片——而不仅仅是一张主图。每个长页面都应有视觉节奏感,并匹配网站的视觉方向。不要使用占位符。 为每个项目生成自定义SVG Logo(见下文)——除非用户特别要求SVG输出,否则SVG仅用于Logo。保存能指导方向的网络参考图片。
- 通过Playwright截图。 阅读
skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md,在桌面(1280px+)和移动端(375px)下截图。与参考图对比。这是强制要求,不是可选项。请参见下文视觉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测试流程
每次部署都必须通过视觉QA。截图是质量关卡。
阅读 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md 了解所有视觉QA。Playwright提供了持久化的浏览器会话,用于截图、交互测试和视口验证。
循环: 构建 → Playwright QA → 评估 → 修复 → 重复 → 准备就绪时部署
阶段1:逐页QA
构建每个页面后:
- 通过Playwright在桌面端(1280px+)和移动端(375px)截图
- 批判性评估: 看起来是专业设计的(而非AI生成的)吗?排版是否独特?留白是否充足?是否有清晰的视觉层次?
- 在继续之前修复所有问题。 不留视觉债务。
阶段2:最终QA(发布前)
- 在桌面和移动端截取每个页面的截图
- 检查跨页面一致性(间距、颜色、字体处理)
- 验证暗色模式(至少为主页截取两种主题的截图)
- 检查交互状态:悬停、焦点、激活、加载、空、错误
- 冷启动第一印象测试:感觉精致且有意图吗?
QA失败项: 文本溢出、间距不一致、颜色偏离令牌、缺少暗色模式、移动端内容挤压、通用AI外观、占位内容、缺少Logo。
步骤1:艺术指导——先推断再提问,先提问再默认
每个站点都应具有源自其内容的视觉标识。不要直接跳到Kortix备用调色板。 Kortix调色板是在推断和提问都失败时的最后手段,而不是方便的默认选项。
- 从主题中推断。 咖啡烘焙商网站 → 大地色系棕色、暖奶油色、手绘感觉。金融科技仪表盘 → 冷色石板灰、尖锐无衬线字体、数据密集。儿童学习应用 → 明亮原色、圆角字体、俏皮动效。内容本身会在用户开口之前告诉您调色板、字体和间距。
- 检查艺术指导表格。 每个领域文件(
informational.md、webapp/SKILL.md、game/game.md)都有一个艺术指导表格,将站点/产品类型映射到概念驱动的方向和令牌起点。将其用作跳板。 - 推导五大支柱: 色彩(暖/冷、从主题中提取强调色)、排版(衬线/无衬线、展示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/仅文字)。
- 如果主题确实模糊,请提问—— “您想要什么样的氛围?”和“有参考站点吗?”一个问题就够了。
- Kortix备用——仅当推断和提问都无果时。 如果用户已被提问但没有给出方向,且主题也没有提供明确信号,则回退到Kortix/瑞士风格默认值。
备用方案:干净与瑞士风格(最后手段)
当推断未产生明确方向,且用户已被提问但未提供风格指导时,使用 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md 中的默认值,并遵循:
- 排版: Satoshi 或 General Sans 正文(优先使用Fontshare),或者Inter/DM Sans。权重对比优于字体对比。 最多3-4种字号。保持文本紧凑——
--text-3xl/--text-hero仅用于信息型网站的主屏。 - 色彩: Kortix调色板。中性表面 + 一个青色强调色(仅用于行为召唤按钮)。
- 布局: 网格对齐。慷慨的边距。在有趣的地方使用不对称。
- 动效: 极简、功能性。仅使用流畅的状态转换。
- 图像: 生成干净、相关的视觉元素。无库存照片。
艺术指导——避免AI美学
请参阅 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md 获取完整的反模式列表。
步骤2:发布
首先使用真实的本地预览命令,并且仅使用目标项目实际的部署工作流进行发布。请参阅 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/09-technical.md 了解推荐的预览和交付流程。
交付
- 始终先在本地验证站点。
- 使用
pty_spawn启动预览或开发服务器。 - 如果目标仓库已经有部署工作流,请使用该确切的工作流。
- 如果没有既定的部署目标,则交付文件并提供经过验证的本地预览,而不是发明特定于平台的部署方式。