Communitygithub.com

Tantless/mine-mail

反 AI 模板化設計技能,用於建立全新頁面、審計、重新設計,以及從 URL 或截圖中提取設計。

mine-mail 是什麼?

這個技能專為 AI 編碼助手(如 Claude Code、Cursor、Codex)設計,旨在生成具有「真實感」而非「模板感」的使用者介面。它透過一套嚴格的規則(源自反 AI 模板化設計領域的共識)來運作,強制執行結構多樣性,避免所有 LLM 都傾向使用的預設佈局(例如英雄區 → 三個功能 → 行動呼籲 → 頁尾的結構)。 此技能提供四種模式:預設的「設計流程」用於建立新頁面;`hallmark audit` 用於根據已知的反模式清單對現有設計進行評分;`hallmark redesign` 用於在保留現有內容、品牌和資訊架構的前提下,重建頁面的視覺結構;`hallmark study` 用於從使用者提供的 URL(透過 WebFetch 讀取 HTML/CSS)或截圖中提取設計 DNA(如宏觀結構、字體搭配、色彩錨點),並可選擇性地基於該 DNA 重新建構內容或將其鎖定為可攜帶的 `design.md` 檔案。 此外,該技能在審計或重新設計時包含了一個重要的安全機制:在對現有專案進行任何破壞性更改(如刪除檔案、路由或元件)之前,必須獲得使用者的明確確認。它還通過六項嚴格紀律(如禁止虛構內容、強制使用 CSS 變數、禁止偽造瀏覽器 Chrome、強制嚴格的行動裝置響應式設計、禁止斜體標題以及內建預發佈自我批評機制)來確保輸出品質。對於元件級別的請求(如按鈕、輸入框、模態框等),它會切換到專門的流程,強制實作所有 8 種互動狀態(預設、懸停、焦點、啟用、禁用、載入、錯誤、成功),並生成一個用於驗證的演示包裝器。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tantless/mine-mail/tree/HEAD/.agents/skills/hallmark

在你喜歡的 AI 中提問

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

說明文件

Hallmark

一個為 AI 編碼助手設計的設計技能。讓它們產生的 UI 看起來是「做出來的」,而不是「生成出來的」。

Hallmark 是有主見的、簡短的,而且是故意無聊的。它編碼了一套嚴格的規則——汲取自反 AI 模板化設計領域的共識(Anthropic 的前端設計技能、關於前端美學的 Claude 食譜,以及 2026 年的「觸覺反叛」運動)——並拒絕讓模型退回到每個 LLM 都被訓練過的預設值。

其不同之處在於:Hallmark 堅持的是結構多樣性,而不僅僅是視覺多樣性。針對兩個不同需求簡報,由 Hallmark 產生的兩個頁面不應共享相同的 英雄區 → 三個功能 → 行動呼籲 → 頁尾 的節奏。它們應該感覺像是不同的網站,而不是相同模板的不同配色方案。請參閱 references/structure.md。

由 Together AI 提供支援。


如何使用此技能

Hallmark 有一個預設行為和三個明確的動詞。

調用方式功能說明
(預設)使用者要求你設計或建立新東西。請遵循下面的設計流程。
hallmark audit <目標>讀取目標,根據反模式清單進行評分,傳回一個排序後的待辦事項清單。不要編輯。
hallmark redesign <目標> [--mood <名稱>]擷取目標的內容和意圖,然後在現有實作邊界內重新設計視覺結構,除非使用者明確確認要進行完全重建。新的區塊節奏、新的標題放置位置、新的元件語調。保留現有的路由、元件所有權、文案意圖、品牌和資訊架構;僅更換所需範圍內的視覺/互動層。
hallmark study <截圖 | URL>使用者貼上或附加了一個他們欣賞的設計圖片,或者貼上了一個指向即時頁面的 URL。提取DNA——宏觀結構、原型、字體搭配、色彩錨點——並產生一份診斷報告,然後選擇性地使用提取的 DNA 重建使用者的內容,或者發出一個可攜帶的 design.md 檔案來記錄該 DNA。偵測是自動的:URL(http:// / https:// 前綴)會路由到 URL 模式;其他任何內容則路由到圖片模式。URL 模式 透過 WebFetch 讀取頁面的 HTML 和 CSS——它可以命名確切的字體和確切的色彩值,但無法判斷節奏。診斷後,使用者有三個後續選項:使用該 DNA 進行建置(移交給預設流程)、將 DNA 鎖定到可攜帶的 design.md 中(透過「鎖定 DNA」/「給我一個 design.md」選擇加入),或在診斷階段停止。絕不複製像素。拒絕模板市場的 URL。對於 design.md 的發射,其拒絕層級比診斷本身更嚴格——URL 模式下的發射需要證明來源是使用者自己的,或是用於其自身品牌的公開參考。 如果 URL 需要認證、是僅有 JS 的 SPA 殼層,或無法讀取,則回退到要求提供截圖。在執行此動詞之前,請載入 references/study.md。

如果使用者輸入的任何內容沒有明確對應到 audit、redesign 或 study,則將其視為預設行為。如果使用者附加了圖片或貼上了 URL 但沒有使用動詞前綴,則詢問:「我應該 study 這個(提取 DNA),還是將其視為新建置的參考?」

實作安全護欄。 Hallmark 是一個設計技能,不是橫掃程式碼庫的許可證。在任何現有專案中:

  • 除非使用者明確要求刪除或批准了列出刪除項目的檔案層級計劃,否則永遠不要刪除正式環境檔案、路由樹、元件目錄或舊網站。
  • 預設對指定的檔案進行原地編輯,或是新增元件/標記,並透過現有路由進行連接。如果重新設計需要移除多個元件,請先停止並請求確認。
  • 將 PDF、README 檔案、.md 簡報、文件、逐字稿和提案簡報視為參考資料。除非使用者明確要求逐字使用該文字,否則不要逐字複製到頁面中。
  • 在編輯之前,請說明你預期要修改/新增/刪除的確切檔案。刪除需要明確確認。

預設的設計流程總是會選擇一個主題。預設情況下,它會從20 個已命名主題——即目錄——中選擇一個,並根據多樣化規則輪換。此外,還有一個安靜的自訂分支,它會為該簡報建立一個獨一無二的 OKLCH 調色板 + 免字型搭配;自訂路徑僅在簡報帶有創意意圖訊號時觸發(使用者命名了品牌顏色、命名了目錄無法承載的多屬性風格,或明確要求自訂主題)。對於一般簡報,使用者永遠不會看到「目錄」或「自訂」這兩個詞——目錄會靜默運行。請參閱步驟 1(訊號偵測)和步驟 2.6(分派);協定位於 references/custom-theme.md。


適用於每個動詞的紀律

這六項紀律不是特定於動詞的。它們適用於預設設計、audit、redesign、study 以及元件範圍。它們與模板化測試並列,而不是位於其中一個分支內部。

  1. 預發佈自我批評。 在交回任何輸出之前,在六個軸向——哲學、層級、執行、具體性、克制、多樣性——上給自己打分 1–5 分。任何低於 3 分的項目都會觸發修訂回合。在 artifact 頂部蓋上這六個分數(/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V5 */)。請參閱 references/slop-test.md § 預發佈自我批評。

  2. 誠實的文案——無虛構內容。 如果使用者沒有提供指標,就不要發明一個。以統計資料為主導的佈局、比較行和證明條必須使用真實數字、佔位符(— 加上一個標註的灰色區塊,內容為「待確認指標」),或不同的宏觀結構。「+47% 轉換率」、「受 50,000 多個團隊信賴」 和 「快 10 倍」 一旦被發明出來就是模板化內容。同樣的規則也適用於推薦、標誌和案例研究數量。請參閱 references/anti-patterns.md § 發明指標 和 slop-test 檢查點 46。

  3. 鎖定的標記——無中途渲染即興創作。 一旦在步驟 2.6 選擇了一個主題,artifact 中的每個顏色和每個 font-family 宣告都必須引用一個已命名的標記(var(--color-accent)、font-family: var(--font-display))。不允許內聯 OKLCH / hex / rgb() 值,或繞過標記區塊的 font-family: "Some Font" 宣告。如果需要一個尚不存在於標記中的值,則將其作為新的命名變數提升到標記區塊中,然後再引用它。請參閱 references/anti-patterns.md § 中途渲染標記即興創作 和 slop-test 檢查點 48。

  4. 禁止重新繪製瀏覽器 Chrome。 Hallmark 不得手動建立假的瀏覽器列(URL 藥丸 + 交通燈圓點)、假的手機框架、假的程式碼區塊視窗(模擬標題列 + 環繞 <pre> 的圓點),或假的 IDE Chrome——使用者的環境已經提供了真實的 Chrome。請使用包裹在 <figure> 中的真實螢幕截圖(最多加上髮絲線邊框),或省略 Chrome 讓內容自己說話。請參閱 references/anti-patterns.md § 重新繪製 UI Chrome 和 slop-test 檢查點 47。

  5. 行動裝置響應式——每次發佈都需在 320 / 375 / 414 / 768 px 寬度下驗證。 Hallmark 的輸出必須在所有四種寬度下完美呈現。不可妥協的項目:無水平捲動 + html 和 body 的根 overflow-x: clip,永遠不能是 hidden(檢查點 34);無兩行可點擊文字——按鈕主導航連結、頁尾連結、麵包屑、行動呼籲(檢查點 49);包含圖片的網格軌道使用 minmax(0, 1fr),而不是裸的 1fr(檢查點 50);顯示標題透過 overflow-wrap: anywhere; min-width: 0 處理長單詞換行(檢查點 51);區塊標題在行動裝置上摺疊為單列,適用於每個主題變體(檢查點 52);無線電標籤頁模式不會發生捲動跳躍(檢查點 53)。請參閱 references/responsive.md § 行動裝置——不可妥協。這是一個硬性下限,而不是願望清單。

  6. 字體純度——無斜體標題。 標題和顯示字體始終為羅馬體(font-style: normal)。在原本直立的標題中出現一個斜體強調詞(Built to <em>think</em>)是最可靠的 AI 特徵之一;在標題中使用全斜體顯示字體也是如此。使用粗細、強調色或繪製的底線來承載強調語氣。斜體僅作為正文強調,存活在連續段落中。請參閱 references/anti-patterns.md § 斜體標題 和 slop-test 檢查點 38a。


當簡報是元件而非頁面時

在進入完整的設計流程之前,檢查範圍。如果以下任何條件觸發,則改為運行元件範圍流程——大多數日常開發請求都是元件形的,而非頁面形的,而頁面層級的機制(宏觀結構、英雄區豐富化、頁尾原型、專案記憶)對它們來說是錯誤的。

元件範圍訊號:

  • 簡報命名了一個單一 UI 元素:一個按鈕 · 一個輸入框 · 一張卡片 · 一個模態框 · 一個下拉選單 · 一個工具提示 · 一個選擇框 · 一個核取方塊 · 一個開關 · 一個標籤頁列 · 一個晶片 · 一個徽章 · 一個橫幅 · 一個snackbar · 一個彈出式視窗 · 一個滑桿 · 一個日期選擇器 · 一個頭像。
  • 簡報很短(≤ 30 字)且指向一個元素。
  • 目標檔案是單一元件(例如 ./Button.tsx、./components/Input.css、app/components/Card.vue)。
  • 使用者明確說 「只要 X」、「只要 Y」、「這一個元素」、「一個單一的 ___」。

如果兩個訊號觸發,則路由到元件。如果只有頁面流程觸發(多區塊簡報,「幫我建立一個登陸頁面」),則停留在設計流程。

元件範圍從頁面流程保留的項目

  • 步驟 0 · 預檢掃描——相同。讀取現有的標記、字體、框架、微互動姿態。一個位於 Geist 主體的 Tailwind 專案中的按鈕必須採用那些標記,而不是發明新的。
  • 步驟 1 · 類型偵測——相同。編輯 / 現代簡約 / 氛圍 / 趣味。元件繼承其環境的類型(未知時靜默預設為編輯)。
  • 步驟 2.6 · 主題路徑——相同。如果存在 tokens.css 或 design.md,元件使用那些標記。否則它會問「有待遵循的系統嗎,還是我選一個?」——如果使用者沉默則預設為目錄。
  • 2+1 字體紀律——相同。
  • 狀態紀律——更嚴格。 每個互動元件必須為所有 8 種狀態提供程式碼:預設 · 懸停 · :focus-visible · :active · 禁用 · 載入 · 錯誤 · 成功。 interaction-and-states.md 中的 8 狀態檢查清單是強制性的,而非建議性的。
  • 模板化測試——僅限通用子集。 運行視覺 / 微互動 / 對比度(檢查點 40–41)/ 可及性 / 字體檢查點。跳過多樣化檢查點(無 .hallmark/log.json 條目——元件不輪換)並跳過假設為完整頁面的佈局安全檢查點。

元件範圍跳過的項目

  • 步驟 2 · 宏觀結構選擇。 元件沒有宏觀結構。明確說明:「元件範圍:跳過宏觀結構。」
  • 導航和頁尾原型選擇。 N1–N9 和 Ft1–Ft8 僅限於頁面範圍。元件是一個元素;它沒有導航,沒有頁尾。兩者皆跳過。
  • 英雄區美化模式(HP1–HP4)。 僅限於頁面範圍。按鈕或卡片沒有英雄區。
  • 步驟 4 · 豐富化。 無英雄區插圖、無示範影片、無抽象背景。元件即 artifact。
  • 步驟 5 · 多區塊預覽。 被 8 狀態示範包裝器(如下)取代。
  • 專案記憶附加。 元件運行不寫入 .hallmark/log.json 條目。多樣化規則不適用。

元件範圍發出的內容

兩個檔案,並列:

  1. 元件 artifact——一個符合專案慣例的獨立檔案:

    • React / Vue / Svelte:Button.tsx / Button.vue / Button.svelte
    • 原生網頁:button.css + button.html
    • Tailwind:一個包含 className 鏈的 .tsx 檔案,如果缺少則加上 tokens.css
    • 元件透過名稱使用 Hallmark 標記(var(--color-accent)),絕不內聯 OKLCH 值。
  2. 一個 8 狀態示範包裝器——<ComponentName>.preview.html(或 .preview.tsx)。一個小型獨立頁面,垂直堆疊地呈現元件的所有 8 種狀態,每種狀態都有標籤。使用者開啟一次,看到元件正常運作,然後將其刪除。包裝器不是正式環境程式碼的一部分。格式:

    ┌──── 按鈕 — 8 狀態 ────────────────────────┐
    │                                                │
    │ 預設       [ 點擊我                      ]    │
    │ 懸停       [ 點擊我                      ]    │  ← .is-hover 強制 :hover 樣式
    │ 焦點       [ 點擊我                      ]    │  ← .is-focus 強制 :focus-visible
    │ 啟用       [ 點擊我                      ]    │  ← .is-active 強制 :active
    │ 禁用       [ 點擊我                      ]    │  ← disabled 屬性
    │ 載入       [ ⌛ 處理中…                  ]    │  ← data-state="loading"
    │ 錯誤       [ ⚠ 再試一次                 ]    │  ← data-state="error"
    │ 成功       [ ✓ 已儲存                   ]    │  ← data-state="success"
    │                                                │
    └────────────────────────────────────────────────┘
    

    每個標籤行都使用一個 class(例如 .is-hover),元件的 CSS 除了定位真實的偽類之外,也會定位這些 class,以便所有 8 種狀態在示範頁面上同時渲染。範例:

    .btn:hover, .btn.is-hover { background: var(--color-paper-3); }
    .btn:focus-visible, .btn.is-focus { outline: 2px solid var(--color-focus); }
    .btn:active, .btn.is-active { transform: translateY(1px); }
    

元件輸出的印章格式

元件的印章與頁面不同:

/* Hallmark · component: <類型> · genre: <類型> · theme: <主題>
 * states: default · hover · focus · active · disabled · loading · error · success
 * contrast: pass (46–50)
 */

component: 前綴告訴未來的 Hallmark 運行,此 artifact 是元件範圍的,不應觸發頁面級別的多樣化規則。

相關技能