Communitygithub.com

KazmerMaximiliano/neus-ui

產生靈活的一般用途著陸頁,包含英雄區塊、內容區塊和行動呼籲。產生一個使用 Neus UI Button、Card 和 Link 的 .tsx 檔案。不使用 AppTemplate。

neus-ui 是什麼?

這個技能會根據使用者提供的詳細資料,產生一個一般用途的著陸頁元件。它會引導使用者完成資料收集階段,包括頁面類型、品牌名稱、主要標題、區段、行動呼籲、主題顏色、模式(淺色或深色)以及個性風格。然後,它會根據這些輸入解析一個視覺指令,在撰寫任何程式碼之前決定調色盤、個性、版面配置和動畫。此技能支援多種登陸頁面類型,例如作品集、公司、活動、代理商、部落格和個人頁面,並特別注意不使用 AppTemplate 或側邊欄。它會產出三個檔案:一個 TypeScript 類型檔案、一個 React 元件和一個 CSS 樣式表,並遵循嚴格的品質規則,包括禁止 props 限制、使用 Neus UI 元件,以及特定於模式的表面處理方式(深色模式使用玻璃表面食譜,淺色模式使用標準表面)。此技能與 Claude Code、Cursor 和 Codex 平台相容,旨在為非 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 Landing Generic

產生一個一般用途的著陸頁,包含英雄區塊、內容區塊和行動呼籲。會根據使用者的目的進行調整。

重要:不使用 AppTemplate。公開頁面。


開始之前

下方的「共享規則」區塊永遠有效。此外,請在「階段 0」之前閱讀以下所有內容:

  • .agents/skills/_shared/anti-slop.md — 強制性品質規則(「行銷頁面」章節)
  • .agents/skills/_shared/prop-constraints.md — 禁止的 props 和不存在的元件
  • .agents/skills/_shared/component-catalog.md — Button、Card、Link、Input 章節
  • .agents/skills/_shared/design-personality.md — 個性軸線、VISUAL DIRECTIVE 格式、第 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 — 視覺解析度

在撰寫任何程式碼之前,根據收集到的答案解析 VISUAL DIRECTIVE。

色票映射:

  • 鮮豔 / 充滿活力的顏色 → Vibrant
  • 中性 / 柔和 / 灰色調 → Neutral
  • 企業藍 / 綠 → Corporate
  • 紫色 / 粉紅 / 創意 → Creative

個性映射(來自問題 10):

  • 簡潔 / 極簡 / 輕盈 → Airy
  • 編輯 / 層次 / 不對稱 → Layered
  • 大膽 / 強烈 / 動感 → Kinetic
  • 結構化 / 正式 / 資料密集 → Structured

建立此區塊並帶入階段 2:

VISUAL DIRECTIVE:
- Palette: [Vibrant / Neutral / Corporate / Creative]
- Personality: [Kinetic / Airy / Structured / Layered]
- Mode: [light / dark]
- Animation: [neus-fade-up on .hero-copy / none]
- Layout: [asymmetric 2-col hero 1.4fr/0.6fr / centered hero]
- H1: [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Gradient text: [yes — accent word: "[word]" / no]
- Surfaces: [glass (dark-surfaces.md) / standard var(--color-white)]
- Nav: [glass sticky / standard sticky / none]

深色模式規則: 如果 Mode: dark,所有表面都使用 dark-surfaces.md 中的食譜。切勿使用 var(--color-white) 作為頁面或區塊背景。對內容卡片使用 <Card variant="glass"> — 這是 Neus UI 的玻璃表面。切勿將其替換為原始的 <div> + 自訂 CSS。

淺色模式規則: 如果 Mode: light,對內容卡片使用 Neus UI <Card>,對交替區塊背景使用 var(--color-primary-light),對頁面根元素使用 var(--color-white)。


階段 2 — P0 驗證

  • 輸出區塊 == 收集到的區塊(問題 5)。零額外內容。
  • 沒有虛構的文案 — 所有文字都來自收集到的資料,或明確由 props 驅動
  • 沒有 AppTemplate 或側邊欄
  • VISUAL DIRECTIVE 已建立並帶入
  • 深色模式:所有表面使用玻璃食譜,沒有 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[];
};

// 類別 → 徽章顏色映射(深色模式:4 種視覺上不同的顏色)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type PageNameProps = {
  // 僅適用於來自外部的資料(文章列表、表單處理器等)的 Props
  // 靜態行銷文案在元件中硬編碼 — 永遠不應作為 prop
};

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>
          {/* 英雄區塊 — 不對稱 2 欄 */}
          <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">來自收集資料的標語。</p>
              <div className="page-name__hero-cta">
                <Button label="主要 CTA" variant="solid" color="primary" onClick={() => {}} />
                <Button label="次要 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">✓ 您已訂閱 — 感謝!</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 的 canvas + mesh + grid + content 食譜開始。然後新增玻璃導覽(§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.

相關技能