Communitygithub.com

jhy0285/monofield

根据品牌简报生成一份世界级的单页编辑型落地页,采用 Atelier Zero 视觉语言(Monocle / Apartamento / Études 编辑拼贴风格)——与 Open Design 自身使用的营销页面美学完全一致。Agent 会基于品牌简报填充带类型的 `inputs.json`,可选通过 gpt-image-2 生成 16 张拼贴素材,然后运行纯函数组合器生成一个自包含的 HTML 文件;另一条路径可在 `apps/landing-page/` 中镜像 Astro 营销站点。滚动出现动画和 Headroom 风格的固定导航将自动接入。

monofield 是什么?

该技能用于构建一个单页编辑型落地页(或幻灯片演示),它基于 **Atelier Zero** 设计系统:暖纸背景、Inter Tight + Playfair Display 字体、斜体衬线强调、虚线细线、珊瑚色终止点、滚动出现动画以及 16 幅超现实拼贴画。这是 Open Design 营销页面的规范做法,其示例输出就是您在 [open-design](https://github.com/nexu-io/open-design) 上看到的页面。 该技能完全**参数化**。Agent 会通过用户提供的品牌简报填充一个带类型的 `inputs.json`;组合器将该 JSON 与规范的 `styles.css` 结合,生成一个可部署的 HTML 工件。它支持三种图片策略:占位符(免费快速)、生成(通过 gpt-image-2 创建原始拼贴画,约需 6 分钟和 0.40 美元成本)或自带(直接使用已有的 PNG 文件)。 该技能适用于 Cursor、Claude Code 等 AI Agent 平台。工作流程包括四个步骤:收集品牌输入、决定图片策略、组合工件、以及可选的镜像 Astro 站点。Agent 必须通过结构化的问答按顺序完成每个步骤,并在交付前使用内置清单进行自检,包括检查无控制台错误、所有图片加载正常、响应式布局正确以及符合无障碍标准。

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

在你喜欢的 AI 中提问

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

预览

来自技能 README

monofield preview

文档

open-design-landing

在 Atelier Zero 设计系统中构建一个单页编辑型落地页(或幻灯片演示——请参阅同级的 open-design-landing-deck 技能):暖纸背景、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 个合作伙伴图标)、行动号召(丝带 + 邮件按钮)。
  • 页脚包含 4 列链接 + 巨大的斜体衬线终结词。
  • 每个部分都有滚动出现动画(IntersectionObserver,遵循 prefers-reduced-motion)。
  • 在 1280 / 1080 / 880 / 560 断点下完全响应式。

工作流约定

按顺序执行以下四个步骤。Agent 应在继续之前完成每一步,并且宁愿向用户提出有针对性的问题,也不要擅自编造文案。

1. 收集品牌输入

使用 AskQuestion(或您 UI 中的等效功能)分块收集品牌简报;不要将整个 schema.ts 丢给用户。将他们的回答映射到符合类型定义的 inputs.json 中。

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

组Schema 字段最少回答数备注
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 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

将 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 站点

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

未来的迭代可能会打包一个组合器,该组合器能够通过一个命令从 inputs.json 生成完整的 apps/landing-page/ 目录树。在此之前,分叉再编辑是支持的路径。


交付前的自检清单

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

  • <out>/index.html 在浏览器中打开且无控制台错误。
  • 所有 16 个图片插槽均已加载(DevTools 网络标签页中无 404 错误)。
  • 标题中的斜体强调范围以 Playfair 字体渲染(而非无衬线字体)。
  • 每个 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  # 人类可读的提示包

边界

  • 不要发明新的颜色或字体。令牌存在于 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 10 individual skills — each has its own dedicated page.

jhy0285/monofield

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

jhy0285/monofield

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

jhy0285/monofield

A standalone pricing page — header, plan tiers, feature comparison table, and an FAQ. Use when the brief asks for "pricing", "plans", "subscription tiers", or a "compare plans" page.

jhy0285/monofield

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jhy0285/monofield

Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.

jhy0285/monofield

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jhy0285/monofield

Use this plugin when the user wants a premium, GSAP-driven cinematic B2B landing page: a scroll-driven full-screen video slider hero with clip-path ellipse transitions, SplitText char-reveal headlines, a masonry product gallery, scroll-reveal about text, a partner marquee, Lottie-style feature cards, and a multi-office footer. Invoke for 'cinematic landing page', 'video hero landing', 'bakery / food-service landing', 'GSAP scroll site', or when the user references the Cinematic Landing Page template.

jhy0285/monofield

Use this plugin when the user wants a single-page immersive parallax landing page with a scroll-driven portal/curtain entrance and a curved arc card slider — a 'dreamcore' / 'reverie' hero that scales a portal image toward the viewer as the user scrolls into a second dream-world scene. Invoke for 'parallax landing', 'scroll cinematic hero', 'portal zoom landing', 'arc card slider', or when the user references the Dreamcore Landing template.

jhy0285/monofield

Use this plugin when the user wants a dark, pure-monochrome newsletter / content-platform landing page (Mindloop): fullscreen video hero, Instrument-Serif italic accent words, liquid-glass controls, scroll-driven word-by-word mission reveal, and an HLS-video CTA. Invoke for 'Mindloop landing', 'black monochrome newsletter landing page', 'video hero content platform', or when the user references the Mindloop template.

jhy0285/monofield

Programmatic video creation with React. Useful for branded explainers, social cuts, dashboards-to-video, and reproducible motion graphics.

相关技能