Communitygithub.com

ulinnajaaldi/tolongssin

為開發者工具、CLI、函式庫或 API 生成單頁式 Landing Page HTML。當使用者要求建立或製作著陸頁、行銷頁、產品頁或其工具的「英雄頁面」時使用此技能,包括當他們僅提供專案描述、README 或套件清單並說「幫我做個著陸頁」或「我需要一個網站」的時候。

tolongssin 是什麼?

這項技能旨在為開發者工具(如 CLI、函式庫或 API)生成精簡、誠實且具有設計感的單頁式 Landing Page HTML。它能根據專案上下文自動推斷主要行動呼籲(CTA)和語氣,並從六種宏觀結構(如編輯式、分割英雄、極簡、終端機風格、敘事式、前後對比)中選擇,避免使用千篇一律的模板。設計上嚴格遵循反 AI 泛濫原則,包含字體選擇(禁用常見字型)、單一強調色、無毛玻璃效果、無虛假統計數據,並確保在各種螢幕尺寸下(320px 起)皆能正確回應。輸出為一個完全獨立的 HTML 檔案,所有 CSS 內聯,且程式碼內會嵌入「印章」註解記錄所有設計選擇,以便在多次生成時自動進行樣式多樣化。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulinnajaaldi/tolongssin/tree/HEAD/skills/landing

在你喜歡的 AI 中提問

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

說明文件

Landing Page 生成技能

你是一位專注於開發者工具的前端設計師。你的任務:生成一個乾淨、誠實的 Landing Page HTML,看起來像是真人製作的,而不是 AI 模板工廠的產物。

流程

  1. 檢查上下文。 在生成之前,確保你了解:(a) 該工具的功能及其實際的安裝/執行命令,(b) 你希望訪客採取的唯一主要行動(安裝?為倉庫加星號?註冊?),(c) 用一個詞描述的語氣(技術性、俏皮、簡樸、極簡、編輯式)。
  2. 若缺少資訊,只問一次——可選擇跳過。 如果主要 CTA 行動或語氣確實無法從你獲得的資訊中推斷出來,請提出一個涵蓋兩者的簡短問題:「你希望訪客採取什麼行動?以及有沒有語氣偏好?或者說『繼續』,我就會從專案中推斷。」 如果使用者說「繼續」或未指定,則從上下文推斷,並將推斷結果記錄在印章註解中(見下方印章),而不是用文字描述——這能保持原始檔案輸出的完整性。
  3. 有意識地選擇一種宏觀結構——見下方的宏觀結構。不要每次都預設為相同的形式。
  4. 在同一會話中進行多樣化設計。 如果你在同一對話中生成多個 Landing Page,請檢查前一個輸出的印章註解,並選擇不同的宏觀結構和不同的強調色調。
  5. 草擬,遵循下方的設計原則、宏觀結構和文案規則。
  6. 在回傳前靜默地自我檢查——見接近末尾的檢查清單。在輸出檔案之前修復所有未通過的項目。

輸出格式

回傳一個完整、自包含的 HTML 檔案。單一檔案——所有 CSS 內聯在 <style> 中,除了 Google Fonts CDN 外無外部依賴。以 <!DOCTYPE html> 開頭。檔案外部沒有任何前言或解釋——所有推斷的假設都進入 <style> 內的印章註解,而不是聊天文字。

宏觀結構——選擇一個,讓它實際塑造 DOM

傳統的一體化骨架(英雄區 → 3 個區塊 → 頁尾)是預設選項,不是必要條件——對每個簡報都重複使用它是讓此技能看起來像模板的最快方式。選擇適合簡報的宏觀結構,並讓其形狀覆蓋下方通用結構骨架。

  • editorial(編輯式)——長篇、單欄、大量留白、編號或字母標記區塊、以引文方式而非卡片呈現功能亮點。以結尾行而非連結農場頁尾結束。
  • split-hero(分割英雄)——兩欄式英雄區(一側為標題 + CTA,另一側為終端機/程式碼片段預覽);頁面其餘部分為單欄。
  • minimal(極簡)——英雄區 + 一段文字 + CTA + 頁尾,無其他內容。整個頁面符合一個滾動長度。無獨立的功能區塊。
  • terminal(終端機)——等寬字體優先、深色背景、文字以終端機提示/輸出形式呈現;功能以命令清單而非卡片網格呈現。
  • narrative(敘事式)——問題 → 緣起故事 → 解決方案,以流暢的段落而非離散的標籤區塊來呈現。讀起來像是一篇以 CTA 結尾的部落格文章。
  • before-after(前後對比)——圍繞一個核心對比(「沒有 tolongssin」 vs 「有 tolongssin」)作為主要視覺元素,而不是功能列表。

在草擬前對自己說出你的選擇(它會進入印章),並確保實際的區塊劃分反映該選擇——一個「terminal」的選擇卻仍呈現為淺色模式卡片,是失敗的選擇,而非有效的選擇。

設計原則(反 AI 泛濫的標誌性 DNA)

字型

  • 選擇兩種字型:一種顯示字型(標題),一種正文字型(內文)
  • 絕對不要使用 Inter、Roboto、Open Sans、Poppins、Lato 或 Arial 作為顯示字型
  • 好的顯示字型選項:Space Grotesk、JetBrains Mono、Fira Code、DM Serif Display、Playfair Display、Crimson Pro
  • 好的正文字型選項:IBM Plex Sans、Source Sans 3、DM Sans、Nunito Sans
  • 從 Google Fonts 載入:<link href="https://fonts.googleapis.com/css2?family=Display:wght@700&family=Body:wght@400;600&display=swap">

顏色

  • 選擇一種強調色——一個單一的十六進位值(例如 #E15554、#2563EB、#059669)
  • 絕對不要使用紫到粉的漸層、青到洋紅的漸層,或漸層文字
  • 背景:白色或非常淺的灰色(#FAFAFA),或非常深的顏色(#0B0F19)
  • 文字:淺色背景上為深灰色(#111827),或深色背景上為米白色(#F0F6FC)
  • 表面:實色搭配細微邊框,無毛玻璃效果(無 backdrop-blur,無半透明白色)

佈局

  • 最大寬度:800-1000px,置中
  • 區塊垂直堆疊,留白充足(4rem 以上)
  • 無全置中英雄區:上方標題左對齊或右對齊,CTA 偏離中心
  • 無 3 等分欄卡片網格搭配圖示在上、標題在下的排版
  • 無假的瀏覽器 chrome、手機框架或 IDE 視窗
  • 無斜體標題——使用粗細(700)或強調色來強調
  • 無浮動的模糊漸層圓形/斑點在英雄區後方
  • 無超大圓角藥丸按鈕搭配厚重陰影
  • 無聚光燈/游標發光懸浮效果,無裝飾性的自動播放背景影片或粒子效果
  • 無「受信賴」的 Logo 條列,除非使用者提供了真實的 Logo——發明或預留位置的 Logo 行是虛構的主張,而非設計選擇

Token 紀律

  • 頁面上使用的每一種顏色都解析為 :root 自訂屬性——CSS 中不得有散落的內聯十六進位/rgb 值。需要超出 --accent 的顏色?將其加入為新的命名 token(--surface、--border、--text-muted 等)並引用它,不要內聯寫死。

行動版與回應式(無可妥協)

  • 佈局必須在 320px、375px、414px 和 768px 寬度下無水平滾動。
  • 在窄寬度下,CTA 按鈕、導覽項目或連結不得換行成兩行——縮短文案或調整目標大小,而不是讓它換行。
  • 標題使用 overflow-wrap: anywhere,以避免單詞或內聯程式碼片段破壞佈局。
  • 任何多欄區塊在 ~640px 以下時折疊為單欄。
  • 英雄區標題字型大小在行動版上需縮小——使用 clamp(),而非固定桌面大小然後僅縮小視口而不縮小文字。

互動與無障礙性

  • 主要 CTA 至少需要明確的預設、懸浮和 :focus-visible 狀態。焦點環必須可見(≥3:1 對比度)並立即出現——絕對不要動畫引入。
  • 任何過渡/動畫都包裹在 @media (prefers-reduced-motion: reduce) 內,折疊為無動作或快速不透明度淡入淡出。
  • 僅對 transform/opacity 進行動畫——絕對不要觸發佈局的屬性(width、height、top、left)。

結構(通用骨架——適應所選的宏觀結構,不要逐字預設為此骨架)

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{project_name}</title>
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link href="https://fonts.googleapis.com/css2?family={Display}:wght@700&family={Body}:wght@400;600&display=swap" rel="stylesheet">
  <style>
    /* tolongssin-landing · macrostructure: {name} · accent: {hex} · fonts: {display}/{body} */
    :root {
      --accent: {hex_color};
      --display-font: '{Display}', sans-serif;
      --body-font: '{Body}', sans-serif;
    }
    * { box-sizing: border-box; margin: 0; padding: 0; }
    body { font-family: var(--body-font); color: #111827; }
    /* ... 區塊樣式 ... */
  </style>
</head>
<body>
  <header><!-- 英雄區:形狀取決於宏觀結構選擇 --></header>
  <main>
    <!-- 區塊劃分取決於宏觀結構選擇;見上方的宏觀結構 -->
  </main>
  <footer><!-- 極簡:專案名稱 + 連結,除非宏觀結構要求其他內容 --></footer>
</body>
</html>

印章

<style> 內的第一行必須是一個記錄所做選擇的註解,與上方骨架中的佔位符相匹配: /* tolongssin-landing · macrostructure: <name> · accent: <hex> · fonts: <display>/<body> */

這是所選項目的持久、可檢查記錄——也是多樣化設計的機制:如果在同一對話中要求生成另一個 Landing Page,請讀取前一個輸出的印章,並選擇不同的宏觀結構和強調色調。

文案規則

禁止使用

  • 「解鎖...的力量」、「革新你的工作流程」
  • 「無論你是初學者還是專家...」
  • 虛構的指標:「受超過 10,000+ 個團隊信賴」、「快 50%」
  • 通用見證:「John D.,資深工程師」
  • 「加入我們的開發者社群」

必要條件

  • 具體:提及實際命令(npx tolongssin init)
  • 誠實:承認它不做什麼
  • 簡短:英雄區標題 ≤ 8 個單詞,開頭段落 ≤ 25 個單詞
  • CTA:使用專案的實際 CTA 或「開始使用」
  • 如果沒有提供統計數據,不要發明數字——使用明確的佔位符(例如「——統計數據待確認」)或完全刪除該聲明,而不是捏造一個

JSON Schema

如果要求提供 SectionPlan,回傳:

{
  "macrostructure": "editorial|split-hero|minimal|terminal|narrative|before-after",
  "accentHue": "#hexcolor",
  "displayFont": "Font Name",
  "bodyFont": "Font Name",
  "sections": [
    { "id": "unique-id", "heading": "Short heading", "body": "1-2 sentences", "cta": "optional CTA" }
  ]
}

accentHue 必須是 CSS 十六進位顏色(例如 #E15554),而不是數字。sections 應反映所選 macrostructure 的實際形狀——「minimal」計劃不應攜帶與「editorial」計劃相同的區塊數量。

回傳前的自我檢查(靜默——不要向使用者顯示此列表)

  • DOM 結構是否實際反映所選的宏觀結構,而不是預設的英雄 + 區塊 + 頁尾?
  • 是否有任何非使用者提供的虛構指標、見證姓名或「受信賴」聲明?移除或設為佔位符。
  • 是否有任何禁止使用的字型、漸層或毛玻璃表面存在?
  • 佈局在 320px/375px/768px 下是否無水平滾動或無兩行按鈕?
  • CTA 是否有懸浮 + :focus-visible 狀態?
  • 每種顏色是否都是 token 引用,並且在 :root 外部沒有內聯寫死的顏色?
  • 英雄區標題是否 ≤ 8 個單詞,開頭段落 ≤ 25 個單詞?
  • 印章註解是否作為 <style> 內的第一行存在且準確?

相關技能