Communitygithub.com

sandbox-safemode/365-castle-logos

构建独具特色、生产级别的网站,避免常见的“AI 泛滥”审美。每个选择——字体、色彩、动效、布局——都必须经过深思熟虑。部署为静态 HTML/CSS/JS 包到 S3。

365-castle-logos 是什么?

该技能(skill)旨在指导 AI 智能体构建具有独特视觉风格、避免“AI 生成感”的生产级网站。它强调每个设计决策——从字体、颜色、动效到布局——都必须是有意为之,并最终部署为静态 HTML/CSS/JS 文件到 S3。技能文档提供了一个全面的系统,包括共享的设计基础(如设计令牌和排版指南),以及针对信息型网站、Web 应用和浏览器游戏等不同项目类型的特定指导。工作流程从确定设计方向、使用 Git 进行版本控制开始,然后进行页面构建,并通过 Playwright 进行可视化 QA 测试,最后通过 `deploy_website()` 函数发布。该技能的核心原则是避免使用默认的 AI 风格,倡导先从内容中推导出视觉方向,仅在没有明确信号时才回退到 Nexus 调色板。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

在你喜欢的 AI 中提问

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

文档

网站构建

构建独具特色、生产级别的网站,避免常见的“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.md2D 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.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 聊天、图像/视频/音频生成、转录——模型、凭证、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.md2D Canvas 游戏(与 game.md 配合使用)
game/game-testing.md任何浏览器游戏——与 game.md 一起加载

交互式 QA: 读取 shared/12-playwright-interactive.md 以获取使用 Playwright 的持久浏览器自动化(截图、功能测试、视觉 QA)。游戏测试必备,对任何复杂网站都很有用。


工作流程

  1. 设计方向:明确用途,选择审美方向
  2. 版本控制:搭建后,在项目目录中运行 git init。在每个主要里程碑后,用简短信息提交更改。
  3. 构建:逐页构建网站,通过 Playwright 截图进行视觉 QA
  4. 发布:提交所有更改,然后 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。永远不要用样式化的文本标题替代。

  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 测试流程

何时使用 Playwright QA

简单网站跳过 Playwright。 单页静态网站不需要 Playwright 截图。直接审查代码,然后部署。Playwright QA 会增加大量时间,对于简单的静态内容来说不值得。

对复杂网站使用 Playwright。 多页面网站、Web 应用、仪表盘、游戏以及任何具有交互功能(表单、购物车、筛选器、图表、拖放)的网站必须使用 Playwright QA。读取 skills/website-building/shared/12-playwright-interactive.md 以获取持久浏览器自动化。

Playwright QA 流程(仅限复杂网站)

循环: 构建 → Playwright QA → 评估 → 修复 → 重复 → 准备就绪后部署

阶段 1:逐页 QA

构建每个页面后:

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

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

  1. 在桌面和移动端截图每个页面
  2. 检查跨页面的一致性(间距、颜色、排版处理)
  3. 验证深色模式(至少为首页截图两种主题)
  4. 检查交互状态:悬停、焦点、激活、加载、空状态、错误状态
  5. 冷启动第一印象测试: 它给人的感觉是精致且经过深思熟虑的吗?

QA 失败项: 文本溢出、间距不一致、非令牌颜色、缺少深色模式、移动端被压缩、看起来像通用 AI、存在占位内容、缺少 Logo。


步骤 1:艺术方向——先推断,再询问,最后回退

每个网站都应该有一个从内容推导出的视觉身份。不要直接跳到 Nexus 备用调色板。 Nexus 调色板是在推断和询问都已失败时的最后手段,而不是一个方便的默认选项。

  1. 从主题推断。 一个咖啡烘焙商网站 → 大地色系的棕色、暖奶油色、手绘感。一个金融科技仪表盘 → 冷石板色、锐利无衬线字体、数据密集。一个儿童学习应用 → 明亮原色、圆润字体、俏皮动效。内容本身会在用户开口之前告诉你调色板、排版和间距。
  2. 检查艺术方向表格。 每个领域文件(informational.md、webapp/SKILL.md、game/game.md)都有一个艺术方向表,将网站/产品类型映射到概念驱动的方向和令牌起点。将这些作为出发点。
  3. 推导五大支柱: 色彩(暖/冷、从主题中提取强调色)、排版(衬线/无衬线、显示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/纯文本)。
  4. 如果主题确实不明确,就询问 —— “你想要什么氛围?”以及“有参考网站吗?”问一个问题就足够了。
  5. 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。

相关技能