Communitygithub.com

JairoBg03/skills

建立具備自訂設計、動畫與媲美代理商等級效果的專業登陸頁面,涵蓋從簡報、設計方向、建置、稽核到部署的完整流程,避免 AI 套版產生的千篇一律感。

skills 是什麼?

此技能為 AI 代理(如 Claude Code、Codex 或 Cursor)提供了一份建置專業登陸頁面的完整工作流程與技術規範。其主要目標是產出高品質、獨一無二且轉換率極高的登陸頁面,避免常見 AI 工具因套用模板而導致的「樣板感」。技能採用精實的技術棧:Astro 5(零預設 JavaScript 的靜態框架)、Tailwind CSS v4(透過原生 CSS 設計系統、自動清理)、GSAP 搭配 ScrollTrigger 與 SplitText(業界標準動畫庫)以及 Lenis(輕量平滑滾動)。它所要求的強制流程獨樹一格:專案啟動前必須先完成詳細的「簡報」與「設計方向」階段,接著才進入程式碼建置,這確保了設計決策的獨特性。該工作流程包含六個嚴格的階段:完善簡報模板、制定非樣板化的設計方向、規劃敘事結構、依循行動優先與動畫食譜進行建置、通過全面的稽核查核清單,最後進行部署。技能明訂特定命令、資源指南(如 `assets/brief-template.md` 與 `references/animation-recipes.md`),並嚴格禁止使用任何 UI 套件庫(如 shadcn 或 Flowbite),以確保成品視覺上完全原創且充滿動態活力。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JairoBg03/skills/tree/HEAD/landing-pages

在你喜歡的 AI 中提問

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

說明文件

使用時機

  • 使用者想要一個新的登陸頁面(產品、服務、活動、作品集、等候名單)
  • 使用者想要重新設計現有的登陸頁面,使其看起來專業且獨特
  • 使用者要求動畫、滾動效果或行銷頁面上的微互動
  • 使用者正處於規劃階段:討論需要哪些區塊、傳達什麼訊息、採用什麼結構

技術棧(與選擇理由)

項目選擇理由已淘汰的替代方案
框架Astro 5預設靜態(基礎 JS 為 0)、元件化、支援 astro:assets 處理圖片、部署只需上傳 dist/Next.js(對登陸頁來說過於複雜,部署較麻煩)、純 HTML(缺乏元件與優化)
樣式Tailwind CSS v4透過 CSS 的 @theme 使用自有 Token,無需 JS 設定檔,自動清除未使用樣式UI 套件(shadcn/DaisyUI/Flowbite → 看起來像樣板)、純 CSS(迭代速度慢)
動畫GSAP 3.13+(ScrollTrigger, SplitText)業界滾輪/時間軸動畫標準;從 v3.13 起所有外掛皆免費Framer Motion(綁定 React)、AOS(功能有限,容易看出是套件)
平滑滾動Lenis輕量(約 4kb),與 ScrollTrigger 有完善整合文件Locomotive Scroll(較重,維護較少)
部署Netlify / Cloudflare Pages / Vercel連接儲存庫 → 推送 → 部署;靜態輸出,無需伺服器VPS(對靜態網站來說沒必要)

嚴格規則:不要安裝任何 UI 元件庫。設計必須是原創的——這正是此技能與模板的區別所在。

工作流程(必須按此順序執行)

絕對不要從程式碼開始。未經簡報的登陸頁不過是換了名字的模板。

  1. 簡報 — 與使用者一起完成 assets/brief-template.md。如果缺少目標、受眾或主要行動呼籲(CTA):在繼續前提問。
  2. 設計方向 — 遵循 references/design-direction.md:個性 → 字體 → 顏色 → 佈局 → 視覺簽名。將結果落實到 assets/design-tokens.css。
  3. 區塊架構 — 定義敘事弧(見下方表格)以及標題文案,然後再進行佈局。
  4. 建置 — 逐個區塊建置,行動優先(先從 390px 開始)。動畫遵循 references/animation-recipes.md。
  5. 稽核 — 完成交付檢查清單(如下)。未通過檢查不得交付。
  6. 部署 — 靜態建置 + 託管(命令如下)。

敘事弧(基本結構)

#區塊作用
1主視覺區 (Hero)在 5 秒內傳達價值主張 + 主要行動呼籲
2問題/情境點出訪客能認同的痛點
3解決方案/好處說明你如何解決問題——強調好處,而非功能
4社會證明真實推薦、客戶標誌、數據指標
5運作方式步驟、展示、螢幕截圖
6異議處理常見問題、保證、價格
7最終行動呼籲重複主視覺區的「同一個」獨特行動

根據簡報調整、合併或刪除區塊——並非所有登陸頁都需要這七個區塊。

關鍵模式

  • 單一轉換目標:整個頁面都導向「一個」行動。兩個不同的行動呼籲代表簡報沒做好。
  • 真正的行動優先:設計與建置先以 390px 為基準;桌面版是延伸,而非反過來。
  • LCP 不可觸碰:LCP 元素(主視覺區的標題或圖片)永遠不能在 CSS 中設置 opacity: 0。進場動畫使用 gsap.from()(沒有 JS 時頁面應完整顯示),且總時長 ≤ 1 秒。
  • prefers-reduced-motion:所有動畫都必須放在 gsap.matchMedia() 中。沒有例外。
  • 最小化 Islands:JavaScript 僅用於實際互動的地方。常見問題的摺疊式選單用 <details> 標籤,而不是一個會 hydration 的元件。
  • 圖片:一律使用 astro:assets(<Image> 元件)、AVIF/WebP 格式、設定明確尺寸、loading="lazy"(主視覺區圖片除外)。
  • 字體:自行託管(本機 woff2 或 Fontsource)、font-display: swap、最多兩個字體家族、預載顯示用字體。

交付前檢查清單

  • 行動版 Lighthouse ≥ 95 效能、可及性與 SEO
  • CLS = 0(圖片設定尺寸、字體回落(fallback)已調整)
  • 在 prefers-reduced-motion: reduce 時停用動畫
  • 對比度 AA 標準:文字 4.5:1,大型 UI 3:1
  • 可鍵盤導航、焦點可見、只有一個 h1
  • Meta 描述、OG 標籤、favicon、唯一標題
  • 已於 390px、768px 和 1440px 測試
  • 品牌測試:遮住 Logo,頁面看起來像其他公司的嗎?如果是 → 回到階段 2

命令

# 創建專案
pnpm create astro@latest mi-landing -- --template minimal --typescript strict
cd mi-landing
pnpm astro add tailwind
pnpm add gsap lenis

# 開發與建置
pnpm dev
pnpm build && pnpm preview

# 部署(擇一;在 Netlify/Vercel/Cloudflare 上:建置指令 "pnpm build",輸出目錄 "dist")
npx wrangler pages deploy dist        # 直接部署至 Cloudflare Pages
npx netlify deploy --prod --dir=dist  # 直接部署至 Netlify

資源

相關技能