galyarder-design-landing 是做什么的?
在 Atelier Zero 设计系统中构建一个单页编辑式着陆网站(或幻灯片——请参见同级技能 galyarder-design-landing-deck):暖色纸张背景、Inter Tight + Playfair Display 字体、斜体衬线强调、点状细线、珊瑚色终止圆点、滚动揭示动画以及 16 张超现实拼贴图板。
这是 Galyarder Design 营销页面的标准配方——示例输出正是您在 galyarder-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 中。
八个问题组,按顺序:
| 组 | 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(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 结束词是一个 MixedText,如同标题 |
打开 inputs.example.json 查看完整的示例(即 Galyarder 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/
将 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 @galyarder-design/landing-page build 构建,以生成可部署到任何 CDN 的静态 out/ 导出。
未来的迭代可能会提供一个组合器,可以通过一个命令从
inputs.json生成完整的apps/landing-page/树。在此之前,fork-并-编辑是受支持的路径。
交付前的自查
在标记完成之前,代理必须验证:
-
<out>/index.html在浏览器中打开时没有控制台错误。 - 所有 16 个图像插槽成功加载(DevTools 网络选项卡中没有 404)。
- 标题中的斜体强调跨度以 Playfair 字体渲染(不是无衬线字体)。
- 每个
displayh1/h2 末尾都出现珊瑚色终止圆点。 - 从顶部滚动到底部;每个章节动画只播放一次。
- 调整到 880px 和 560px 宽度;没有水平滚动,没有重叠。
-
prefers-reduced-motion: reduce(DevTools → 渲染)干净地禁用过渡。 - Lighthouse:对比度 AA、font-display swap、英雄区无布局偏移(CLS < 0.05)。
此技能中的文件
skills/galyarder-design-landing/
├── SKILL.md # 本契约
├── README.md # 快速入门
├── schema.ts # 类型化输入(单一真理来源)
├── styles.css # Atelier Zero 样式表(单一真理来源)
├── inputs.example.json # Galyarder 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 张拼贴图板(Galyarder 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/galyarder-design-landing-deck/—— 同级幻灯片技能,重用此设计系统。
