Communitygithub.com

xenxorowdy/product-landing-site

使用 Next.js App Router、服务器组件和 CSS 模块构建一个与众不同且无障碍的软件产品营销网站。包含英雄区域、产品故事、交互式演示、定价、常见问题及大型文字标识页脚。

product-landing-site 是什么?

该技能通过提供一套经过实战检验的模板和参考文档,帮助开发者快速搭建一个设计精良、高性能且无障碍的单页营销网站。它源自真实的 Kesami 营销站点,强调“设计感而非模板感”,并严格遵循无障碍标准(高对比度、键盘友好)。 该技能生成的项目基于 Next.js App Router,优先使用服务器组件,将客户端交互限制在最小的“孤岛”中,通过修改 DOM 属性或 CSS 变量来驱动动画,因此完全不需要 React 状态管理、UI 库或 Tailwind。它包含完整的可构建脚手架、可选章节示例、用于生成安全强调色的脚本,以及设计系统、章节模式、动画与无障碍、文案撰写和验证步骤的详细参考文档。 工作流程非常系统化:先主动从产品仓库收集信息,复制脚手架进行构建,通过脚本计算品牌颜色,在中央配置文件中设置产品数据,编写虚构场景以确保各章节内容一致,最后按照严格清单进行构建和验证。该技能适用于 Claude Code、Cursor 等支持技能定义的 AI 代理平台。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add xenxorowdy/product-landing-site

在你喜欢的 AI 中提问

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

文档

产品营销网站

一个源自 Kesami 营销网站的配方,用于构建一个看起来经过精心设计而非套用模板的单一静态页面,并且经得起推敲:经过对比度检查、键盘友好、诚实地展示产品、速度飞快。

最终产物是一个由服务端渲染的各章节组成的 Next.js 页面。交互性被限制在少数几个小的客户端“孤岛”中,这些孤岛通过翻转 DOM 属性或 CSS 变量来实现交互,而不是重新渲染。没有使用 UI 库、Tailwind 或动画库。

包含内容

路径用途
assets/scaffold/一个完整的、可构建的站点(经过类型检查和 next build 验证)。直接复制即可,无需重新输入。包含占位内容和工作设计系统。
assets/optional-sections/来自原始站点的三个额外章节(前后对比、数据边界文件树、脚本墙)作为工作示例。未集成到主站点中。
scripts/accent.mjs为任何品牌色生成对比度安全的强调色变体。
scripts/capture.cjs通过离屏 Electron 窗口,以桌面端和手机端宽度截取运行中站点的截图,并按滚动步骤进行。
references/design-system.md设计令牌、主题、字体、间距、强调色对比度逻辑及其存在原因。在更改颜色或字体之前请先阅读。
references/section-patterns.md每个章节:它的用途、构建方式以及使其轻量化的技巧。在添加或重塑章节之前请先阅读。
references/motion-and-a11y.md运动预算、减少动画、无 JavaScript、触摸目标、水合陷阱。在添加任何动画或客户端代码之前请先阅读。
references/copy-and-facts.md语气、“单一场景”规则以及如何保持陈述真实。在撰写文案之前请先阅读。
references/verify.md在宣布站点完成之前需要运行的检查清单和命令。

工作流程

1. 收集输入信息(先看再问)

首先阅读产品的 README、包清单、定价/计划代码和发布工作流程;大多数答案都在那里。只询问用户无法找到的信息。你需要:

  • 产品名称、一句话承诺、目标用户以及一个使其脱颖而出的特点。
  • 平台、价格点和计划限制,每个都需要附上作为真实来源的文件。
  • 一个品牌色(任意十六进制值),或选择颜色的权限。选择一个单一颜色并将其作为唯一的信号色。
  • 是否有授权的显示字体。如果没有,脚手架中的开放许可替代字体(Instrument Serif)也可以。
  • 需要哪些章节。默认设置:英雄区域、滚动条、工作原理、提问/演示、定价、常见问题、结尾、页脚。当产品有需要时,可以添加隐私、语言或前后对比章节。
  • 站点位置。默认:产品仓库中的 website/ 文件夹,位于 npm workspaces 之外的独立包,以免影响应用的安装和锁文件。

2. 搭建脚手架

cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build

在编辑之前先运行一次构建,确保基线是绿色的。Mona Sans 在构建时从 Google Fonts 获取,然后由站点本身提供,因此首次构建需要网络。

3. 品牌化

  1. node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex> 打印出 --accent、--accent-display、扁平化的色调,以及按钮标签应该是深色还是白色。将这些放入 app/globals.css(--brand、--brand-hover、--brand-tint、--accent、--accent-display),并替换 app/icon.svg 和 app/opengraph-image.tsx 中硬编码的 #ff5e00 / #e25300。
  2. 在 components/Logo.tsx 和 Logo.module.css 中重新绘制标志(占位符是四个声音条)。保持使用 div 或内联 SVG,绝不能使用位图。
  3. 设置 lib/site.ts 中的 SITE(名称、slug、文字标识、标题、导语、行动号召、备注)。slug 还用于为 localStorage 中的货币偏好设置命名空间。

为什么使用脚本而不是目测:饱和的品牌色几乎无法在浅色页面上达到 4.5:1 的文本对比度,因此页面需要品牌色用于填充,以及一个更深色的版本来用于文本。猜测这个更深色版本正是站点出现对比度失败的原因。

4. 先有事实,后有文案

从产品自身的源文件填充 lib/site.ts(计划、平台、链接、常见问题),并将每个事实的来源记录在站点根目录的 README.md 文件中,标题为“事实来源”。将来源信息保存在 README 而不是代码注释中,以保持脚手架无注释。如果目标仓库或用户要求解释性注释,则遵循他们的要求。

然后阅读 references/copy-and-facts.md 并撰写文案。

5. 单一场景,处处共享

lib/demo.ts 包含一个单一的虚构场景,英雄区域模拟、产品故事和交互式演示都从中提取数据。将其替换为来自产品自身领域的场景(例如工单、拉取请求、日历、电子表格、会议)。由于每个章节读取相同的数据,页面永远不会自相矛盾,并且演示可以诚实地展示产品的真实约定(例如,每个声明都引用其来源)。

6. 章节

从脚手架的九个章节开始。对于每个章节,决定:它承载什么单一理念?哪个单一视觉元素能够证明它,而不是仅仅描述它?阅读 references/section-patterns.md。遵循章节语法:

  • 标签芯片(.label,带有 data-scramble),然后是一个 h2.display.h2,最后几个词放在 .em 中,然后是一个可选的 .lead
  • 章节交替使用 data-theme="light" / "paper",这样每个章节都从颜色边缘开始,而不是从分割线开始
  • 每个视口一个填充按钮;其他所有内容都是带品牌下划线的文本链接
  • 产品模拟使用 data-theme="dark" 和 px 尺寸,因为它们代表(深色)应用的截图。如果应用是浅色的,则将模拟设为浅色。

7. 验证

遵循 references/verify.md。简而言之:类型检查、构建、使用 scripts/capture.cjs 在 1440 和 390 宽度下截图、检查截图、按滚动步骤确认揭示效果触发、检查减少动画和无 JavaScript 情况、对任何新文本颜色重新运行 accent.mjs --check。如实报告未验证的内容,而不是暗示已通过。

不可妥协项及其原因

  • 默认使用服务器组件;客户端孤岛仅用于行为。 页面是无 JavaScript 也能工作的静态 HTML,水合成本极低。孤岛写入 data-* 属性或 CSS 变量,让 CSS 完成视觉工作。
  • 组件仅使用语义令牌。 组件读取 --bg、--fg、--accent;章节的 data-theme 会交换它们。这就是同一个组件无需修改即可放置在画布、白色、色调或深色模拟上的方法。
  • 文本尺寸用 rem,模拟用 px。 读者的浏览器文本大小必须适用于页面;模拟是截图的替代品。
  • 暗淡文本通过颜色暗淡,而不是通过透明度。 透明度会悄无声息地将对比度降至 4.5:1 以下。
  • 文案绝不能超出产品现状。 没有未发布的平台、不存在且有效的支持地址、如果音频流式传输到服务器则不能说“数据不会离开你的设备”。过度承诺的营销页面是一个 bug。
  • 没有内置的动画暂停控件。 循环动画会为 prefers-reduced-motion 停止。Kesami 的设计评审故意拒绝了暂停控件,因此脚手架中没有;如果用户需要,可以提供一个。

扩展脚手架

使用相同的原语创建新章节,而不是导入库:使用 CSS 自定义属性表示状态、每个行为使用一个 IntersectionObserver、使用 details/summary 进行展开、使用 position: sticky 实现滚动叙事、使用 @property 动画化变量。如果你发现自己打算使用 framer-motion 或轮播包,请先重新阅读 references/motion-and-a11y.md;答案几乎总是一个 CSS 变量和一个属性。

相关技能