open-design-landing 是做什么的?
构建一个单页编辑式落地网站(或幻灯片演示——参见同级技能 open-design-landing-deck),使用 Atelier Zero 设计系统:暖纸背景、Inter Tight + Playfair Display 字体、斜体衬线强调、虚线分隔线、珊瑚色终止点、滚动揭示动画,以及 16 张超现实拼贴画。
这是 Open Design 营销页面的标准配方——示例输出就是您正在 open-design 看到的页面。
该技能完全参数化。智能体根据用户简报填写类型化的 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 断点处完全响应。
工作流程约定
按顺序执行以下四个步骤。智能体应在进行下一步之前完成每一步,并倾向于向用户提出具体问题,而非自行编造文案。
1. 收集品牌输入
使用 AskQuestion(或您 UI 中的等效方法)分块收集品牌简报;不要将整个 schema.ts 转储给用户。将他们的答案映射到与类型形状匹配的 inputs.json 中。
八个问题组按顺序如下:
| 组 | 架构字段 | 最少答案数 | 说明 |
|---|---|---|---|
| 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} | 全部 | Headline 作为 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} | 全部 | Mega 强调词是 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
将 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-and-edit 是受支持的路径。
交付前的自查
在标记完成之前,智能体必须验证:
-
<out>/index.html在浏览器中打开且没有控制台错误。 - 所有 16 个图片槽位均已加载(DevTools 网络标签页中无 404)。
- 标题斜体强调以 Playfair 字体渲染(非无衬线)。
- 珊瑚色终止点出现在每个
displayh1/h2 的结尾。 - 从顶部滚动到底部;每个章节动画出现一次。
- 缩放到 880px 和 560px;无水平滚动,无重叠。
-
prefers-reduced-motion: reduce(DevTools → Rendering)干净地禁用过渡。 - 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 落地网站 fork 添加单独的样式表文件;将
styles.css原样复制到app/globals.css,以保持视觉上的一对一一致。
参见
design-systems/atelier-zero/DESIGN.md— 令牌规范。apps/landing-page/— 可部署的 Astro 静态对应物。skills/open-design-landing-deck/— 同级幻灯片技能,重用此设计系统。
