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个合作伙伴图标)、行动号召(带状+邮件药丸)。
- 每个部分的滚动显示动效(IntersectionObserver,遵守
prefers-reduced-motion)。 - 完全响应式(1280 / 1080 / 880 / 560断点)。
工作流合同
按顺序执行以下四个步骤。Agent应在进入下一步前完成当前步骤,并向用户提出针对性问题,而非自创文案。
1. 收集品牌输入
使用AskQuestion(或UI中对应功能)分块收集品牌简报;不要将整个schema.ts丢给用户。将其答案映射到匹配类型形状的inputs.json。
八个问题分组(按顺序):
| 分组 | Schema字段 | 最少答案 | 备注 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark为单个字形(Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | 链接必填;许可默认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 kicker为MixedText,同标题格式 |
打开inputs.example.json查看完整示例(Open Design自身)。
2. 决定图片策略
| 策略 | 何时选择 | 成本/延迟 |
|---|---|---|
placeholder | 首轮通过。演示。内部幻灯片。尚无图片预算。 | $0, <1s |
generate | 最终交付。品牌希望原创拼贴。 | ~$0.40, ~6分钟 |
bring-your-own | 用户已有美术方向PNG。将其放入assets_path。 | $0, 0s |
相应地设置inputs.imagery.strategy。
placeholder — 框架模式
npx tsx scripts/placeholder.ts <out>/assets/
向<out>/assets/写入16个.svg文件(附带.png别名以保持兼容)。每个占位符显示槽位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
在inputs.imagery.assets_path处放入16个PNG,文件名匹配assets/image-manifest.json。完成。
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-edit是支持路径。
交付前自检
在标记完成之前,Agent必须验证:
-
<out>/index.html在浏览器中打开无控制台错误。 - 所有16个图片槽位加载成功(DevTools网络标签页无404)。
- 标题斜体强调处使用Playfair字体(非sans)。
- 每个
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,以保持视觉一致性的一对一关系。
另请参阅
skills/open-design-landing-deck/— 同组幻灯片技能,复用此设计系统。
