等待列表页面技能
发布前的页面是与未来用户的初次握手。此技能构建了一个专注且诚实的入口:你的品牌标识、你正在打造的产品,以及加入早期列表的一条清晰路径。没有人为制造的稀缺感,没有虚假倒计时,没有夸大策略——只是一个干净、移动优先的容器,承载真正的兴趣。
工作流程
预备:加载稳固模板与品牌基础
- 加载品牌标识——读取
DESIGN.md获取色彩系统、字体搭配和空间规则。这是你的基础。等待列表页面的成败取决于与其所代表的品牌是否一致。如果缺少DESIGN.md,请在继续之前要求用户提供。 - 读取并复制可复用模板——读取
assets/template.html。此模板是所有输出的稳固基础。将其复制到index.html作为你的基础。不要从头编写 HTML 或偏离此结构。该模板已包含所有必需的布局、表单结构、装饰、焦点样式和无障碍脚手架。
步骤:带验证与转义的令牌替换
- 从输入中映射令牌——对于模板中的每个占位符(例如
{{PRODUCT_NAME}}、{{BG_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{LOGO_MARK}}),遵循以下替换规则:- 文本令牌(
{{PRODUCT_NAME}}、{{TAGLINE}}):在插入到 HTML 文本节点或属性值之前,对<、>、&、"、'进行 HTML 转义。 - HTML 令牌(
{{LOGO_MARK}}):如果使用文本首字母,默认进行 HTML 转义。如果使用内联 SVG,必须使用白名单严格净化:删除<script>标签、事件处理器(on*)、<foreignObject>、外部引用(href、xlink:href、url())以及任何不允许的属性/元素后再插入。如果 SVG 无法安全净化,则回退到转义的文本首字母。永远不要输出原始、未净化的任意 HTML。确保任何 SVG 在其容器内干净地缩放。 - 颜色表达式令牌(
{{BG_EXPRESSION}}、{{FG_EXPRESSION}}、{{ACCENT_EXPRESSION}}、{{DECO_EXPRESSION}}、{{STRIPE_EXPRESSION}}、{{SUCCESS_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{BTN_LABEL_EXPRESSION}}、{{TICKER_BG_EXPRESSION}}、{{TICKER_FG_EXPRESSION}}、{{DECO_STROKE_EXPRESSION}}、{{LOGO_SHADOW_EXPRESSION}}、{{LOGO_FG_EXPRESSION}}):必须严格遵守明确的颜色语法(#hex、rgb/rgba、hsl/hsla、oklch或仅使用局部变量的color-mix())。硬性拒绝任何包含;、{}、<、>、注释(/*)、@、url(或外部引用的输入,以防止 CSS 注入。不要用#包裹或添加额外引号。示例:rgba(196, 169, 154, 0.38)、color-mix(in srgb, var(--fg) 38%, transparent)、#FDE8DF。按原样插入到:rootCSS 变量中。如果 DESIGN.md 中存在,从其中派生--success;否则仅使用允许的备用值#2D6A4F。 - 字体名称令牌(
{{DISPLAY_FONT_CSS}}、{{BODY_FONT_CSS}}):这些是 CSS 字体系列值,如果包含空格则已经添加引号(例如'DM Sans'、Syne)。按原样插入到--font-display和--font-body声明中;不要添加额外引号。 - 字体 URL 令牌(
{{DISPLAY_FONT_URL}}、{{BODY_FONT_URL}}):空格必须编码为+以适应 Google Fonts URL(例如DM+Sans、IBM+Plex+Serif)。在插入前验证 URL 格式正确。
- 文本令牌(
- 验证令牌映射规则——所有颜色令牌现在都在 CSS 变量中:
--bg={{BG_EXPRESSION}}(例如#FDE8DF)--fg={{FG_EXPRESSION}}(例如#1A1410)--accent={{ACCENT_EXPRESSION}}(品牌徽章)--deco={{DECO_EXPRESSION}}(主要装饰)--deco-stripe={{STRIPE_EXPRESSION}}(强调条纹)--input-border={{BORDER_EXPRESSION}}(完整的 CSS 表达式,含透明度)--success={{SUCCESS_EXPRESSION}}或备用#2D6A4F--btn-label={{BTN_LABEL_EXPRESSION}}(按钮文本颜色以保证对比度)--ticker-bg={{TICKER_BG_EXPRESSION}}(动画滚动条背景)--ticker-fg={{TICKER_FG_EXPRESSION}}(动画滚动条文本)--deco-stroke={{DECO_STROKE_EXPRESSION}}(SVG 描边,通常使用 12–15% 透明度的柔和色)--logo-shadow={{LOGO_SHADOW_EXPRESSION}}(Logo 容器阴影,微妙的背景色深浅)--logo-fg={{LOGO_FG_EXPRESSION}}(Logo 首字母的对比文本颜色)
- 响应式布局——模板包含移动优先的缩放:
- 375px:表单堆叠为单列,Logo 缩小至 40px,装饰压缩,无水平滚动。
- 768px:舒适的双列呼吸空间。
- 1440px+:居中布局,带有大量留白。
- 验证所有文本保持可读,电子邮件输入框和按钮在 375×667 和 390×844 下完全可见(无裁剪)。
验证:输出前运行稳固的质量检查
- 运行质量检查清单——读取
references/checklist.md。在输出前验证每个 P0 关卡:- 恰好一个 CTA(电子邮件表单)
- 无倒计时器,无虚假社交证明,无表情符号
- 375px 时无水平滚动
- 电子邮件输入框有
type="email"和required;名字无required - 表单不使用
novalidate;JS 使用checkValidity()保护 - 成功消息有
role="status"或aria-live="polite" - 所有颜色来自 DESIGN.md 或允许的备用值;没有发明的十六进制值
- 所有用户文本均已 HTML 转义;颜色令牌遵循严格语法;字体已 URL 编码
- 通过 P0 否则不输出。 如果任何 P0 关卡失败,询问用户或修复令牌映射并重试。
- 为质量提交验证 P1 关卡(推荐):
- 提交按钮的悬停和激活状态
- 带有清晰反馈的表单验证
- 滚动条动画尊重
prefers-reduced-motion: reduce - 所有交互元素有可见的焦点样式(input:focus 包括
outline) - Tab/Enter 键盘支持
- WCAG AA 对比度:正文文本(≥4.5:1)和按钮标签(≥4.5:1)
- Logo 的 alt/aria-label 存在;滚动条有
aria-hidden="true" - 设置
<html lang="">
输出
- 输出干净的 HTML——单文件,CSS 内联,SVG 用于图形。使用
data-od-id标记交互元素(标题、表单、Logo、滚动条、网格等),以便智能体无需解析即可自定义。
质量关卡
此技能强制执行基于稳固模板的工作流程,以确保合规性。你必须遵循此执行路径;偏离模板将使输出无效。
强制性的基于模板的执行:
- 读取
assets/template.html作为基础;不要从头编写 HTML。 - 将其复制到
index.html,并仅用经过验证/转义的值替换{{PLACEHOLDER}}令牌。 - 在输出前运行
references/checklist.md中的每个 P0 关卡;如果任何失败,修复并重新验证。
P0 关卡(必须通过):
- 单一 CTA:电子邮件表单是唯一的交互元素。无导航,无次要按钮,无社交链接。
- Logo 放置:固定左上角,匹配 DESIGN.md 强调色,在移动端缩放(50px → 40px)。
- 颜色一致性:所有颜色来自 DESIGN.md 调色板。唯一允许的硬编码例外:
--success的#2D6A4F。 - 无反模式:无倒计时器,无虚假社交证明,无表情符号图标,无 lorem ipsum。
- 内容完整性:标题和文案直接关联到
product_name和tagline输入——无填充内容。 - 移动端适配:375px 时无水平滚动。电子邮件输入框和提交按钮在 375×667 和 390×844 下完全可见(无裁剪)。垂直溢出可滚动,而非隐藏。
- 排版规范:仅显示字体和正文字体(2 字体规则)。各部分尺寸一致。
- 表单结构:两个字段(名字可选,电子邮件必填),
checkValidity()保护,成功消息带role="status"。 - 令牌转义:所有用户提供的文本已 HTML 转义;颜色令牌遵循严格语法,不含不安全字符(
;、{}、<、>、/*、@、url();字体名称已 URL 编码;{{LOGO_MARK}}为转义的文本首字母或严格净化的内联 SVG(无脚本、无事件处理器、无 foreignObject、无外部 href)。
P1 关卡(为质量提交应通过):
- 英雄区视觉上独特且在首屏可见。
- 电子邮件提交按钮有悬停和激活状态。
- 表单验证提供清晰反馈。
- 页面在所有移动视口下可滚动(无裁剪);CTA 无需滚动即可见。
- 在
prefers-reduced-motion: reduce下滚动条动画暂停/移除。 - 所有交互元素有可见的焦点样式(outline,而不仅仅是 outline:none)。
- 键盘:Tab 键可到达每个表单字段;Enter 键提交。
- WCAG AA 对比度:正文文本 ≥4.5:1,按钮标签 ≥4.5:1。
- Logo 的 alt/aria-label 存在;滚动条有
aria-hidden="true"。 <html lang="">设置为正确的语言代码。
装饰限制:
- 下部区域增强而不分散注意力。透明度、柔和描边、柔和动画。
- 无超过视口高度 20% 的渐变。
- 线圈、条纹、网格或滚动条仅使用 DESIGN.md 中的颜色。
输出
仅在 references/checklist.md 中的所有 P0 关卡通过后输出。
在标签之间输出工件:
<artifact identifier="waitlist-id" type="text/html" title="即将推出 — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>
在工件上方有一行描述;下方无内容。
输出后: 如果用户要求更改,就地更新 index.html,并在输出下一个版本前重新运行 P0 检查清单关卡。不要在迭代中跳过验证。