open-design-landing
构建一个单页编辑式落地页(或幻灯片——参见同级技能 open-design-landing-deck),采用 Atelier Zero 设计系统:暖纸色背景、Inter Tight + Playfair Display 字体、斜体衬线强调跨度、虚线细线、珊瑚色终止圆点、滚动揭示动画以及 16 幅超现实拼贴画。
这是规范的 Open Design 营销页面方案——示例输出即您在 open-design 上看到的页面。
该技能完全 参数化。Agent 根据用户简报填充一个类型化的 inputs.json;合成器将该 JSON 与规范的 styles.css 转换为可部署的产物。
inputs.json + styles.css 16 个图像插槽
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (自包含)
<out>/assets/ (PNG 或 SVG)
您将获得的内容
一个包含所有以下内容的单一 HTML 文件:
- 编辑式顶栏(卷/期/语言条)、Headroom 式粘性导航(含实时 GitHub 星数)。
- 8 个编号为罗马数字的区块,带有纸质纹理背景:英雄区(含 3 个统计环 + 4 步索引)、关于、能力(4 张卡片)、实验室(5 张卡片 + 筛选药丸 + 进度条)、方法(4 步带缩略图)、精选作品(深色板块 + 2 张倾斜卡片)、推荐语(引用 + 5 个合作伙伴字形)、行动号召(丝带 + 邮件药丸)。
- 含 4 个链接列的页脚 + 巨大的斜体衬线结尾词。
- 每个区块的滚动揭示动画(IntersectionObserver,尊重
prefers-reduced-motion)。 - 在 1280 / 1080 / 880 / 560 断点处完全响应。
工作流约定
按顺序执行以下四个步骤。Agent 应在进入下一步之前完成当前步骤,并优先向用户提出有针对性的问题,而非自行编造文案。
1. 收集品牌输入
使用 AskQuestion(或您界面中的等效工具)分块收集品牌简报;不要将整个 schema.ts 抛给用户。将他们的答案映射到与类型化结构匹配的 inputs.json 中。
八个问题组,依次为:
| 组 | Schema 字段 | 最少答案数 | 说明 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = 单个字形 (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL 为必填项;license 默认使用 Apache-2.0 |
| 3 | nav[] (最多 5 个) | 3 | 可选计数徽章 |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | 全部 | Headline 为 MixedText 类型 (sans+em+dot) |
| 5 | about + capabilities.cards[4] | 全部 | 4 张卡片 × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | 全部 | 两个网格都为固定长度 |
| 7 | work.cards[2] + testimonial | 全部 | 5 个合作伙伴字形作为内联 SVG 路径数据 |
| 8 | cta + footer.{columns[4],mega} | 全部 | Mega 结尾词是 MixedText 类型,类似标题 |
打开 inputs.example.json 查看完整的示例(Open Design 本身)。
2. 决定图像策略
| 策略 | 适用场景 | 成本 / 延迟 |
|---|---|---|
placeholder | 首次尝试。演示。内部幻灯片。尚无图像预算。 | $0, <1s |
generate | 最终交付。品牌需要原创拼贴画。 | ~$0.40, ~6 min |
bring-your-own | 用户已有创意指导 PNG。将它们放在 assets_path。 | $0, 0s |
相应设置 inputs.imagery.strategy。
placeholder——框架模式
npx tsx scripts/placeholder.ts <out>/assets/
将 16 个 .svg 文件(同时生成 .png 别名以保证兼容性)写入 <out>/assets/。每个占位符显示插槽 ID、比例、像素尺寸以及来自 image-manifest.json 的提示。合成器的 <img src='./assets/hero.png'> 等将正常工作。
generate——gpt-image-2 模式
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
为每个插槽调用 fal.ai 的 openai/gpt-image-2 同步端点。合成提示为:风格锚点(纸质拼贴编辑系统)+ 品牌变量(从 inputs.json 中提取的名称/导航/标题/斜体强调)+ 每个插槽的构图(例如,裁剪的石膏头像 + 树穿过拱门)。如果目标文件已存在则跳过该插槽;传递 --force 参数可重新渲染。
如果没有 FAL_KEY,脚本会打印提示,以便操作员可以手动通过 /gpt-image-fal 斜杠命令技能路由它们。
bring-your-own
将 16 个符合 assets/image-manifest.json 文件名的 PNG 放置在 inputs.imagery.assets_path。完成。
3. 合成产物
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
合成器读取 inputs.json 和 ../styles.css,然后写入一个自包含的 HTML 文件。页面包括:
- 完整的 Atelier Zero 样式表(内联)。
- 所有区块的标记,带有
data-reveal属性以实现交错滚动动效。 - 内联的 IntersectionObserver 脚本(镜像
apps/landing-page/app/_components/reveal-root.tsx)。 - 内联的 Headroom 导航脚本(镜像
header.tsx)。 - 内联的 GitHub 星数获取器(自动从
brand.primary_url检测)。
4. (可选)镜像可部署的 Astro 站点
对于可部署的生产输出,复制 apps/landing-page/ 包:将其复制到您的工作区,将 app/page.tsx 的内容与您的 inputs.json 对齐,并将您的 <out>/assets/*.png 复制到 app/image-assets.ts / R2 URLs 所期望的路径。使用 pnpm --filter @open-design/landing-page build 构建以获取静态 out/ 导出,该导出可直接用于任何 CDN。
未来的迭代可能会打包一个合成器,以一条命令从
inputs.json生成完整的apps/landing-page/树。在此之前,复制-编辑是受支持的路径。
交付前的自我检查
在标记完成之前,Agent 必须验证:
-
<out>/index.html在浏览器中打开时无控制台错误。 - 所有 16 个图像插槽已加载(DevTools 网络选项卡中无 404 错误)。
- 标题中的斜体强调跨度以 Playfair 字体渲染(非无衬线字体)。
- 每个
displayh1/h2 末尾都出现珊瑚色终止圆点。 - 从顶部滚动到底部;每个区块都激活一次动画。
- 调整大小至 880px 和 560px;无水平滚动,无重叠。
-
prefers-reduced-motion: reduce(DevTools → 渲染)干净地禁用过渡。 - Lighthouse:对比度 AA、font-display swap、英雄区无布局偏移(CLS < 0.05)。
此技能中的文件
skills/open-design-landing/
├── SKILL.md # 本约定
├── README.md # 快速入门
├── schema.ts # 类型化输入(唯一真实来源)
├── styles.css # Atelier Zero 样式表(唯一真实来源)
├── inputs.example.json # 以 Open Design 作为示例
├── example.html # 规范渲染(从 inputs.example.json 重新生成)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # gpt-image-2 封装器 (fal.ai)
│ └── placeholder.ts # SVG 纸质纹理框架
└── assets/
├── *.png # 16 幅拼贴画(Open Design 实例)
├── image-manifest.json # 插槽 → 文件/尺寸/提示映射
└── imagegen-prompts.md # 人类可读的提示包
边界
- 不要发明新的颜色或字体。令牌位于
design-systems/atelier-zero/DESIGN.md中;在为此处添加新梯度之前,请先扩展设计系统。 - 不要从生成的标记中删除
data-reveal属性。没有它们,页面会变得静态且感觉死气沉沉。 - 不要将合成的 HTML 包装在会注入自己样式表顺序的框架中——Atelier Zero 依赖样式表顺序的级联来实现纸质纹理和侧栏的 z-index。
- 不要为 Astro 落地页分支添加单独的样式表文件;将
styles.css原样复制到app/globals.css中,以保持视觉上的一对一一致性。
参见
design-systems/atelier-zero/DESIGN.md— 令牌规范。apps/landing-page/— 可部署的 Astro 静态对应部分。skills/open-design-landing-deck/— 复用此设计系统的同级幻灯片技能。
