Communitygithub.com

Neus 通用落地页

生成一个灵活、通用的着陆页,包含英雄区、内容版块和行动号召按钮,输出 .tsx 文件,使用 Neus UI 的 Button、Card 和 Link 组件,不包含 AppTemplate。

Neus 通用落地页 是什么?

该技能用于快速生成通用型落地页,适用于各种非 SaaS 产品的场景,如公司介绍、活动推广、个人主页、作品集等。它通过结构化的问答流程收集用户意图,自动解析视觉调性(如颜色、个性、模式),并生成三个标准文件:类型定义、组件和样式。技能强制要求不使用 AppTemplate,严格遵循 Neus UI 组件库规范,并集成了一系列共享规则以确保代码质量、设计一致性和无障碍性。支持亮色和暗色模式,暗色模式下所有表面使用玻璃效果,亮色模式使用标准卡片和主题色。这是 neus-landing-saas 的替代方案,适用于非 SaaS 主题。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KazmerMaximiliano/neus-ui/tree/HEAD/.agents/skills/neus-landing-generic

在你喜欢的 AI 中提问

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

文档

Neus 通用落地页 是做什么的?

生成一个通用着陆页,包含英雄区、内容版块和行动号召按钮。根据用户的用途进行适配。

重要:不包含 AppTemplate。这是一个公开页面。


开始之前

以下“共享规则”部分始终有效。此外,在第 0 阶段之前,请阅读以下所有内容:

  • .agents/skills/_shared/anti-slop.md — 强制性质量规则(“营销页面”部分)
  • .agents/skills/_shared/prop-constraints.md — 禁止的属性和不存在的组件
  • .agents/skills/_shared/component-catalog.md — Button、Card、Link、Input 部分
  • .agents/skills/_shared/design-personality.md — 个性轴、视觉指令格式、第 9 节暗色模式表面配方
  • .agents/skills/_shared/dark-surfaces.md — 暗色模式 CSS 配方(当模式为 dark 时读取)
  • .agents/skills/_shared/light-surfaces.md — 亮色模式 CSS 配方(当模式为 light 时读取)
  • .agents/skills/_shared/checklist.md — P0/P1/P2 检查项
  • .agents/skills/_shared/layout-patterns.md — 着陆页布局模式(数据统计行、版块分割的标题、英雄区眉毛药丸、自适应导航)
  • .agents/skills/neus-landing-generic/references/dark-landing-patterns.md — 暗色着陆页的版块布局结构和 JSX 模式

第 0 阶段 — 收集数据

向用户提出以下问题,并等待他们完整回复后再继续:


  1. 这是什么类型的页面?(作品集、公司、活动、代理商、博客、个人、其他)
  2. 页面名称/品牌
  3. 主标题 (H1) — 可以包含一个用于渐变色处理的强调词
  4. 标语或副标题
  5. 需要包含的版块(精确列出 — 不要额外增加)
  6. 主要行动号召按钮:标签 + 操作
  7. 次要行动号召按钮(可选):标签 + 操作
  8. 主色调(十六进制或描述)
  9. 模式:亮色还是暗色?
  10. 个性:简洁/通透、编辑/层次、大胆/动感、或结构化?(如果不确定,请描述风格)
  11. 是否包含联系表单或新闻通讯?(是/否 — 请具体说明)

第 1 阶段 — 视觉解析

在编写任何代码之前,根据收集到的答案解析出视觉指令。

调色板映射:

  • 鲜艳/充满活力的颜色 → Vibrant
  • 中性/柔和/灰色调 → Neutral
  • 企业蓝/绿 → Corporate
  • 紫色/粉色/创意色 → Creative

个性映射(来自问题 10):

  • 简洁/极简/通透 → Airy
  • 编辑/层次/不对称 → Layered
  • 大胆/强烈/动感 → Kinetic
  • 结构化/正式/数据密集 → Structured

构建以下代码块,并带入第 2 阶段:

视觉指令:
- 调色板:[Vibrant / Neutral / Corporate / Creative]
- 个性:[Kinetic / Airy / Structured / Layered]
- 模式:[light / dark]
- 动画:[neus-fade-up on .hero-copy / none]
- 布局:[不对称两栏英雄区 1.4fr/0.6fr / 居中英雄区]
- H1:[clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- 渐变文字:[是 — 强调词:"[word]" / 否]
- 表面:[玻璃效果 (dark-surfaces.md) / 标准 var(--color-white)]
- 导航:[玻璃效果粘性 / 标准粘性 / 无]

暗色模式规则: 如果模式为 dark,所有表面都使用 dark-surfaces.md 中的配方。切勿使用 var(--color-white) 作为页面或版块的背景。内容卡片使用 <Card variant="glass"> — 这是 Neus UI 的玻璃表面。切勿用原始 <div> + 自定义 CSS 替换它。

亮色模式规则: 如果模式为 light,内容卡片使用 Neus UI <Card>,交替版块背景使用 var(--color-primary-light),页面根元素使用 var(--color-white)。


第 2 阶段 — P0 验证

  • 输出版块 == 收集到的版块(问题 5)。零额外内容。
  • 无虚构文案 — 所有文本来自收集或明确由属性驱动
  • 无 AppTemplate 或侧边栏
  • 已构建视觉指令并向前传递
  • 暗色模式:所有表面使用玻璃配方,无 var(--color-white) 背景
  • 亮色模式:内容使用 Neus UI <Card>,交替版块使用 primary-light

第 3 阶段 — 生成文件

按此顺序生成 三个文件:PageName.types.ts → PageName.tsx → PageName.styles.css。


PageName.types.ts

import type { BadgeColor } from 'neus-ui';

export type NavItem = {
  label: string;
  href: string;
};

// 仅根据收集的数据添加版块特定类型
export type Article = {
  id: string;
  title: string;
  href?: string;
  excerpt?: string;
  author?: string;
  meta?: string;
  categories?: string[];
};

// 类别 → Badge 颜色映射(暗色模式:4 种视觉上不同的颜色)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type PageNameProps = {
  // 仅当数据来自外部时才使用属性(文章列表、表单处理程序等)
  // 静态营销文案应硬编码在组件中 — 绝不作为属性传入
};

PageName.tsx

暗色模式结构 — 正确的组件使用:

import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './PageName.styles.css';
import type { PageNameProps, Article } from './PageName.types';
import { BADGE_COLOR } from './PageName.types';

export const PageName = ({ articles, onSubscribe }: PageNameProps) => {
  const [email, setEmail] = useState('');
  const [subscribed, setSubscribed] = useState(false);
  const [loading, setLoading] = useState(false);

  const handleSubscribe = () => {
    setLoading(true);
    onSubscribe?.(email);
    setSubscribed(true);
    setLoading(false);
  };

  return (
    <div className="page-name">
      {/* 装饰性背景层 — aria-hidden,不可交互 */}
      <div className="page-name__mesh" aria-hidden="true" />
      <div className="page-name__grid" aria-hidden="true" />

      <div className="page-name__content">
        {/* 粘性玻璃导航 — 链接使用 <Link type="secondary"> */}
        <nav className="page-name__nav">
          <div className="page-name__nav-brand">
            <div className="page-name__brand-mark" aria-hidden="true">P</div>
            <span className="page-name__brand-name">PageName</span>
          </div>
          <div className="page-name__nav-links">
            {navItems.map(item => (
              <Link key={item.href} type="secondary" href={item.href} label={item.label} />
            ))}
          </div>
          <Button label="Subscribe" variant="solid" color="primary" size="small" onClick={() => {}} />
        </nav>

        <main>
          {/* 英雄区 — 不对称两栏 */}
          <section className="page-name__hero" aria-labelledby="page-name-title">
            <div className="page-name__hero-copy">
              {/* 眉毛药丸 — 原始 div(无 Neus UI 等效组件) */}
              <div className="page-name__eyebrow-pill">
                <span className="page-name__eyebrow-dot" aria-hidden="true" />
                PAGENAME
                <span aria-hidden="true">/</span>
                KEYWORD
              </div>
              <h1 id="page-name-title">
                Headline{" "}
                <span className="gradient-text">accent</span>
              </h1>
              <p className="page-name__hero-sub">Tagline from intake.</p>
              <div className="page-name__hero-cta">
                <Button label="Primary CTA" variant="solid" color="primary" onClick={() => {}} />
                <Button label="Secondary CTA" variant="outlined" color="primary" onClick={() => {}} />
              </div>
            </div>
            <div className="page-name__hero-visual">
              {/* 特色 Card 或艺术面板 — 参见 dark-landing-patterns.md §4 */}
            </div>
          </section>

          {/* 来自收集数据的内容版块 — 卡片使用 <Card variant="glass"> */}
          {/* 示例文章网格版块: */}
          <section className="page-name__articles">
            <div className="page-name__article-grid">
              {articles?.map(article => (
                <Card variant="glass" key={article.id} onClick={() => {}}>
                  <div className="page-name__article-inner">
                    <div className="page-name__pill-row">
                      {article.categories?.map(cat => (
                        <Badge
                          key={cat}
                          variant="solid"
                          color={BADGE_COLOR[cat] ?? "neutral"}
                          label={cat}
                        />
                      ))}
                    </div>
                    <h3>{article.title}</h3>
                    {article.excerpt && <p className="page-name__article-dek">{article.excerpt}</p>}
                  </div>
                </Card>
              ))}
            </div>
          </section>

          {/* 新闻通讯版块(如果要求) */}
          <section className="page-name__newsletter" aria-labelledby="page-name-nl-title">
            <div className="page-name__nl-card">
              <p className="page-name__sec-eyebrow">Newsletter</p>
              <h2 id="page-name-nl-title">
                Stay in the loop.{" "}
                <span className="gradient-text">No noise.</span>
              </h2>
              {subscribed ? (
                <p className="page-name__nl-success">✓ You're subscribed — thanks!</p>
              ) : (
                <div className="page-name__nl-form">
                  <Input
                    name="newsletter-email"
                    type="email"
                    label="Email"
                    placeholder="[email protected]"
                    value={email}
                    onChange={setEmail}
                    required
                  />
                  <Button
                    label="Subscribe"
                    type="submit"
                    variant="solid"
                    color="primary"
                    loading={loading}
                    onClick={handleSubscribe}
                  />
                </div>
              )}
            </div>
          </section>
        </main>

        {/* 页脚 — 链接使用 <Link type="secondary"> */}
        <footer className="page-name__footer">
          <span>© {new Date().getFullYear()} PageName.</span>
          <div className="page-name__footer-links">
            <Link type="secondary" href="/privacy" label="Privacy" />
            <Link type="secondary" href="/contact" label="Contact" />
          </div>
        </footer>
      </div>
    </div>
  );
};

亮色模式结构: 省略 mesh/grid div 和内容包装器。内容卡片使用 <Card>(无 variant)。交替版块背景使用 background: var(--color-primary-light)。主要链接使用 <Link type="primary">,导航/页脚使用 <Link type="secondary">。类别药丸仍使用 <Badge>。

特色磁贴(两种模式):

  • <Card variant="glass" icon={...} title="..." description="..." />(暗色)
  • <Card icon={...} title="..." description="..." />(亮色)

联系表单(如果要求): 使用 Neus UI <Input> 字段 + <Button type="submit">。与新闻通讯模式相同,但无需发光卡片包装器。


PageName.styles.css

暗色模式: 从 dark-surfaces.md §1 的画布 + mesh + grid + 内容配方开始。然后添加玻璃导航(§3)、nl-card(§4)、眉毛药丸(§5)、渐变文字(§6)、艺术面板(§8,如果有特色)、元数据行(§9,如果有文章)、页脚(§10)。无自定义卡片 CSS — <Card variant="glass"> 会处理。应用 dark-landing-patterns.md 中的布局。

亮色模式: 从 background: var(--color-white); color: var(--color-gray-900) 开始。交替版块背景使用 var(--color-primary-light)。遵循 design-personality.md 第 4–5 节的排版和间距。

两种模式:

@keyframes neus-fade-up {
  from { opacity: 0; transform: translateY(16px); }
  to   { opacity: 1; transform: translateY(0); }
}

.page-name__hero-copy {
  animation: neus-fade-up 0.5s ease both;
}

/* 渐变文字工具类 */
.gradient-text {
  background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* 最大宽度容器 */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
  max-width: min(72rem, 100%);
  margin: 0 auto;
}

/* 版块内边距 */
.page-name__hero       { padding: 6rem 2rem; }
.page-name__articles   { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }

/* 英雄区网格 */
.page-name__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  gap: 3rem;
  align-items: center;
}

/* H1 */
.page-name__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.04em;
  line-height: 0.98;
  margin: 0.5rem 0 1rem;
}

/* 新闻通讯表单 — 弹性行 */
.page-name__nl-form {
  display: flex;
  gap: 1rem;
  align-items: flex-end;
  max-width: 520px;
  margin: 0 auto;
}

/* 文章网格 */
.page-name__article-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.5rem;
}

/* 药丸行 */
.page-name__pill-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}

/* 响应式 */
@media (max-width: 960px) {
  .page-name__hero { grid-template-columns: 1fr; }
  .page-name__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
  .page-name__hero,
  .page-name__articles,
  .page-name__newsletter { padding: 5rem 1.25rem; }
}

共享规则(内嵌)

这些规则始终有效。即使未读取 _shared/ 文件,它们也适用。

输出 — 始终三个文件

每个技能输出:ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css。 无内联样式(style={{}})。组件内无 <style> 标签。CSS 仅放在 .styles.css 中。

导入

import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';

切勿 […] [已截断以进行翻译]

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能