Communitygithub.com

LuzzyMeow/LuzzyRP

最简发布前落地页,支持邮箱捕获、品牌Logo和可选的装饰层。读取 DESIGN.md 中的颜色、排版和布局规则。适用于产品发布、Beta注册、早期访问计划和独立项目。

LuzzyRP 是什么?

该技能用于快速生成一个品牌一致性高、移动端优先的发布前等待列表页面。它通过读取项目中的 DESIGN.md 文件来确定颜色系统、字体配对和空间规则,确保页面与品牌形象严格一致。工作流程基于一个预制的模板 `assets/template.html`,通过安全的令牌替换机制将产品名称、标语、Logo和颜色表达式等动态内容注入模板,并对所有用户输入进行严格的HTML转义或CSS注入防护。最终输出一个包含内联CSS和SVG的单一HTML文件,并通过一份P0级质量检查清单(如单一CTA按钮、无虚假紧迫感、颜色一致性等)确保页面的合规性和安全性。此技能适用于任何需要快速、可信赖地建立产品发布前用户等待列表的场景,支持Claude Code等AI Agent平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LuzzyMeow/LuzzyRP/tree/HEAD/docs/skills/open-design/design-templates/waitlist-page

在你喜欢的 AI 中提问

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

文档

Waitlist Page Skill

发布前的页面是你与未来用户的第一次握手。本技能构建一个专注且真诚的入口:你的品牌标识、你在做什么、以及一条加入早期名单的清晰路径。没有人为制造的稀缺感、虚假倒计时或膨胀策略——只是一个为真正兴趣打造的、干净的移动端优先容器。

工作流程

前置步骤:加载固化模板和品牌基础

  1. 加载品牌标识 — 读取 DESIGN.md 以获取颜色系统、字体配对和空间规则。这是你的基础。一个等待列表页面的成败取决于与其所代表的品牌的一致性。如果 DESIGN.md 缺失,请要求用户提供一个,然后才能继续。
  2. 读取并复制可复用模板 — 读取 assets/template.html。此模板是所有输出的固化种子。将其复制为 index.html 作为基础。不要从头编写HTML或偏离此结构。模板包含了所有必需的布局、表单结构、装饰、焦点样式和无障碍性支持。

步骤:带验证和转义的令牌替换

  1. 根据输入映射令牌 — 对于模板中的每个占位符(例如 {{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。直接插入到 :root CSS变量中。如果 DESIGN.md 中存在,则从中派生 --success;否则仅使用允许的回退值 #2D6A4F。
    • 字体名称令牌({{DISPLAY_FONT_CSS}}、{{BODY_FONT_CSS}}):这些是CSS font-family 值,如果包含空格则已加引号(例如 'DM Sans'、Syne)。直接插入到 --font-display 和 --font-body 声明中;不要额外添加引号。
    • 字体URL令牌({{DISPLAY_FONT_URL}}、{{BODY_FONT_URL}}):对于Google Fonts URL,空格必须编码为 +(例如 DM+Sans、IBM+Plex+Serif)。在插入前验证URL格式是否正确。 3.验证令牌映射规则 — 所有颜色令牌现在都是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首字母的对比文本颜色)
  2. 响应式布局 — 模板包含移动端优先的缩放:
    • 375px:表单堆叠为单列,Logo缩小至40px,装饰压缩,无水平滚动。
    • 768px:舒适的两列呼吸空间。
    • 1440px+:居中布局,带有充足的留白。
    • 验证所有文本保持可读,并且在375×667和390×844视口下邮箱输入框和按钮完全可见(无裁剪)。

验证:输出前运行硬化质量门限

  1. 运行质量检查清单 — 读取 references/checklist.md。在输出前验证每个 P0 门限:
    • 仅有一个CTA(邮箱表单)
    • 无倒计时、无虚假社交证明、无表情符号
    • 在375px下无水平滚动
    • 邮箱输入框具有 type="email" 和 required;名字没有 required
    • 表单没有使用 novalidate;JS使用 checkValidity() 守卫
    • 成功消息具有 role="status" 或 aria-live="polite"
    • 所有颜色来自DESIGN.md或允许的回退值;没有自创的hex值
    • 所有用户文本均已HTML转义;颜色令牌遵循严格语法;字体已进行URL编码
    • 通过P0或不得输出。 如果任何P0门限失败,询问用户或修复令牌映射并重试。
  2. 验证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=""> 已设置

输出

  1. 输出干净的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调色板。唯一允许硬编码的例外:#2D6A4F 用于 --success。
  • 无反模式:无倒计时、无虚假社交证明、无表情符号图标、无Lorem Ipsum。
  • 内容完整性:标题和文案直接关联到 product_name 和 tagline 输入——无填充内容。
  • 移动端适配:在375px下无水平滚动。邮箱输入框和提交按钮在375×667和390×844下完全可见(无裁剪)。垂直溢出应为可滚动,而非隐藏。
  • 排版规范:仅显示+正文字体(2字体规则)。各节尺寸一致。
  • 表单结构:两个字段(名字可选,邮箱必填),checkValidity() 守卫,成功消息带有 role="status"。
  • 令牌转义:所有用户提供的文本已HTML转义;颜色令牌遵循严格语法且不包含不安全字符(;、{}、<、>、/*、@、url();字体名称已进行URL编码;{{LOGO_MARK}} 为转义后的文本首字母或经过严格清理的内联SVG(无脚本、无事件处理器、无foreignObject、无外部href)。

P1门限(为了质量提交应通过):

  • Hero部分视觉上独特且位于首屏。
  • 邮箱提交按钮有悬停和激活状态。
  • 表单验证提供清晰的反馈。
  • 页面在所有移动视口下可滚动(无裁剪);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检查清单门限。不要在迭代中跳过验证。

相关技能