Sitecraft · 官网设计

触发与显式调用

• 用户请求出现 静态官网、企业官网、静态网页、纯静态、官网 任一关键词时，优先加载本技能并将相关规范用于当前任务；不要求同时出现“设计”“高级感”等其他词。
• 用户说 “使用官网设计”“用官网设计这个 skill”“使用 Sitecraft”“使用 sitecraft”，或显式提及 $sitecraft 时，直接使用本技能，无需再确认是否启用。仅说“使用该 skill”且上下文清楚指向本技能时，同样按显式调用处理。
• 加载技能不扩大任务：如果用户只是查询官网资料、询问实现方式或讨论技能，只处理该问题；不能因为出现关键词就自行创建网站、打包或发布。
• 这是给模型的选择指引，不是代码层的关键词拦截器；实际自动选择由宿主及模型完成。要明确指定时使用 $sitecraft 或技能选择器。

让页面具有与内容相称的视觉语言，并把实现打磨到可交付。审美来自内容、构图、素材和细节共同成立；“高级”不是某一种配色、字体或特效。 这是通用方法，不携带特定用户、品牌、行业的个人偏好。

面向纯静态网页及静态导出：成品不依赖常驻 Node 服务或数据库；本地开发与构建可以使用工具。好看、轻量、打开快、可直接部署共同构成交付标准。

一句话到完整 HTML

默认目标：用户只需一句业务描述，就得到精美、完整、可运行的官网 HTML。 对“做一个宠物洗美门店官网”这类请求，执行者自行完成内容组织、视觉方向、素材处理、响应式、动效与验证，并直接交付代码成品。不要停在设计建议、提示词、页面骨架或等待用户选风格的阶段。

• 先使用当前对话及项目材料补足信息。缺少配色、字体、栏目、品牌名或参考图时作合理默认，不要求用户填写简报、提供参考或先审方案；设计依据与检查记录主要供内部执行，只向用户简短说明有影响的假设。
• 没有真实品牌资料时可暂拟名称并使用可辨认的演示内容，在交付说明标明；不冒充真实客户、资质、评价、价格、地址或联系方式。不因缺少这些资料停止制作，也不用大量“待补充”占位框交付半成品。
• 默认产出静态 HTML/CSS/必要 JS。适合单文件时交付完整 index.html；有图片等资源时交付入口与优化后的本地资源，保持路径可用。单文件不是把大图强塞进 Base64 的理由；用户明确要求单文件时遵从并控制体积。
• 构图判断、首屏检查、修改与复查由执行者连续完成，不逐步向用户求批。只有关键意图确实无法从一句话和上下文判断、会做错对象或必要授权缺失时才询问；普通设计偏好缺省不阻塞。
• 用户只要局部修改、方案讨论或代码片段时按实际范围完成；本目标不授权额外建站、发布或采购。

按任务读取

• 新建或整体重做：读 design-playbook.md 与 visual-selection.md。新品牌先实际查看相关外部作品；内置实图在 visual-benchmarks.md，用户反馈与反例在 visual-cases.md。方向有实质分歧时渲染少量首屏小样，与适合任务的参考一同比较后再扩展整站。
• 新建或整体重做官网默认采用沉浸式表达：读 immersive-experiences.md，把主题、观看顺序、文字和操作共同设计；用户明确的其他方向、忠实复刻与局部修改按其范围执行。
• 局部优化：先读现有页面、样式、素材和实际截图，保留成立的视觉系统，只修问题。
• 新建官网、优化动态体验或页面含交互控件时：读 motion-and-controls.md，分别设计并验收场景 Motion、连续转场、光影；下拉选择需明确原生或自定义策略。
• 实现后：读 visual-review.md，执行截图检查与必要交互验证。
• 交付或发布静态成品：必须读 static-release.md，完成图片优化、发布构建、部署包检查和首页性能测量。运行其中的可执行检查器并保存报告；格式或构建通过不能代替发布验收。

尊重用户指定的设计、参考和技术栈。已有项目沿用组件与令牌；纯静态任务通常用 HTML/CSS 和必要的 JS，视觉精致不要求添加框架。只交设计稿的任务不擅自建站。其他已要求的工具或工作流照常使用，本技能补充视觉判断。

1. 形成可执行的视觉判断

从一句话及已有材料内部提炼五项，缺省自行判断，不必逐项询问：

1. 谁访问，首先需要理解什么，主要动作是什么。
2. 有哪些真实内容与素材；哪些事实缺失。
3. 页面应给人的感受，用两三个有区分度的词描述。
4. 一个视觉概念：具体用什么构图、物体、影像或排字来表达内容。
5. 排版、色彩、留白、材质与动效如何共同支持该概念。

“现代、简约、高级”还不是方向。把它变成可见的决定，例如“真实建筑摄影主导、窄幅项目索引、图注对齐、极少装饰”。有参考图就看图，分析层级、比例、素材和节奏；不要只抄颜色。用户要求复刻时优先忠实度，不另起风格。

按 visual-selection.md 把方案选择建立在实际参考与渲染上。分别判断任务清晰度和视觉完成度；对照参考的素材、尺度与排字，也识别近期页面中未经业务支持的命名、文案与外观重复。不能仅在两份相似的 AI 小样中选较整齐者；已有明确系统则直接落实。执行者自行取舍，只有用户要求比较方案时才展示选项，不设置例行审批关卡。

动工前留下简短设计依据：页面的主要任务、可用内容的特征，以及由此产生的具体构图和素材取舍。只有配色、圆角、风格形容词或口号不算依据。优先沿用用户给定的参考与已成立的系统；没有参考也能基于内容自行设计，不编造看过的案例，不默认增加素材采购或生图步骤。

品牌视觉单独验收：底色与强调色、字标/字体、标题文案与构图、主视觉必须来自同一个具体概念。按 design-playbook.md 的品牌依据与去图检查，确认不是“通用界面换一张行业图片”。素材漂亮、Motion 完整、排版整齐都不能替代品牌辨识度；不把某种颜色、四角星或字体列为全局禁用项，也不为辨识度推翻用户明确的 CI。

默认沉浸式，风格由主题决定：新建或整体重做官网无需用户再次要求“沉浸式”，直接设计能进入主题的空间、产品、作品或观看过程；配色、字体、素材、光线、信息密度与构图依当前内容决定。可组合编辑策展、产品演示、服务证据与直接操作，不把最近一次成品的暗色、宋体、全屏插画或章节数固化。主题不是行业模板映射，沉浸也不要求每一区块满屏。沿用用户明确的其他方向、忠实复刻与局部修改范围；自行完成设计，不增加选风格问卷。具体选择方法见 design-playbook.md。

静态 HTML 是实现形式，不代表所有项目都该做成宣传落地页。搜索、挑图、导航、下载等任务应在首屏出现可用的核心内容和入口；策展、品牌叙事可以大图主导，但需有对应内容和清楚的后续动作。沉浸体验与直接操作可以共存，不能为了气氛隐藏关键业务信息。

2. 按内容组织页面

• 先写真实信息的结构，再选择布局。官网、作品集与一屏工具页不必拥有同一组栏目。
• 首屏需要清楚的主次和一个主要动作。主视觉可以是照片、品牌插画、产品实景、可用演示或有力度的排字，不强制“左文右图”。
• 每个区块有明确目的；根据阅读关系选择通栏图、列表、图文、细节放大或卡片。不要把所有内容塞进等大的圆角框。
• 素材少就精简页面或用真实内容做原创图形，不为凑长度编造用户数、客户 Logo、评价、奖项、产品和联系方式。概念产品或演示内容必须可辨认。
• 文字多时通过标题、摘要、图解、图注和图文节奏处理，不把长文简单切成更多盒子。

3. 做出一致而具体的实现

• 建立少量 CSS 令牌：语义色、字体层级、内容宽度、间距、圆角、边框与阴影。具体数值由内容和风格决定，不把某套令牌套遍所有品牌。
• 中文优先检查真实中文字体、行高、标点、长标题换行；不能拿英文标题效果代替中文排版。正文和次要信息仍须清晰，不能靠缩小、降透明度制造精致。
• 按钮、输入框和菜单统一基线、内边距、图标尺寸与状态。每种表面上的控件显式检查文字/图标前景色，不能假定继承色一定适合按钮底色。
• 默认不新增 Emoji 作为 UI 图标、标题装饰、按钮内容或视觉素材。 使用一致的 SVG 或项目图标系统；只有用户明确指定 Emoji 风格时例外。不删改用户提供的原文、引用或用户生成内容；普通文字标点、箭头与数学符号不等同于 Emoji。
• 渐变、毛玻璃、3D、大圆角、英文小标签按页面需要选用，不把它们当作缺少设计判断时的填充物。
• 素材保持同一世界观、光线、裁切逻辑与质量。图片承载图像，正文和按钮保留真实 DOM；不把整页截图贴成网站。需原创位图且有生图工具时按可用图像技能执行；无工具仍可用排字、真实素材与代码图形完成。
• 新建或整体重做官网默认设计三项独立的动态体验：与内容相关、可感知的场景 Motion；实际内容/布局/浮层的连续转场；与材质或场景相符的光影变化。 自行决定表达与强度，不要求用户补充专业提示词；局部修改按范围执行。用户已明确要求的 Motion、丝滑转场、动态光影在后续一句话任务中继续有效，不能降级成“按需”，也不能用一种效果代替另外两项。具体契约和例外见 motion-and-controls.md。
• 按当前页面定义触发、时间、缓动、进出场和中断行为。静态插画的阳光、静态渐变与投影不算动态光影；按钮 hover 和小弹窗不代表场景 Motion；直接隐藏/显示不算连续转场。平面风格可以不用阴影，粒子、3D 与具体库仍按需选择。用户要求无动画或减少动态效果时优先尊重，保留静态可读内容与明确反馈。
• 控件不能只验收收起态或默认态。 对实际存在的悬停、按下、键盘聚焦、展开、选中、禁用、错误与加载状态逐项设计和检查；不存在的业务状态不为凑清单新增。焦点色、选中底色和浮层材质使用当前品牌的语义令牌。
• 保持技术与视觉投入相称：不为普通 hover 引入重型库；首屏图像正确压缩，非首屏延迟加载，字体与可选特效不阻塞主要内容。

4. 手机端重新构图

手机不是桌面等比缩小。重新决定内容顺序、主图裁切、标题换行、导航形式与操作位置；移除无意义的装饰空间，不移除必要信息。长页允许自然滚动，一屏布局仅用于确实需要且内容适合的页面。

常规中文正文可从 16–18px、说明从 14px 左右开始，按字体和密度调整；小字仅用于不承担理解任务的辅助标记。触控区域与可见按钮高度分开考虑，保持约 44px 的易操作区域。保留页面缩放，不能通过禁用缩放、隐藏溢出或缩小文字掩盖排版问题。

5. 用实际画面完成闭环

HTML 写完、构建通过、没有横向滚动，都不等于视觉验收完成。

首次交付包含内部视觉修订：首轮实现后，按 visual-review.md 的“整页视觉修订”逐段看实际页面，自行找出缺少内容依据、重复套版或主次失衡的区域并改后复看；不等用户指出才开始设计第二稿。检查整个页面，首屏的主视觉不能替后续内容通过验收。用户给出的“简约、大气、浪漫”等方向，要落实到可见的比例、材质、字体与内容取舍；沉浸式只是观看方式，不能代替风格判断。

新建或整体重做时，先完成包含真实内容或明确演示内容的代表性首屏，打开桌面与手机画面，核对设计依据是否在画面中成立，再批量扩展其余区块。检查主任务是否被宣传挤走、视觉焦点是否明确、素材是否支撑方向；失败时先改构图或素材，再加动效与细节。局部修复、忠实复刻和已有用户确认的布局不因此重开设计。

用本地 HTTP 服务和可用浏览器查看实际页面，保存并亲自查看桌面、手机截图；工具失败时尝试可用替代工具。检查首屏、整页节奏及主要交互展开态。下拉必须实际打开后看选项面板；用脚本直接修改选中值不算展开态验收。按 visual-review.md 修复问题后重看受影响画面。静态截图不能证明动画质量，还需实际触发并观察过渡。

动态验收分别给出 Motion、转场、光影的实际证据：录屏或带时间点的连续画面/状态，并检查中间过程、反向操作及恢复状态。至少覆盖桌面、手机和实际预览窄窗；不能把手机/窄窗直接设为无动画替代适配。若无法观察动态过程，标注该项未验证，不用截图、transition 声明、功能通过或加载速度作完成证据，不虚报帧率。

优先修阅读与操作问题，再修构图、比例、对齐和视觉一致性。不要用更多装饰掩盖问题。若截图能力确实不可用，保留可运行结果并明确标注“尚未完成视觉验证”；不虚报“已在手机检查”。

交付前将视觉、交互、体积与速度分开判断。 按 visual-review.md 留下可追溯的视觉结论：对应截图、构图成立的具体理由、发现的问题与改后证据；不可用“已截图”“已用本技能”或测试全绿宣布审美合格。内审自行推进，不新增例行用户审批，也不以主观总分保证“没有 AI 味”。

交付简短说明设计方向、可打开的结果、实际验证和未完成事项；能展示成品时给截图或预览。不要要求用户读设计术语来理解页面，也不要用主观评分承诺“审美已经合格”。

6. 按发布包完成体积与速度验收

按 static-release.md 执行：优化素材 → 压缩与版本化构建 → 生成部署包 → 核对包与产物 → 从最终包预览 → 测首页 → 已授权上线后复核服务器配置。优化后复查画质、原有交互和视觉，不以瘦身破坏已确认的设计。

• 用 python3 scripts/audit_static.py 对最终静态目录及 ZIP/tar 做只读检查，记录包体积、解压体积、分类资源、最大文件、图片前后证据和资源完整性；脚本路径按本技能绝对目录解析。
• 用 node scripts/measure_page.mjs 或已有浏览器性能工具测首页，记录实际环境、冷启动多次样本、热访问、FCP、观测到的 LCP/CLS、传输资源与缓存响应头。脚本复用已有 Playwright，不自动安装依赖；不可用时使用可用工具并注明缺失范围。
• 不把 ZIP 大小、所有资源本地 Gzip 估算或 localhost 耗时称为首屏网络下载量或线上速度。没有测到的指标不能填零、没有跑的 Lighthouse 不能给分数。
• 交付须附简洁的发布检查结果与部署说明，明确体积预算是否达标、图片是否有优化证据、速度是否仅本地测量、哪些线上配置待验证。修复错误并处理告警；合理例外写明原因，不以一个退出码代替阅读报告。

快速排错

参考图与随包许可边界见 asset-notices.md。