Communitygithub.com

KazmerMaximiliano/neus-ui

生成完整的 SaaS 著陸頁,包含英雄區塊、功能介紹、社交證明、價格方案與頁尾行動呼籲。產出 .tsx 檔案,並使用 Neus UI 的 Button、Card 與 Link 元件,搭配自訂導覽列。

neus-ui 是什麼?

這項技能會為你的 SaaS 產品自動產生一個專業的行銷著陸頁,產出三個檔案:TypeScript 型別定義、React 元件與 CSS 樣式。它使用 Neus UI 元件庫(Button、Card、Link)來建構頁面,並支援明暗主題模式。在開始前,技能會引導你收集所有必要資訊,包括產品名稱、標語、功能亮點、價格方案、社交證明、主要 CTA、導覽項目、主題色與視覺風格。接著根據你的選擇(如深色或淺色模式)來套用對應的樣式配方。最終產出的頁面結構包含導覽列、英雄區塊、功能卡片網格、可選擇的社交證明與價格方案區塊,以及頁尾行動呼籲。這項技能嚴格遵循無虛構資料原則,所有內容都必須來自使用者輸入,確保產出結果真實可用。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Neus Landing SaaS

生成一個產品著陸頁,包含英雄區塊、功能介紹、可選的社交證明、可選的價格方案與頁尾行動呼籲。

重要:此頁面不使用 AppTemplate。這是一個公開的行銷頁面。

開始之前

以下「共享規則」區塊始終有效。此外請閱讀:

  • .agents/skills/_shared/anti-slop.md — 強制性品質規則(「行銷頁面」章節)
  • .agents/skills/_shared/prop-constraints.md — 禁止使用的 props 與不存在的元件
  • .agents/skills/_shared/component-catalog.md — Button、Card、Link 的說明
  • .agents/skills/_shared/theme-config.md — ThemeProvider 設定
  • .agents/skills/_shared/design-personality.md — VISUAL DIRECTIVE 格式、個性軸
  • .agents/skills/_shared/checklist.md — P0/P1/P2 關卡
  • .agents/skills/_shared/dark-surfaces.md — 深色模式 CSS 配方(當模式為 dark 時閱讀)
  • .agents/skills/_shared/light-surfaces.md — 淺色模式 CSS 配方(當模式為 light 時閱讀)
  • .agents/skills/_shared/layout-patterns.md — 可選的進階著陸模式
  • references/landing-sections.md — 區塊模式

階段 0 — 收集資料

在產生頁面之前,向使用者提出以下問題,並等待完整回覆:


價格方案 — 著陸頁是否要包含價格方案區塊?

  • 是,包含方案與價格(建議) — 顯示價格方案卡的區塊
  • 否,僅英雄區塊 + 功能 + CTA — 不含價格方案的著陸頁

社交證明 — 是否包含社交證明(見證或數據)?

  • 是,真實的見證/數據 — 使用者將提供
  • 否,不需要社交證明 — 完全省略見證區塊

同時在回覆中包含:

  • 產品名稱與標語(1 行)
  • 要突顯的功能(最多 6 個,格式:標題 + 簡短描述)
  • 主要 CTA:按鈕文字 + 目標連結
  • 如果包含價格方案:方案(名稱 + 價格 + 週期 + 包含的功能)
  • 如果包含社交證明:確切的見證或數據(如果說「否」,則完全省略)
  • 主要主題色(十六進位色碼或「使用預設」)
  • 導覽列項目(導覽連結)
  • 主題模式:淺色或深色?(預設:淺色)
  • 視覺個性:簡潔通風、編輯層疊、大膽動感、結構分明?(可選)

階段 1 — 視覺解析

在撰寫任何程式碼之前,先解析 VISUAL DIRECTIVE:

  • 模式:dark → 閱讀 dark-surfaces.md;使用 #0a0a14 背景,玻璃導覽列,功能區使用 <Card variant="glass">,英雄區按鈕使用 color="white"
  • 模式:light → 閱讀 light-surfaces.md;使用 var(--color-white) 背景,標準 <Card>,color="primary" 按鈕

宣告:

VISUAL DIRECTIVE
  Mode: dark | light
  Personality: [從收集資料或預設值:Structured]
  Surface file: dark-surfaces.md | light-surfaces.md

階段 1b — P0 驗證

  • 零虛構資料 — 所有內容都來自收集階段或使用者明確指定
  • 無 AppTemplate,無 Sidebar
  • 功能完全來自收集階段(不要添加「直覺式」等額外內容)
  • 如果說「不需要社交證明」→ 輸出中零見證

階段 2 — 產生成品

閱讀 references/landing-sections.md 中各區塊的模式。

依序產生三個檔案:ProductLanding.types.ts → ProductLanding.tsx → ProductLanding.styles.css。

ProductLanding.types.ts

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

export type Feature = {
  icon: string;
  title: string;
  description: string;
};

export type PricingPlan = {
  name: string;
  price: string;
  period: string;
  features: string[];
  cta: string;
  highlighted?: boolean;
};

export type ProductLandingProps = {
  // 靜態行銷內容 — 無 API props
  onGetStarted?: () => void;
};

基本元件結構

import { Button, Card, Link } from 'neus-ui';
import './ProductLanding.styles.css';
import type { ProductLandingProps } from './ProductLanding.types';

export const ProductLanding = ({ onGetStarted }: ProductLandingProps) => {
  return (
    <div className="landing">
      {/* 1. 導覽列 */}
      <header className="landing__nav">...</header>

      {/* 2. 英雄區塊 */}
      <section className="landing__hero">
        <h1>[產品名稱] — [收集階段的標語]</h1>
        <p>[收集階段的副標題]</p>
        <div className="landing__hero-cta">
          <Button label="[收集階段的 CTA]" variant="solid" color="primary" />
          {/* 英雄區塊中的次要連結:使用 type="primary" — 英雄區塊有淺色背景 */}
          <Link label="了解運作方式" type="primary" href="#features" />
        </div>
      </section>

      {/* 3. 功能介紹(完全來自收集階段的功能) */}
      <section className="landing__features">
        <h2>功能</h2>
        <div className="landing__features-grid">
          {/* 每項功能使用 Card — 完全依照指定內容 */}
        </div>
      </section>

      {/* 4. 社交證明(僅在要求且有資料時顯示) */}
      {/* 5. 價格方案(僅在要求時顯示) */}
      {/* 6. 頁尾行動呼籲 */}
      {/* 7. 頁尾 */}
    </div>
  );
};

功能卡片

使用 Card 搭配 icon、title 與 description 插槽:

<Card
  icon={<SomeIcon size={24} color="var(--color-primary)" />}
  title="[收集階段的功能標題]"
  description="[收集階段的功能描述]"
/>

價格方案卡

使用 Card 搭配 highlighted prop。在 children 中組合完整內容:

<Card highlighted={plan.highlighted}>
  {plan.highlighted && <span className="pricing__badge">最受歡迎</span>}
  <p className="pricing__name">{plan.name}</p>
  <div className="pricing__amount">
    <span className="pricing__price">{plan.price}</span>
    <span className="pricing__period">{plan.period}</span>
  </div>
  <ul className="pricing__features">
    {plan.features.map((f) => (
      <li key={f}><span aria-hidden="true">✓</span> {f}</li>
    ))}
  </ul>
  <Button
    label={plan.cta}
    variant={plan.highlighted ? "solid" : "outlined"}
    color="primary"
    fullWidth
  />
</Card>

缺少的 Neus UI 元件

  • NavigationBar:使用 <header> 搭配 flex 導覽 — 標記為待辦
  • TestimonialCard:使用 Card 搭配 avatarImage + blockquote 內容(若要求)

階段 3 — ProductLanding.styles.css

根據 VISUAL DIRECTIVE 套用模式。查閱 .agents/skills/_shared/layout-patterns.md 中的著陸頁章節,以取得可選的進階模式(統計列、區塊標題分割、英雄展示網格、緊湊卡片網格、眉標膠囊)。

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

/* 淺色模式(預設) */
.landing { font-family: var(--font-display); }
.landing__nav {
  position: sticky;
  top: 0;
  z-index: 100;
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem 2rem;
  /* 淺色玻璃導覽 */
  background: rgba(255, 255, 255, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
}
/* 深色模式導覽 — 當模式為 dark 時套用 */
/* .landing__nav { background: rgba(10, 10, 20, 0.8); border-bottom: 1px solid rgba(255,255,255,0.06); } */
.landing__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  align-items: center;
  gap: 3rem;
  padding: 6rem 2rem;
  max-width: 1200px;
  margin: 0 auto;
}
/* 如果右側沒有視覺元素,使用置中單欄: */
/* .landing__hero { text-align: center; padding: 6rem 2rem; max-width: 800px; margin: 0 auto; } */
.landing__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.03em;
  color: var(--color-gray-900);
  margin-bottom: 1rem;
  animation: neus-fade-up 0.5s ease forwards;
}
/* 深色模式 H1 — 漸層文字選項 */
/* .landing__hero h1 { color: #e2e8f0; }
   在 H1 元素上套用 .neus-gradient-text 以獲得漸層文字效果 */
.landing__hero p {
  font-size: 1.25rem;
  color: var(--color-gray-600);
  margin-bottom: 2rem;
  animation: neus-fade-up 0.5s 0.1s ease both;
}
.landing__hero-cta {
  display: flex;
  gap: 1rem;
  align-items: center;
  margin-top: 1.5rem;
  animation: neus-fade-up 0.5s 0.2s ease both;
}
.landing__features { padding: 6rem 2rem; max-width: 1200px; margin: 0 auto; }
.landing__features h2 {
  font-family: var(--font-display);
  text-align: center;
  font-size: 2rem;
  font-weight: 700;
  margin-bottom: 3rem;
  color: var(--color-gray-900);
}
/* 旗艦功能:第一張卡片佔滿全寬 */
.landing__features-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 2rem; }
.landing__features-grid > *:first-child { grid-column: 1 / -1; }
/* 交錯卡片動畫 */
.landing__features-grid > *:nth-child(1) { animation: neus-fade-up 0.5s 0.05s ease both; }
.landing__features-grid > *:nth-child(2) { animation: neus-fade-up 0.5s 0.15s ease both; }
.landing__features-grid > *:nth-child(3) { animation: neus-fade-up 0.5s 0.25s ease both; }
.landing__features-grid > *:nth-child(4) { animation: neus-fade-up 0.5s 0.35s ease both; }
/* 交替區塊背景 */
.landing__features-alt { background: var(--color-primary-light); }
/* 頁尾行動呼籲 */
.landing__cta-section { background: var(--color-primary-light); padding: 6rem 2rem; text-align: center; }

/* 深色模式頁面覆蓋 — 當模式為 dark 時套用 */
/* .landing { background: #0a0a14; color: #e2e8f0; } */
/* .landing__features h2 { color: #e2e8f0; } */
/* .landing__features-alt { background: rgba(20,20,40,0.4); } */
/* .landing__cta-section { background: rgba(99,102,241,0.1); border-top: 1px solid rgba(129,140,248,0.2); } */

共享規則(內嵌)

這些規則始終有效。即使未讀取 _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';

絕不要從內部路徑匯入,例如 ../../components/Button/Button。

型別

所有 type / interface 宣告 → ComponentName.types.ts。絕不要在 .tsx 中宣告型別。

React 19 — 禁止 FormEvent

絕不要 import { FormEvent } from 'react'。改為使用 <Button type="submit" onClick={...} />。

元件 Prop 限制

  • Button variant:"solid" | "outlined" | "text" — "ghost" 不存在
  • Button color:"primary" | "success" | "error" | "info" | "white" — "white" 僅用於深色背景
  • Button size:"small" | "medium" | "large"
  • Card variant:"default" | "glass" — "glass" 用於深色背景
  • Badge color:"primary" | "success" | "error" | "info" | "neutral"
  • Link type:"primary"(品牌色) | "secondary"(低調灰)
  • Select:無 required prop — 在外部處理驗證
  • FormTemplate:僅 children、submitLabel、loading — 無 onSubmit/onCancel

垃圾內容黑名單

  • 禁止內聯樣式 / style={{}} / <style> 標籤
  • 禁止資料來自 API 時使用硬編碼資料陣列 — 使用型別化 props
  • 禁止虛構文案(假見證、佔位名稱、假數據)
  • 禁止 any TypeScript 型別
  • 當存在 Neus UI 元件時,禁止使用原生 <a>、<span>、<input>、<button>
  • 禁止硬編碼字型堆疊 — 使用 var(--font-display) / var(--font-mono)
  • 在深色模式中:禁止使用 var(--color-primary-light) 作為區塊背景;禁止使用原生 div 卡片 — 改為使用 <Card variant="glass">

Individual skills in this repo

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

相關技能