open-design-landing
在 Atelier Zero 设计系统中构建一个单页编辑风格的着陆站点(或幻灯片——参见同级的 open-design-landing-deck 技能):暖色纸张背景、Inter Tight + Playfair Display 字体、斜体衬线强调跨度、虚线发丝规则、珊瑚色终止点、滚动揭示动画以及 16 幅超现实拼贴画板。
这是 Open Design 营销页面的标准配方——示例输出正是你在 open-design 看到的页面。
该技能是完全参数化的。代理根据用户的简报填充一个类型化的 inputs.json;合成器则将该 JSON 与规范化的 styles.css 转换为可部署的工件。
inputs.json + styles.css 16 image slots
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (self-contained)
<out>/assets/ (PNG or SVG)
你将获得
一个包含全部以下功能的单一 HTML 文件:
- 编辑顶部栏(卷号/期号/语言条),Headroom 风格的粘性导航,带有实时 GitHub 星数。
- 8 个带罗马数字编号的章节,配有纸张纹理背景: 英雄区(含 3 个统计环 + 4 步索引)、关于、能力(4 张卡片)、实验室(5 张卡片 + 筛选药丸 + 进度条)、方法论(4 步带缩略图)、精选作品(深色石板 + 2 张倾斜卡片)、推荐(引用 + 5 个合作伙伴标志)、行动号召(彩带 + 电子邮件药丸)。
- 底部带有 4 个链接列和巨大的斜体衬线强调词。
- 每个章节的滚动揭示动画(IntersectionObserver,尊重
prefers-reduced-motion)。 - 完全响应式,支持 1280 / 1080 / 880 / 560 断点。
工作流合约
按顺序执行以下四个步骤。代理应在继续前完成每一步,并优先向用户提出有针对性的问题,而非自行编造文案。
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 为必填;许可证默认为 Apache-2.0 |
| 3 | nav[] (最多 5 个) | 3 | 可选计数徽章 |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | 全部 | 标题为 MixedText(无衬线 + 斜体 + 点) |
| 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} | 全部 | 巨型强调词是一个像标题一样的 MixedText |
打开 inputs.example.json 查看完整的工作示例(即 Open Design 本身)。
2. 决定图片策略
| 策略 | 何时选择 | 成本 / 延迟 |
|---|---|---|
placeholder | 第一遍。演示。内部幻灯片。尚无图片预算。 | $0, <1秒 |
generate | 最终交付。品牌想要原创拼贴画。 | ~$0.40, ~6分钟 |
bring-your-own | 用户拥有艺术指导的 PNG。将它们放入 assets_path。 | $0, 0秒 |
相应地设置 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 站点
对于可部署的生产输出,fork apps/landing-page/ 包:将其复制到你的工作区,将 app/page.tsx 的内容与你的 inputs.json 对齐,并将你的 <out>/assets/*.png 复制到 app/image-assets.ts / R2 URL 所期望的路径。使用 pnpm --filter @open-design/landing-page build 构建,生成一个静态 out/ 导出,可直接用于任何 CDN。
未来的迭代可能会捆绑一个合成器,能够在一个命令中从
inputs.json生成完整的apps/landing-page/树。在此之前,fork 并编辑是受支持的路径。
交付前自检
在标记为完成之前,代理必须验证:
-
<out>/index.html在浏览器中打开且无控制台错误。 - 所有 16 个图片插槽均已加载(DevTools 网络标签页中无 404)。
- 标题斜体强调跨度以 Playfair 字体(而非无衬线)渲染。
- 每个
displayh1/h2 末尾出现珊瑚色终止点。 - 从上到下滚动;每个章节动画播放一次。
- 缩放至 880px 和 560px;无水平滚动,无重叠。
-
prefers-reduced-motion: reduce(DevTools → 渲染)能干净地禁用过渡。 - Lighthouse:对比度 AA、字体显示交换、英雄区无布局偏移(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 着陆页 fork 添加单独的样式表文件;将
styles.css原样复制到app/globals.css中,以保持视觉上的一对一一致。
参见
design-systems/atelier-zero/DESIGN.md— 令牌规范。apps/landing-page/— 可部署的 Astro 静态对应物。skills/open-design-landing-deck/— 同级幻灯片技能,重用此设计系统。
