Communitygithub.com

rizkydarm/ClusteringAIAgentsSkills-Python 网站构建

用于打造具有独特视觉风格、生产级质量的网站、落地页和交互式网页体验,并具备严谨的设计与QA规范。

ClusteringAIAgentsSkills-Python 网站构建 是什么?

该技能专为构建风格各异、具有独特视觉标识的生产级网站而设计。其核心原则是每个站点的视觉风格(包括字体、色彩、动效与布局)都必须源自其主题内容,并强制使用调色板生成器为每个项目创建独一无二的配色方案,严禁复用同一调色板。该技能涵盖了静态信息型网站、Web应用及浏览器游戏等多种项目类型,并提供了详细的类型路由指南来加载对应的专项指导文件。它还共享了通用的设计基础(如设计令牌、排版规则、布局与动效),并扩展了针对Web实现的CSS变量、响应式设计令牌及基础样式表。该技能支持Claude Code、Cursor、Codex、Copilot及Aider等主流AI编码助手平台,通过分步工作流、Playwright交互式QA测试、SVG Logo生成及全面的视觉QA流程,确保最终交付的网站具有专业的设计水准和可靠的质量。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rizkydarm/ClusteringAIAgentsSkills-Python/tree/HEAD/_skill/website-building

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

网站构建

构建风格独特、生产级质量的网站,每个站点看起来都截然不同。每一个选择——字体、颜色、动效、布局——都必须源自其主题。运行调色板生成器(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.mdSaaS产品、仪表盘、管理面板、电商、品牌体验
浏览器游戏read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md2D 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.mdTailwind CSS v3、shadcn/ui、现代CSS使用Tailwind时
shared/07-toolkit.mdCDN库、React、Three.js、图标、地图、SVG图案/滤镜、esm.sh选择库时
shared/10-charts-and-dataviz.mdChart.js、Recharts、D3、KPI、迷你图需要数据可视化时
shared/11-web-technologies.md框架版本、浏览器兼容性检查兼容性时
shared/12-playwright-interactive.md持久化Playwright浏览器QA、截图、视觉测试需要测试时
shared/19-backend.mdFastAPI/Express/Flask服务器、WebSocket、SSE、端口转发需要后端时
shared/20-llm-api.mdLLM/AI API集成参考站点使用AI API时

所有路径均相对于 skills/GENERAL-KNOWLEDGE-WORKER/website-building/。

† Web应用和仪表盘跳过——实现细节已在全栈模板中预配置。设计令牌和排版不可跳过——它们为所有项目类型提供了权威的设计系统默认值和字体选择指南。

领域特定文件 —— 加载一个

文件加载时机
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdSaaS、仪表盘、管理、电商、品牌体验(包含全栈模板的子技能)
webapp/dashboards.md仪表盘或数据密集型界面(webapp的配套文件)
informational/informational.md个人网站、作品集、编辑、小企业、落地页
game/game.md浏览器游戏、Three.js、WebGL、交互式3D
game/2d-canvas.md2D 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。永远不要使用样式化的文本标题来代替。

  1. 理解品牌 —— 目的、基调、一个定义词
  2. 直接编写SVG —— 几何形状、字体形式或抽象标记。一个令人难忘的形状。
  3. 原则: 几何/极简(Paul Rand、Vignelli风格)。在24px和200px下都能正常工作。先做单色——颜色作为增强。使用 currentColor 以支持暗/亮模式。
  4. 内联实现,包含 aria-label、viewBox、fill="none"、currentColor 描边
  5. 生成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

构建每个页面后:

  1. 通过Playwright在桌面端(1280px+)和移动端(375px)截图
  2. 批判性评估: 看起来是专业设计的(而非AI生成的)吗?排版是否独特?留白是否充足?是否有清晰的视觉层次?
  3. 在继续之前修复所有问题。 不留视觉债务。

阶段2:最终QA(发布前)

  1. 在桌面和移动端截取每个页面的截图
  2. 检查跨页面一致性(间距、颜色、字体处理)
  3. 验证暗色模式(至少为主页截取两种主题的截图)
  4. 检查交互状态:悬停、焦点、激活、加载、空、错误
  5. 冷启动第一印象测试:感觉精致且有意图吗?

QA失败项: 文本溢出、间距不一致、颜色偏离令牌、缺少暗色模式、移动端内容挤压、通用AI外观、占位内容、缺少Logo。


步骤1:艺术指导——先推断再提问,先提问再默认

每个站点都应具有源自其内容的视觉标识。不要直接跳到Kortix备用调色板。 Kortix调色板是在推断和提问都失败时的最后手段,而不是方便的默认选项。

  1. 从主题中推断。 咖啡烘焙商网站 → 大地色系棕色、暖奶油色、手绘感觉。金融科技仪表盘 → 冷色石板灰、尖锐无衬线字体、数据密集。儿童学习应用 → 明亮原色、圆角字体、俏皮动效。内容本身会在用户开口之前告诉您调色板、字体和间距。
  2. 检查艺术指导表格。 每个领域文件(informational.md、webapp/SKILL.md、game/game.md)都有一个艺术指导表格,将站点/产品类型映射到概念驱动的方向和令牌起点。将其用作跳板。
  3. 推导五大支柱: 色彩(暖/冷、从主题中提取强调色)、排版(衬线/无衬线、展示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/仅文字)。
  4. 如果主题确实模糊,请提问—— “您想要什么样的氛围?”和“有参考站点吗?”一个问题就够了。
  5. 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 启动预览或开发服务器。
  • 如果目标仓库已经有部署工作流,请使用该确切的工作流。
  • 如果没有既定的部署目标,则交付文件并提供经过验证的本地预览,而不是发明特定于平台的部署方式。

相关技能