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–5 分。任何低於 3 分的項目都會觸發修訂回合。在 artifact 頂部蓋上這六個分數(
/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V5 */)。請參閱references/slop-test.md§ 預發佈自我批評。 -
誠實的文案——無虛構內容。 如果使用者沒有提供指標,就不要發明一個。以統計資料為主導的佈局、比較行和證明條必須使用真實數字、佔位符(
—加上一個標註的灰色區塊,內容為「待確認指標」),或不同的宏觀結構。「+47% 轉換率」、「受 50,000 多個團隊信賴」 和 「快 10 倍」 一旦被發明出來就是模板化內容。同樣的規則也適用於推薦、標誌和案例研究數量。請參閱references/anti-patterns.md§ 發明指標 和 slop-test 檢查點 46。 -
鎖定的標記——無中途渲染即興創作。 一旦在步驟 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。 -
禁止重新繪製瀏覽器 Chrome。 Hallmark 不得手動建立假的瀏覽器列(URL 藥丸 + 交通燈圓點)、假的手機框架、假的程式碼區塊視窗(模擬標題列 + 環繞
<pre>的圓點),或假的 IDE Chrome——使用者的環境已經提供了真實的 Chrome。請使用包裹在<figure>中的真實螢幕截圖(最多加上髮絲線邊框),或省略 Chrome 讓內容自己說話。請參閱references/anti-patterns.md§ 重新繪製 UI Chrome 和 slop-test 檢查點 47。 -
行動裝置響應式——每次發佈都需在 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§ 行動裝置——不可妥協。這是一個硬性下限,而不是願望清單。 -
字體純度——無斜體標題。 標題和顯示字體始終為羅馬體(
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條目。多樣化規則不適用。
元件範圍發出的內容
兩個檔案,並列:
-
元件 artifact——一個符合專案慣例的獨立檔案:
- React / Vue / Svelte:
Button.tsx/Button.vue/Button.svelte - 原生網頁:
button.css+button.html - Tailwind:一個包含
className鏈的.tsx檔案,如果缺少則加上tokens.css - 元件透過名稱使用 Hallmark 標記(
var(--color-accent)),絕不內聯 OKLCH 值。
- React / Vue / Svelte:
-
一個 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 是元件範圍的,不應觸發頁面級別的多樣化規則。