Communitygithub.com

open-design-landing

以 Atelier Zero 视觉语言(Monocle / Apartamento / Études 编辑拼贴风格)生成世界级单页编辑落地页——与 Open Design 自身营销站点使用相同美学。智能体根据品牌摘要填写类型化的 `inputs.json`,可选通过 gpt-image-2 生成 16 幅拼贴资产,然后运行纯函数合成器输出自包含的 HTML 文件;另有一条路径可在 `apps/landing-page/` 中镜像 Astro 营销站点。滚动显现动画和 Headroom 式粘性导航自动集成。

open-design-landing 是什么?

这是一个为 Open Design 品牌页面设计的 Agent Skill,用于生成高审美的单页编辑落地页。它采用 Atelier Zero 设计系统——暖纸背景、Inter Tight + Playfair Display 字体、斜体强调、点划线、珊瑚色终止点、卷轴动画和 16 幅超现实拼贴图。该技能完全参数化:你需要先通过八组提问收集品牌输入(名称、标记、导航、英雄区、关于、能力、实验室、方法、作品、推荐、行动呼吁、页脚等),然后选择图像策略(占位符/生成/自备),最后运行合成脚本输出一个自包含的 HTML 文件。支持 `standalone-html` 和 `nextjs-app`(Astro)两种输出格式,也可同时输出。技能适用于 macOS/Linux 等系统,依赖 file-write、http-fetch(生成图像时)和 node-runtime 能力。最终交付的页面必须通过自我检查清单(无控制台错误、所有图像加载、响应式断点、对比度 AA 等)。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Keimoshi/Silverloft/tree/HEAD/open-design-port/skills/open-design-landing

在你喜欢的 AI 中提问

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

预览

来自技能 README

open-design-landing preview

文档

open-design-landing 是做什么的?

以 Atelier Zero 设计系统构建一个单页编辑落地页(或幻灯片——参见同级技能 open-design-landing-deck):暖纸背景、Inter Tight + Playfair Display 字体、斜体 serif 强调跨距、点划线、珊瑚色终止点、滚动显现动画以及 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 列链接 + 大号斜体 serif 强调词。
  • 每个部分的滚动显现动画(IntersectionObserver,尊重 prefers-reduced-motion)。
  • 在 1280 / 1080 / 880 / 560 断点下完全响应。

工作流契约

按以下四个步骤顺序执行。智能体在进入下一步前应完成当前步骤,并倾向于向用户提出聚焦的问题,而不是自己编造文案。

1. 收集品牌输入

使用 AskQuestion(或您界面中的等效功能)分块收集品牌摘要;不要将整个 schema.ts 倾倒给用户。将他们的答案映射到匹配类型化形状的 inputs.json 中。

八个问题组,按顺序:

组Schema 字段最少答案数备注
1brand.{name,mark,tagline,description,location}5Mark = 单个符号(Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4必需提供URL;许可证默认为 Apache-2.0
3nav[] (最多 5 个)3可选计数徽章
4hero.{label,headline,lead,primary,secondary,stats}全部Headline 为 MixedText(sans+em+dot)
5about + capabilities.cards[4]全部4 张卡片 × {num,tag,title,body}
6labs.cards[5] + method.steps[4]全部两个网格固定长度
7work.cards[2] + testimonial全部5 个合作伙伴图形为内联 SVG 路径数据
8cta + 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-并-编辑是支持的路径。


交付前自检

在标记完成之前,智能体必须验证:

  • <out>/index.html 在浏览器中打开且无控制台错误。
  • 所有 16 个图像槽位均已加载(DevTools 网络选项卡中无 404)。
  • 标题斜体强调跨距使用 Playfair 显示(非 sans)。
  • 珊瑚色终止点出现在每个 display h1/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  # 人类可读的提示包

边界

  • 不要发明新的颜色或字体。Token 位于 design-systems/atelier-zero/DESIGN.md 中;添加新色阶前请先扩展设计系统。
  • 不要从生成的标记中丢弃 data-reveal 属性。没有它们,页面将变得静态且感觉死板。
  • 不要将合成的 HTML 封装在注入自身样式表顺序的框架中——Atelier Zero 依赖样式表级联顺序来实现纸张纹理和侧栏的 z-index。
  • 不要为 Astro 落地页 fork 添加单独的样式表文件;将 styles.css 原样复制到 app/globals.css 中以保持视觉一致。

另请参见

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能