Communitygithub.com

open-design-landing

根据品牌简报,构建一个单页编辑式落地页(或幻灯片),使用 Atelier Zero 设计系统:暖纸背景、Inter Tight + Playfair Display 字体、斜体衬线强调、点状细线、珊瑚色终止圆点、滚动显示动画,以及 16 张超现实拼贴图。

open-design-landing 是什么?

该技能(Skill)是一个高度参数化的代理工具,能够根据用户提供的品牌简报,自动构建一个采用 Atelier Zero 视觉语言的单页编辑式落地页。它通过让 AI 代理填充一个类型化的 `inputs.json` 文件来捕捉所有品牌信息(如名称、Logo、导航、英雄区、关于、能力、实验室、方法论、作品展示、推荐语、行动号召和页脚)。之后,代理可以决定图像策略:使用占位符、通过 `gpt-image-2` 生成 16 张超现实拼贴图,或引入用户自己的资产。最终,一个纯函数编译器 (`compose.ts`) 会读取 `inputs.json` 和规范样式表 (`styles.css`),输出一个完全自包含的 HTML 文件。该页面集成了滚动显示动画(IntersectionObserver)和 Headroom 风格的粘性导航,并针对 1280、1080、880 和 560 像素断点进行了完全响应式设计。此技能主要面向 CLI 代理(如 Claude Code),其工作流程高度结构化,包括分步收集输入、决定图像策略、编译输出,以及(可选地)镜像到可部署的 Astro 站点。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/open-design-landing

在你喜欢的 AI 中提问

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

预览

来自技能 README

open-design-landing preview

文档

open-design-landing 是做什么的?

构建一个单页编辑式落地页(或幻灯片——参见同级的 open-design-landing-deck 技能) 采用 Atelier Zero 设计系统:暖纸背景,Inter Tight + Playfair Display 字体,斜体衬线强调 span,点状细线,珊瑚色终止圆点,滚动显示动画,以及 16 张超现实拼贴图。

这是 OpenDesign 营销页面的标准配方——示例输出就是您目前在 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 Star 计数。
  • 8 个带编号的罗马数字区块,采用纸纹背景: 英雄区(带 3 个统计环 + 4 步索引)、关于、能力(4 张卡片)、 实验室(5 张卡片 + 筛选标签 + 进度条)、方法论(4 步,含缩略图)、 精选作品(深色板块 + 2 张倾斜卡片)、推荐语(引文 + 5 个合作伙伴标志)、 行动号召(丝带 + 邮件胶囊)。
  • 页脚包含 4 个链接列 + 巨大的斜体衬线结尾词。
  • 每个区块的滚动显示动画(IntersectionObserver,遵循 prefers-reduced-motion)。
  • 在 1280 / 1080 / 880 / 560 断点下完全响应式。

工作流程约定

按顺序执行这四个步骤。代理应在进入下一步之前完成当前步骤,并且更倾向于向用户提出聚焦的问题,而不是自行编造文案。

1. 收集品牌输入

使用 AskQuestion(或您界面中的等效方法)分块收集品牌简报;不要将整个 schema.ts 抛给用户。将他们的答案映射到符合类型化形状的 inputs.json 中。

八个问题组,按顺序排列:

组架构字段最少答案数备注
1brand.{name,mark,tagline,description,location}5Mark = 单个字形(Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL 是必填项;许可默认为 Apache-2.0
3nav[](最多 5 个)3可选的计数徽章
4hero.{label,headline,lead,primary,secondary,stats}全部Headline 为 MixedText(无衬线+斜体+圆点)
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 查看完整的示例(OpenDesign 自身)。

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/

将 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 Star 计数获取器(自动从 brand.primary_url 检测)。

4. (可选)镜像可部署的 Astro 站点

对于可部署的生产输出,派生 apps/landing-page/ 包:将其复制到您的工作区,用 inputs.json 中的内容对齐 app/page.tsx,并将您的 <out>/assets/*.png 复制到 app/image-assets.ts / R2 URL 所期望的路径。使用 pnpm --filter @open-design/landing-page build 构建,以生成可直接用于任何 CDN 的静态 out/ 导出。

未来的迭代可能会捆绑一个编译器,能够在一个命令中从 inputs.json 生成完整的 apps/landing-page/ 目录树。在此之前,派生并编辑是支持的路径。


交付前的自检

在标记完成之前,代理必须验证:

  • <out>/index.html 在浏览器中打开时没有控制台错误。
  • 所有 16 个图片槽位均加载成功(DevTools 网络选项卡中没有 404)。
  • 标题中的斜体强调 span 以 Playfair 字体渲染(而非无衬线字体)。
  • 在每个 display h1/h2 末尾出现珊瑚色终止圆点。
  • 从顶部滚动到底部;每个区块都动画出现一次。
  • 调整窗口大小至 880px 和 560px;没有水平滚动条,没有重叠。
  • prefers-reduced-motion: reduce(DevTools → 渲染)干净地禁用所有过渡效果。
  • Lighthouse:对比度 AA,font-display: swap,英雄区没有布局偏移(CLS < 0.05)。

该技能中的文件

design-templates/open-design-landing/
├── SKILL.md                 # 本约定
├── README.md                # 快速入门
├── schema.ts                # 类型化输入(唯一真实来源)
├── styles.css               # Atelier Zero 样式表(唯一真实来源)
├── inputs.example.json      # OpenDesign 作为示例
├── 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 张拼贴图(OpenDesign 实例)
    ├── 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 中,以确保视觉上的一对一一致。

另请参阅

Individual skills in this repo

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

相关技能