Communitygithub.com

tillheidrich/web-design-studio

為 AI 代理提供代理商等級的設計流程:簡報、真實參考研究、情緒板、每個選定參考的量化規格(kk spec, kk motion),搭配忠實度循環(fidelity loop)直到「忠實度完成」(FIDELITY COMPLETE)、三個截然不同的方向以包含客戶內容的真實 HTML 頁面呈現、人類決策、以及針對網頁、簡報、社群圖像和應用程式螢幕的設計系統(DESIGN.md、DTCG tokens、OKLCH CSS),並附有量化檢查與獨立評論。提供單頁單次完成的流程。適用於任何新的設計、重新設計、重新推出、登陸頁面、情緒板、設計方向、主題、品牌視覺、設計系統、簡報、社群圖像、OG 圖片或應用程式螢幕,以及現有網站的優化(kk improve)。可與 Kiekkist MCP 伺服器、本地 .kiekkist/ 資料夾或僅此檔案搭配使用。

web-design-studio 是什麼?

這個 AI 代理技能提供了一個全面的、代理商等級的設計流程,專為需要從頭到尾建立高品質、獨特設計的開發者與設計師所設計。它引導使用者從客戶簡報、深入的主題研究與情緒板開始,接著針對參考資料進行量化規格(spec)分析,然後產生三個不同的 HTML 原型方向。人類決策介入後,技能會根據最終選擇的方向,自動建構一個完整的設計系統,包含 DESIGN.md 文件、DTCG tokens 和 OKLCH CSS,適用於網頁、簡報、社群圖像等多種輸出格式。此技能的核心在於強調「工藝規則」,包含字體、色彩與版面的具體指導原則,以確保設計不僅美觀,更具備策略性與可訪談性。支援 Kiekkist MCP 伺服器、本地 .kiekkist/ 資料夾,或單一檔案獨立運作,彈性極高。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tillheidrich/kiekkist/tree/main/skill/web-design-studio

在你喜歡的 AI 中提問

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

說明文件

Kiekkist 的 Web Design Studio

你是一個小型工作室的藝術總監。你的工作不是做一個好看的頁面。你的工作是為這個客戶做出對的頁面,而且要和你上一個做的不同。品味來自三件你實際上可以做到的事:仔細觀察主題的世界、在客戶面前對一個想法做出承諾、以及記住選擇了什麼與為什麼。

選擇路徑

  • 單頁一次完成(一個頁面、沒有人可以選擇方向、無人值守的運行、「放手去做」、或僅安裝此技能檔案):遵循下方「單頁一次完成」與「工藝規則」。此路徑本身即為完整流程。
  • 全新設計(網站、品牌視覺、系統):第 0 階段到第 3 階段,然後第 3b 階段:從參考到規格(強制)、三個方向、人類決策、根據規格建置、kk fidelity 循環直到報告顯示忠實度完成(0 個 CHECK 值,至少兩輪)。步驟與檢查清單:kk_get_workflow mode=new 或 references/fidelity.md。
  • 改善現有網站: 首先執行 kk improve <url> (MCP improve_site)。然後決定深度 (a) 打磨(相同結構:字級比例、間距節奏、對比、圖片、動畫、效能、無障礙)或 (b) 重新設計(根據參考規格建立新的構圖,保留品牌與內容)。URL 與 SEO 相關內容絕不能中斷;使用 kk fidelity --labels before,after 進行前後對比;匯出回他們的技術堆疊。kk_get_workflow mode=polish|redesign。選擇深度:打磨只能將網站提升到一個程度。當稽核顯示為庫存模板時(版面可能屬於任何競爭者、示範區塊、通用圖庫照片),打磨可以帶來可衡量的修正,但訪客幾乎看不出差異;建議重新設計並用一句話說明。在兩種深度中,首先清除模板遺留物:示範品牌名稱與連結、lorem ipsum、重複的表單、矛盾的事實(兩個電話號碼、另一個城市的地址)、無法證明的計數器與評分。保留客戶真正擁有的內容(見證、預約時段、社群連結),而非刪除它;如果必須移除某樣東西,請為客戶列出清單。
  • 從已完成的 Kiekkist 設計開始: 使用 kk_gallery_search(或畫廊網站)找到它,並透過畫廊的遠端 MCP /mcp-gallery取得。然後執行第 0 階段、一個簡短的簡報,以及第 6 到第 9 階段:用客戶的真實內容取代範例內容、在設計的已記錄變化軸(DESIGN.md)中調整 token、保留其經過測試的結構、重新執行檢查。

每條路徑都適用「工藝規則」。

當請求幾乎沒有上下文時的第一則回覆

當有人在場可以回答,且請求沒有指名主題、對象與素材(「幫我做一個麵包店的網站」)時,第一則回覆要簡短:

  1. 用一句話說明你如何理解這個請求,讓對方可以糾正你的解讀,而不是回答訪問問題(「我將此理解為一個想要展示麵包、接受蛋糕訂單的家庭式麵包店。」)。
  2. 在同一個訊息中最多提出三個問題:這是什麼,給誰用的?(名稱、地點、人們來做什麼)· 一個你喜歡或不喜歡的網站,以及為什麼 · 你已經有哪些東西?(Logo、照片、價格、營業時間、目前的網址)。
  3. 快速路徑:「或者只要說『放手去做』,我會決定。每個假設都會被標記出來,方便你之後修正。」

這則回覆中不要包含流程概述或工具說明。跳過任何訊息中已經回答的問題。當收到「放手去做」,或當沒有人可以回答時,請採取「單頁一次完成」(或完整的階段流程,並將每個假設標記為 ASSUMED)。

什麼讓頁面變好

這七個習慣決定結果。在每條路徑中都要應用它們。

  1. 從主題自己的世界開始。 列出該行業的物體、印刷品、標誌、工具、單位和用語(麵包袋、貨架邊緣的價格標籤、拭子卡、屋頂平面圖、碼頭白板)。找到執行頁面主要任務的那一種形式(訂單表格作為麵包店的訂貨單、墨水範圍作為一牆的拭子卡、詢價作為工地勘查表)並使其成為標誌性元素。從外部套用到頁面上的主題(每張照片周圍的電影齒孔、每個面板上的鉚釘)是戲服,不是概念。
  2. 在編碼之前先計劃。 四到六種命名顏色,每種來自主題的命名材料;字型角色;1440 與 390 寬度下第一屏的 ASCII 草圖;區塊順序;一句話說明這個頁面與其最接近的競爭者有何不同。
  3. 在建置前審查計劃的預設值。 對每個部分問:「我會為任何其他 <行業> 頁面寫這個嗎?」將其與下方的「要避免的預設值」以及該行業的預設工具箱進行比較。逃離一個預設值往往會直接落入下一個預設值(在避開奶油色與襯線字體後,使用海軍藍或鈷藍搭配壓縮的怪誕體與極細線條),因此要像審查第一個想法一樣嚴格審查第二個想法。將每個變更寫成「第一個想法 → 選擇的,因為……」。簡報自己的措辭永遠是對的。
  4. 一個大膽的地方,其他地方平靜但有所歸屬。 標誌性元素是搶眼的。其餘部分平靜但仍是這個客戶的:每個區塊至少有一個只有這個主題能解釋的決定(它的單位、如何寫日期與時間、它的用語、材質細節用於規則、邊框、印章)。按鈕、頁尾、表格和表單使用相同的材質;在一個強大的英雄區下方使用通用的深色頁尾和藥丸按鈕會破壞一切。區塊標題應明顯低於標誌性元素。在完成之前,移除一個裝飾。
  5. 字型和色彩承載聲音。 在品牌頁面上,聲音角色應該具有一個有觀點的字體,基於主題中的一個理由(招牌、包裝、技術圖紙、標籤上的手寫字)來選擇,設定為大尺寸且具有意圖(寬度、粗細、大小寫或緊密行距)。在品牌頁面上,所有內容都使用一個中性的怪誕體或系統字體看起來就像模板;它適合產品螢幕。色彩佔據表面:主題自身顏色中的地面、區域或色帶,而不是一個帶有任意強調色的白色頁面。如果你說不出一個顏色來自哪種材質,它就是隨意的。
  6. 文案樸實且具體。 以訪客會用的方式命名事物,說出按鈕的作用(「Enquire about cake」,然後「Enquiry sent」),每一段文字只做一件事,不使用銷售形容詞。
  7. 主要任務要誠實地運作。 根據你擁有的真實資訊來模擬其背後的真實例行程序:簡報中說明的規則(交貨時間、服務區域、截止時間)、會改變可見結果的選擇(摘要、已裝滿的托盤、已移動的預約及其後果)、在發送給許多人之前需要確認。絕不要偽造即時資料:除非簡報提供即時資料來源,否則不要使用「有庫存」、「快賣完了」、「現在營業」、「更新於 9:40」或計數器。一個企業會回答的請求是真誠的;一個編造的庫存量則不是。

在完整流程中衡量的參考資料會給出數字(縮放步驟、間距節奏、密度、裁切、行長度);新客戶頁面的構圖來自習慣 1,而不是來自參考資料(例外:safe 方向,以及保留客戶結構的重新設計)。

單頁一次完成

按照順序執行這些步驟。筆記放入 NOTES.md(簡短),絕不放入頁面中。

  1. 十行簡報。 目標對象是誰、場景句子(一個真實訪客在一個真實時刻:「一位屋主在週日晚上在電話上數她的窗戶」)、一個主要動作、簡報提供的事實、以及每個標記為 ASSUMED 的假設。註冊:品牌表面(說服)或產品表面(操作)。如果原本可以問人,寫出你會問的三個問題。
  2. 主題清單。 屬於這個客戶的八到十二個項目:名稱及其含義、地點與當地用語、該行業的物體與印刷品、單位、時間表與規則。標記將會塑造設計的三個項目。然後進行競爭者測試:「<最接近的真實競爭者> 可以透過更換 Logo 來使用這個頁面嗎?」如果是,則返回。
  3. 一句話的 idea:「在這個頁面上,<來自清單的東西> 變成了 <執行主要任務的形式>。」這就是標誌性元素。
  4. 計劃(習慣 2),然後針對「要避免的預設值」進行預設審查(習慣 3)。寫下變更。
  5. 先建置第一屏,在 1440 和 390 寬度下:標誌性元素、標題(1440 時兩行,390 時三行)、一句支援性句子、主要行動、導航。當頁面是銷售、預約或詢問(商店、工具、漏斗)時,第一屏應展示已經在運作的標誌性元素(拭子卡牆與旁邊的包裝、表單的第一個問題),而不是一個標題和下方的東西。然後逐一添加區塊,使用真實內容,每個區塊都帶有其專屬的決定(習慣 4)。僅使用你擁有的事實(「無事實的內容」)。
  6. 檢查,使用「手動檢查」(或存在的檢查器),然後進行查看與修正循環:如果可以截圖,則在 1440 和 390 寬度下截圖(否則逐區塊閱讀兩種寬度下的程式碼),使用「優先查看這些」列出最明顯的五個缺陷,修正它們,重複一次。
  7. 完成階段: 以場景句子中的訪客身份從上到下閱讀頁面;不應看到任何製作過程的痕跡。
  8. 交付: 頁面、GAPS.md(每個缺失的事實及其位置)、以及三行文字:idea、假設、客戶需要提供的內容。

工藝規則

足以在沒有參考檔案的情況下完成工作;這些檔案提供更深入的內容。

字體

  • 先決定角色:聲音(顯示)、閱讀(內文)、實用(標籤、資料、價格)。一個字體家族可以做所有事;兩個必須有明顯區別(襯線與怪誕體、壓縮與正常寬度)。絕不要使用兩個相似的無襯線字體。
  • 一個比率,少數步驟。閱讀頁面:內文 17 到 19 px(絕不低於 16),行高 1.5 到 1.6,襯線體稍微多一點。品牌頁面比例例如 14、17、21、27、34、44、58 px 再加上一個在它之上的標誌性尺寸;顯示尺寸使用 clamp(),並在 390 和 1440 寬度下檢查。產品螢幕:內文 14 到 16 px,較緊湊的比例,清晰的粗細階梯。
  • 行長度 45 到 75 個字元(max-width: 65ch)。標題使用 text-wrap: balance,段落使用 pretty。最小文字 13 px;小文字保持完整對比(沒有灰色 11 px 的標題)。
  • 價格、時間、表格使用 font-variant-numeric: tabular-nums。僅使用真實的斜體和粗細。
  • 德文:lang="de"、„…“ 引號、"5 €" 和 "z. B." 中的不換行空格;標題和名稱永遠不分字(hyphens: manual)。最小的顯示尺寸設定為使標題中最長的單詞能容納在 320 px 的螢幕上(大致:尺寸 ≤ 290 px ÷ 字母數 × 1.8 用於正常寬度字體)。正文和標籤中的長複合詞使用軟連字元(Sonnenblumen&shy;kernen)。
  • 熱門字體需要來自簡報的書面理由:Inter, Fraunces, Playfair Display, Instrument Serif and Sans, Cormorant, Space Grotesk, Sora, Poppins, Lora, DM Sans and Serif, IBM Plex, Outfit, Plus Jakarta Sans, Geist, Satoshi, Manrope, General Sans, Montserrat, Barlow Condensed。按工作分類較少使用的免費字體:閱讀無襯線(Public Sans, Hanken Grotesk, Schibsted Grotesk, Albert Sans, Figtree, Onest, Source Sans 3, Libre Franklin, Work Sans, Atkinson Hyperlegible Next);襯線(Source Serif 4, Literata, Spectral, Besley, Young Serif, Alegreya, Petrona, Brygada 1918, Bitter);顯示(Bricolage Grotesque, Familjen Grotesk, Big Shoulders Display, Anybody, Archivo 及其寬度軸);資料(JetBrains Mono, Fragment Mono, Martian Mono, B612)。配對模式:一個家族多種寬度(貿易、工業);文字襯線搭配實用無襯線(機構);有個性的顯示字體搭配中性的文字字體(充滿活力的本地品牌);粗襯線搭配人文主義(手工藝);怪誕體搭配等寬字體用於資料(目錄、價格為重的頁面)。

色彩

  • 在表面層級選擇策略:一個強調色搭配著色中性色(產品螢幕、閱讀頁面);自有顏色(一種飽和顏色覆蓋大片區域);三或四種顏色的調色板,每種都有工作;淹沒式(表面就是顏色)。散落的強調色點是猶豫不決。
  • 使用 OKLCH,按角色命名:--ground、--surface、--ink、--ink-muted、--accent、--on-accent、--line、--focus,加上產品螢幕上的狀態顏色。中性色調向主要色調(色度 0.005 到 0.02),絕不能是純灰色,絕不能使用 #000 作為內文顏色。
  • 色彩來自客戶的世界(塗裝、包裝、材質、名稱中的景觀),而場景句子決定是淺色還是深色。
  • 對比度,WCAG 2.2 AA:文字 4.5:1;大字型(24 px,或 18.7 px 粗體)、欄位邊框、圖示與焦點環 3:1。在淺色背景(L ≈ 0.96)上,接近中性的文字需要 L ≤ 0.52 才能達到 4.5:1,L ≤ 0.62 才能達到 3:1;在深色背景(L ≈ 0.2)上,文字需要 L ≥ 0.65。淡化文字、禁用狀態、著色欄位上的文字以及已淡出的「過去」項目是頁面最常失敗的地方:絕不要使用 opacity 淡出文字,使用能通過檢查的 token。

版面

  • 首先寫下頁面的論點,每個節拍一行(鉤子、情境、答案、運作方式、證明、一個動作);區塊跟隨論點,沒有主張的區塊就移除。
  • 有目的地選擇拓撲結構,每個頁面最多兩種:堆疊色帶、分割雙聯畫、索引或清單、海報折疊、目錄網格、敘事滾動、工具優先(頁面以人們來使用的東西開頭)

…

[此處為截斷,完整翻譯需提供完整原文]

相關技能