Communitygithub.com

cosmasgicter/mihasv3

根据品牌简报生成一份世界级的单页编辑式落地页,采用 Atelier Zero 视觉语言(Monocle / Apartamento / Études 编辑拼贴风格),即 Open Design 自身营销页面所使用的美学。Agent 会从品牌简报中填充类型化的 `inputs.json`,可选通过 gpt-image-2 生成 16 幅拼贴素材,然后运行纯函数合成器输出一份自包含的 HTML 文件;另一个路径可镜像 `apps/landing-page/` 中的 Astro 营销站点。滚动揭示动画和 Headroom 式粘性导航均自动集成。

mihasv3 是什么?

这是一个用于构建单页编辑式落地页的 AI Agent 技能,以 Open Design 项目自身的营销页面为蓝本。它采用 Atelier Zero 设计系统,具有暖纸色背景、Inter Tight 和 Playfair Display 字体、斜体衬线强调、虚线细线、珊瑚色终止圆点、滚动揭示动画以及 16 幅超现实拼贴画等特征。该技能完全参数化:Agent 首先通过一系列结构化问答从用户简报中收集品牌信息,并填充一个类型化的 `inputs.json` 文件。然后,Agent 需要决定图像策略——是使用占位符、通过 fal.ai 调用 gpt-image-2 生成原创拼贴画,还是让用户提供自己的 PNG 图像。最后,合成器脚本将 `inputs.json` 与规范的 `styles.css` 结合,输出一个完全自包含的 HTML 文件,该文件内联了所有样式、滚动动画和粘性导航逻辑。此外,还有一个可选的流程,用于将生成的内容镜像到可部署的 Astro 站点结构中。该技能提供了详细的检查清单和明确的边界规则,确保开发者能够获得高质量、符合设计规范的成果。

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

在你喜欢的 AI 中提问

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

预览

来自技能 README

mihasv3 preview

文档

open-design-landing

构建一个单页编辑式落地页(或幻灯片——参见同级技能 open-design-landing-deck),采用 Atelier Zero 设计系统:暖纸色背景、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(或您界面中的等效工具)分块收集品牌简报;不要将整个 schema.ts 抛给用户。将他们的答案映射到与类型化结构匹配的 inputs.json 中。

八个问题组,依次为:

组Schema 字段最少答案数说明
1brand.{name,mark,tagline,description,location}5Mark = 单个字形 (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL 为必填项;license 默认使用 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 min
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 站点

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

未来的迭代可能会打包一个合成器,以一条命令从 inputs.json 生成完整的 apps/landing-page/ 树。在此之前,复制-编辑是受支持的路径。


交付前的自我检查

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

  • <out>/index.html 在浏览器中打开时无控制台错误。
  • 所有 16 个图像插槽已加载(DevTools 网络选项卡中无 404 错误)。
  • 标题中的斜体强调跨度以 Playfair 字体渲染(非无衬线字体)。
  • 每个 display h1/h2 末尾都出现珊瑚色终止圆点。
  • 从顶部滚动到底部;每个区块都激活一次动画。
  • 调整大小至 880px 和 560px;无水平滚动,无重叠。
  • prefers-reduced-motion: reduce(DevTools → 渲染)干净地禁用过渡。
  • 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 4 individual skills — each has its own dedicated page.

cosmasgicter/mihasv3

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

cosmasgicter/mihasv3

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.

cosmasgicter/mihasv3

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.

cosmasgicter/mihasv3

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.

相关技能