Communitygithub.com

omd:landing — 压倒性单页设计

基于 `DESIGN.md` 品牌事实与「着陆页工艺法典」构图规则,生成从概念、资产到滚动编排的完整单页着陆页。触发词:'랜딩 페이지', '원페이지', 'landing page', 'one-pager', 'hero to footer', '스크롤 랜딩', 'affinity.studio 같은'。

omd:landing — 压倒性单页设计 是什么?

omd:landing 是一个面向 AI 辅助设计工具的深度技能,专注于生成视觉上压倒性的单页着陆页。它不依赖堆砌卡片网格,而是通过一个统一的视觉概念在 Hero 区域诞生,随页面滚动在各 section 中以不同构图变奏,最终在 CTA 处收束。技能核心输入包括项目的 `DESIGN.md`(提供品牌事实、视觉令牌和运动令牌)和「着陆页工艺法典」(`landing-craft-codex.md`,提供 50+ 条基于 5 个参考站点实测数据的规则)。执行流程分为六个阶段:概念构思(art director agent)、故事板编排(6-8 section,含密度预算)、资产生成(通过 `omd:media` 通道调用图像/视频)、独立 HTML 构建(符合 WCAG 对比度、响应式、无障碍)、自评循环(通过 4 个工具和 design review agent 检查缺陷)、以及最终演示输出。技能硬性规则包括:禁止发明 `DESIGN.md` 中不存在的令牌、禁止使用真实竞品资产、只在发生冲突时 `DESIGN.md` 优先于法典、一张页面不分裂。适用于 Claude Code、Cursor、Codex 等支持定制技能的 AI 代理平台。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-landing/tree/HEAD

在你喜欢的 AI 中提问

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

文档

omd:landing — 压倒性单页设计 是做什么的?

一个页面通过滚动层层叠加,给访客以压倒性的视觉体验。它不是堆砌卡片网格,而是让一个统一的视觉概念从 Hero 区域诞生,在每个 section 中以不同的构图变奏,最终在 CTA 处收束。 品牌依据来自项目 DESIGN.md,构图观测来自着陆页工艺法典(规则 ID LC-n),产品行为和局部决策的权限来自 Brief。 法典位置 — 仓库: docs/design-excellence/landing-craft-codex.md · 安装版: node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md (如果两者都不存在,则通过 node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))" 找到包根目录,然后读取其下的 docs/design-excellence/)。 如果都没有读取到,则不开始执行。

输入

  1. DESIGN.md 全文(Core v2 则包含 §Scope·Foundations·Components·Content·Motion 锚点,旧版则包含所有章节)。 只使用这里出现的令牌 — 禁止发明。.omd/preferences.md 中的待定内容会覆盖 DESIGN.md。
  2. 至少一行 Brief:访客应该感受到什么 + 应该做什么。如果没有,则通过一轮问题(最多 5 个)来收集。 在无人值守模式(unattended)下,对每个问题选择第一个选项,并在 trace.md 中记录为 autoSelected。
  3. 法典 landing-craft-codex.md — 直接读取规则表格,选择本次运行要应用的规则 ID 并写入 storyboard。

运行目录(先创建)

SLUG=$(printf '%s' "<brand-or-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<Brief 原文>" > "$RUN/task.md"

<run> = 上述 $RUN。所有产出必须写入此目录(遵循 omd-harness 惯例,在 .omd/runs/INDEX.md 末尾追加一行)。

产出(仅位于 run 目录内)

<run>/
  concept.md        艺术指导产出 — 概念一句话、氛围、调色板用法、资产方向、禁止列表
  storyboard.md     section 表:顺序·目的·视口高度·构图(LC-n)·资产计划(提示词)·滚动编排·文案骨架
  assets/           生成的图像(通过 omd:media 通道) + 内联 SVG 源文件
  render.html       独立文件(零外部请求),适配 1440·390 视口,使用 IntersectionObserver 实现 reveal,pinned 最多 1 个,支持 reduced-motion
  system.md         此页面的设计系统说明(含令牌引用路径)
  loop-trace.json   自评迭代中各工具的缺陷计数(render-integrity·landing-integrity·designer-review),autoSelected
  trace.md          图像提示词原文、通道、成本、sha256、重试信息

流程

1. 概念(agent omd-art-director)

从 DESIGN.md 的品牌事实(§1 叙事、§Principles、§Voice)和 Brief 中提炼出概念一句话。 概念不是形容词的堆砌,而是页面在“展示什么”(例如:“像剖开支付管道一样展示资金的流动”)。 艺术指导将概念、氛围、资产方向、禁止项(来自法典的反模式 + Vercel 的「generated-design reflexes」 类规则)写入 concept.md。在构建之前,在该文件中放置适用范围表: 决定 | 依据类型(品牌事实/授权项目决定/法典观测) | 来源·目标 surface | 本次应用/未解决原因 | 验证方法。 公开控件的平面观测是该控件的证据,而不是禁止所有着陆对象、3D、照明的理由。 不得将局部场景编排升级为企业事实,也不得创建未经确认的令牌。如果来源和目标不同,则作为审查理由保留。 对调用提示中已有的资产,用文字描述其内容(主体、构图、主色调、留白位置;像素尺寸通过 sips -g pixelWidth -g pixelHeight 获取)。 艺术指导不得通过 Read 打开图像文件 — 曾因大图像 tool_result 导致会话卡死(dogfooding 2026-09-02)。

2. Storyboard

6~8 个 section。每个 section 包含:(a) 目的一句话,(b) 视口高度(引用法典的 section 节奏规则), (c) 构图模式 — 使用法典表格中的模式名称和 LC-n(bleed / inset / stacked / split / pinned-reveal …), (d) 资产计划 — 类型(照片/渲染/插画/抽象 UI)、揭示的产品状态/含义、比例、布局、主体在屏幕上的目标占比、生成提示词原文(将品牌调色板 hex 锁定在提示中),(e) 滚动编排(reveal 方式,持续时间和缓动使用 DESIGN.md 的 Motion 令牌),(f) 文案骨架。 需要确定一个压倒点 — 页面达到顶峰的 section 以及其之前的留白 section。

密度预算(用量化数字表示 — 仅描述会导致空页面)

仅靠数量和比例并不能证明有意义的场景。保留以下数值,但必须为每个资产规划其揭示的产品状态/含义以及实际主体在容器中的占比面积,并在渲染中验证。禁止使用仅为凑数的重复 SVG、同一张空白裁剪/放大版、无意义的卫星图像。

与 omd-restraint 的边界 (LC-59 密度拨盘)。 以下下限在拨盘 ≥ 6(展示型着陆页)时全部应用。 当拨盘 ≤ 5(产品/目录/文档页)时,omd-restraint 的上限(首屏碎片 ≤ 5、字体大小 ≤ 4、CTA ≤ 2 …)优先。 无论哪种情况,R1(一个焦点)、R2(首屏碎片)、R10(事实只出现一次)都保持不变。

  • 媒体总量 ≥ 页面 vh × 1.0。 12vh 的页面需要至少 12 个媒体。计算图像、视频、有意义的內联 SVG(不计算单个图标 — 仅计算 ≥ 24px、非装饰、有内容的媒体)。
  • 首屏媒体数(above the fold) ≥ 3 个。 根据法典实测,affinity 首屏有 8 个媒体。
  • 如果使用水平滚动 (LC-15),则项目数 ≥ 8 个。 3~4 项的横向滚动是空行,而非密度调节阀。
  • Motion 资产 ≥ 1 个。 如果 omd:setup 已预留视频通道,则使用 image_to_video 将某个 section 资产制作成 6 秒循环视频。 在 prefers-reduced-motion 下,用同一帧的静态图像替代(自动播放·静音·loop·playsinline)。 如果没有通道,在 trace.md 中记录此事实 — 不得静默跳过。
  • 每个 section 的油墨目标 ≥ 26%(法典实测范围 26–54% 的下限)。不足则调整内边距、主体大小或所需状态表现。
  • 不要将所有 section 的垂直内边距统一为固定 vh。 首次输出时所有 section 均为 18vh/24vh,导致节奏缺失(中位数 = 最大值 = 378px)。密度低的 section 减少内边距,仅在压倒点前后使用大留白。

3. 资产

通过 omd:media 检测到的通道执行 storyboard 中的提示语(无通道 → 将提示包和手动队列留在 assets/QUEUE.md,并在其位置放置使用品牌调色板的抽象 SVG 占位符 — 禁止使用库存图片或 emoji)。 禁止生成人物面部照片、禁止生成 logo(文本 wordmark 除外)。每个图像的提示语、通道和成本记录在 trace.md 中。 失败的生成根据原因修正,通道限制和占位符的实际数量记录在 trace.md 中。 如果单个原始场景能完成目的,则不要增加复制品,而是用该构成渲染审查版。密度预算不达标和原始 checker FAIL 应原样保留,作为应用边界审查的依据。审查版生成不是完成、豁免或 PASS。 图像宽高比必须来自其所在 slot 的实际宽高比(禁止默认值 — 参见 omd:media §1)。

4. 构建

独立 render.html。CSS 变量直接使用 DESIGN.md 的令牌名称(--color-…、--space-…)。 重置 UA 默认样式(figure/blockquote 边距 — 参见 issue #78)。图像使用 assets/ 相对路径或 data URI。 运动仅使用 transform 和 opacity,持续时间不超过 3 步,@media (prefers-reduced-motion: reduce) 下全部停止。 文本最大宽度、类型比例、section 高度均需落在法典数值范围内。 照片上方的文字必须有遮罩(scrim)(LC-36 "压倒性必须可读"):Hero、固定阶段、反转 section 的导航、wordmark、lead、CTA、焦点环必须与背景像素对比度达到 WCAG 4.5:1(正常文字)、3:1(大文本/UI),手段是令牌颜色的 alpha 遮罩(::before)和焦点环 halo — 第一次 toss 运行时因无遮罩导致 nav 1.05:1、wordmark 1.07:1 收到 BLOCK 6。 muted 系列令牌不得用于任何正文文本(包括 eyebrows 和法律声明),因为对比度仅 3.0:1。滚动 reveal(opacity:0)在 <noscript> 和 @media (scripting: none) 下必须全部可见 — 无 JS 时空页面是缺陷。 对比度、键盘要求和本技能的触摸可操作性目标是观测到的品牌几何属性。如果现有令牌组合无法满足,在适用范围表中提出必要的局部决策并遵循权限边界。不得以品牌一致性为由免除无障碍失败。

5. 自评循环(最多 3 次 — 在所有适用检查完毕后进行判定)

对于包含 test-v2/tools/ 的仓库使用左侧路径,否则(安装包)使用括号内的 omd 命令 — 它们指向相同的工具。

① node test-v2/tools/render-integrity.mjs <run>/render.html   (安装版: omd check render <run>/render.html)      # 确定性检查
② node test-v2/tools/landing-integrity.mjs <run>/render.html  (安装版: omd check landing <run>/render.html)     # 法典机器规则
②′ node test-v2/tools/text-contrast.mjs <run>/render.html     (安装版: omd check contrast <run>/render.html)    # 照片/渐变上的文本·焦点环·no-JS (前两次运行的 BLOCK 类)
③ 实际路由的 1440·390 截图:对比各 section 边界和 hero·peak·操作·结果状态与 storyboard
③-b 记录 LI-24~26 密度下限(画面油墨 12%·首屏媒体 3 个·媒体 1 个/vh)的原始判定和应用边界审查

④ 衍生 `omd-designer-review` 子 agent (Agent, 输入: <run>/render.html 绝对路径 + 项目 DESIGN.md 路径 + 工具调用上限 20 次·15 分钟·先输出 review.md 骨架 — 仅汇总 BLOCK)

③ 不止是截图。实现者必须直接检查图像,确认标题、主体、对应控件和结果是否进入画面。注意不要将大 section 的 scrollIntoView 中央裁剪误认为是 section 开始。将视口、滚动位置、状态、输出 hash 绑定在一起,裁剪的帧需要重新截图。滚动/镜头路径也需通过实际输入验证,不得仅通过 QA seek 来断言连续性。 记录每个资产主体面积的测量方法和实测值,与目标占比进行对比。如果是估算值,标注为估算。

对于包含操作的页面,实际执行适用项:empty → 错误输入的內联错误 → correction → save → reload、 键盘进入/执行/返回、渲染的触摸目标 ≥44×44 CSS px(本技能的可操作目标,正文内联链接除外)、no-JS·reduced-motion 备选。 错误需验证字段链接、焦点、aria-invalid,保存结果需验证对应内容及持久性。对于无保存功能等不适用项,记录 task 依据,不得用开发者状态切换器替代操作。

仅修复 FAIL 项。在 loop-trace.json 中记录每个工具的缺陷、操作证据、帧检查、④BLOCK、未执行项。 即使 ①② 通过,也不跳过对比度、操作、实屏、独立审查。只有在所有适用检查完成且无未解决的 FAIL/BLOCK 时,验证才算完成。如果缺陷不再减少或同一 rule ID 连续 FAIL 两次,则停止修复循环并提交到 omd:issue。 中断不算成功,未执行的检查应保留。来源冲突审查和原始 checker 判定应分开保存,不得创建任意豁免。

6. 演示

使用 omd:showcase <run>/render.html 创建滚动视频(mp4/gif)(如果没有,则使用 test-v2/content-runs/build-scroll-compare.mjs 帧捕捉 → ffmpeg)。底部需显示非正式通知。 区分实际输入视频和静态帧蒙太奇。验证结果与用户的视觉采纳是分开的,在用户采纳该结果之前,不得断言审美批准或采纳完成。

法典应用摘要(完整内容见法典;此处说明各阶段参考哪些规则)

阶段规则核心数据(实测,来自 5 个站点)
概念·首屏LC-13, LC-3336首屏资产覆盖视口的 89130% 且至少 2 边 bleed;标题位于上方 1/3(17.639.7 %vh);左侧锚点 5.4~14.4 %vw;顶点要早且以大尺度实现(前一个 section 文本比例最低 → 下一个 section 最高)
节奏LC-8~12, LC-14页面 1016 vh(排除固定元素);正文 section 中位数 1.01.9 vh;固定舞台恰好 1 视口;reveal 0.1~6.8/视口取决于拨盘;禁止垂直 snap
构图·留白LC-4~7section 的 4674% 为空白;文本占 section 的 2.613.6%;两条轨道(bleed 1440 + 阅读宽度 672/1232/1264);页面上只有一个 gutter(48/88/92/104px)
资产LC-17~20, §6 表每页 2963 张·每 section 37 张;bleed 资产为 16:9;布局只有 bleed 或 inset(圆角、底部裁剪)两种;库存为 0 — 仅产品·客户的成果
字型LC-21~25display:body 3.04.6×(衬线字体为 7×);正文 1417px;UI 缩放 1.051.20,顶部一次跳转 1.331.75;重量对比度小(300/300 也存在);仅拉丁 display 字间距 −0.02em
颜色·过渡LC-26~28保持一个背景色(252 或 12);仅反转一个 section(强调装置);色调约为 240,240,252
运动LC-13, LC-29~32主导持续时间一个(100/300/320/400ms,占 3370%);23 步,第二步为 1.3~1.6×;仅 opacity(+transform),无 clip-path·filter 0;reduced-motion 必须
自评LI-1~23 · #86landing-integrity.mjs 机器判定(页面 vh·section 比例·首屏覆盖率·类型比·gutter·持续时间·缓动·snap·视频属性·库存主机·均质卡片网格·h1) · text-contrast.mjs 检查照片上文本对比度·焦点环·no-JS

硬规则

  • 禁止发明 DESIGN.md 中不存在的令牌或品牌事实。禁止发明法典中不存在的“品味”规则 — 无依据的判断应在 concept.md 中标记为「假设」。
  • 如果法典数值与 DESIGN.md 令牌冲突,则以 DESIGN.md 为准(例如:法典 LC-21 display:body 3.0×↑ vs 实际 h1 36/body 14 = 2.57×)。 先确认适用对象是否相同,将范围不足及依据记录在适用范围表中。这不自动视为 PASS。对于没有 Motion 令牌的 DESIGN.md(多数情况),使用法典 LC-29/30 的值(300/400ms 等)并将其标记为「局部扩展」。
  • 禁止使用真实网站原文、截图或 logo 原件。禁止编造统计数据。
  • 只制作一个页面。要求展开多页的需求应交给 omd:autopilot(多页面)。
  • 本技能是生成器。判定由工具和 omd-designer-review 进行 — 不得自称为“好”或“通过”。

相关技能