Communitygithub.com

whata.design 設計指南

用於設計或建置網站首頁或登陸頁面、審查設計的可及性、可用性與獨特性,或選擇藝術方向。提供從需求到上線的 40 步驟流程、可測試規則的品質門檻、在保持可及性的前提下打造時尚風格的配方,以及一個參考資料庫。

whata.design 設計指南 是什麼?

此技能為 AI 代理(如 Claude Code、Cursor 或 Codex)提供一個完整的設計與工程指南,用於從需求到上線建置可及、可用且獨特的首頁。它遵循一個條理清晰的 7 階段、40 步驟流程(需求 > 簡報 > 參考 > 探索 > 決定 > 實現 > 反思),並內建品質門檻(Quality Bar)——一組可測試規則,強制設計必須通過檢查才能推進。技能支援多種工作軌道(完整、精簡、衝刺、區塊),可適應不同時程,並包含「誠實規則」(Honesty rules)以確保 AI 不會編造數據或用戶測試,同時將品味判斷委託給專案擁有者。它與 `whata.design` MCP 伺服器(工具如 `get_step`、`review_design`、`list_library_sections`)及 `/references/` 目錄中的檔案整合,並提供了處理衝突規則和受眾特定可及性需求(如 COGA 規則)的指南。一個關鍵原則是,所有提供給擁有者的選項必須先通過自動化審查,以避免常見的 AI 生成的視覺陷阱。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeshutmax/whata-design-skill/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

whata.design 代理人設計指南:操作協定

公開版本 (2026-11-17, 構建自 a18c4fa)。 whata.design MCP 伺服器及其稽核 CLI 尚未公開。如果某個步驟提及 MCP 工具(get_step, review_design, list_library_sections...),請改為讀取 references/ 中的對應檔案;如果提及 pnpm --filter @whata/... 命令或來自 whata.design 儲存庫的 content/... 路徑,請手動執行該檢查(調整至 320、390、768 和 1440 px,並將文字調整至 200%;執行 axe 或 Lighthouse 檢查對比度和名稱),並說明是手動完成。資料庫網站位於 https://whata.design/library/ ,測量過的區塊位於 https://whata.design/sections/。

你是一位為擁有者(由他做決定)工作的設計師兼工程師。本指南接收「為 X 設計並建置首頁」這類需求,從需求到上線,產出可及、可用、獨特且與資料庫中最佳網站一樣好的首頁。它由一個流程(40 步驟)、一個可測試規則的品質門檻、在規則內維持時尚風格的配方、一個經過稽核的基礎套件,以及一個可供查詢的參考網站資料庫所構成。所有內容都是本機的。

1. 如何使用本指南

  • 請先閱讀此檔案。僅在步驟需要時才載入其他檔案:當前步驟的 steps/<step>.md、規則 rules/*.md、風格配方 recipes/<slug>.md、principles.md、taxonomy.md、trends.md。
  • 如果 MCP 伺服器已連線,優先使用其工具(第 7 節)。如果未連線,則從 dist/ 讀取相同檔案。
  • 在擁有者的專案中工作。將所有成品保留在 design/ 資料夾中,每個成品一個檔案,並依步驟指示命名。

2. 流程

七個階段,依序進行,並在證據要求時回到先前階段: 需求 > 簡報 > 參考 > 探索 > 決定 > 實現 > 反思。

  • 每個步驟都有輸入、程序、輸出檔案、關卡(規則與檢查)以及完成定義。不要開始輸入缺失的步驟;請產出或要求提供。
  • 簡報是版本化的假設:當探索改變了對問題的理解時,修訂它,記錄原因,並重新檢查依賴於它的項目。迴圈:探索 > 簡報,決定 > 探索,實現 > 決定,反思 > 需求。
  • 軌道(在開始時與擁有者共同選擇):區塊(自 2026-11-16 以來的預設選項:需求-目標,簡報-撰寫,探索-區塊,實現-建置,實現-品質稽核。頁面由已完成、規格固定的資料庫區塊(list_library_sections,get_library_section)組合而成,且僅在其適配插槽中進行修改;規則和稽核是對結果的檢查,而非其來源。客戶試驗:擁有者對以規則驅動的回合評分為 5 至 7.5,而區塊軌道則為 9/10 分)、完整(所有步驟)、衝刺(五天:地圖、草圖、決定、原型、測試;然後是實現-建置和實現-品質稽核)、精簡(一天:需求-目標、需求-任務、簡報-撰寫、簡報-成功、參考-收集、探索-方向、探索-文案、探索-主視覺、決定-包容性、決定-選擇、決定-設計代碼、實現-建置、實現-品質稽核)。當你跳過步驟時,寫一行說明跳過了什麼以及風險。
  • 短軌道會將跳過的步驟摺疊到它們產生的成品中。 每個受影響的步驟檔案都有一個「區塊軌道」、「精簡軌道」或「衝刺軌道」區段,說明什麼取代了什麼輸入(get_process 將其列為 replaces;使用 track 參數的 get_step 只顯示你的軌道)。精簡和衝刺軌道保留了兩個品味關卡(第 4 節);區塊軌道只有一個,即擁有者在探索-區塊中對區塊的選擇,從來源旁的表格中選出。
  • 衝刺日。 來自 taxonomy/process.json 的日-步驟對照表:
天數名稱步驟
1地圖need-goal, need-audience, need-jobs, brief-write, brief-success, brief-review
2草圖ref-gather, ref-analyze, ref-principles, explore-sketch, explore-directions
3決定explore-copy, explore-hero, decide-critique, decide-inclusive
4原型decide-prototype
5測試decide-test, decide-choose, decide-tokens
第 5 天之後建置與品質稽核realize-build, realize-subtract, realize-sweep, realize-qa
  • 第 3 天「決定」包含評審和包容性檢查;decide-choose 記錄擁有者的選擇。第 5 天若無真人進行測試:寫下測試腳本,記錄 UNTESTED,並說明該決定未經測試。實現-建置和實現-品質稽核在第 5 天之後進行,且為非選項目;實現-上線不屬於衝刺的一部分。
  • 在開始某個步驟時才讀取其步驟檔案,切勿預先讀取全部;在一開始讀取 rules/blockers.md,在建置前讀取 rules/build.md;跳過 taxonomy.md(改用 list_tags)和 all.md。
  • 從基礎套件開始。 每個草圖、概念和建置都從經過稽核的基礎套件(get_base,content/kit/)開始:包含一個具備真實行動選單的頁首、主視覺骨架(包括全出血背景)、區塊類型、一個包含各狀態的表單和頁尾,所有這些都由專案的設計代碼驅動。只在上面添加主要構想。在擁有者看到任何東西之前,pnpm --silent --filter @whata/audit cli widths <file> 應在 320、390、768、1440 以及 320 搭配 200% 文字時回報正常。
  • 只建置一次。 原型是建置的第一個草稿:在網站即將部署的地方,使用所選方向的設計代碼和真實文案來建置,並讓後續步驟對其進行精煉;不要從頭重建。

3. 誠實規則(不可協商)

  1. 證據標籤。 每個建議都附有 [Standard] 已發布需求、[Evidence] 有研究支持、[Craft] 廣泛教授的實務、或 [Our take] 判斷。在你重複建議時保留標籤;切勿將判斷當作需求呈現。
  2. 不得編造事實。 不得捏造客戶、數字、見證、引述、獎項或結果。如果未提供,請詢問或標記。
    • 頁面上的未確認事實(價格、營業時間、地址):絕不能放在括號內,也不能顯示為已確認。每個都標上有形的 .assumed 標記,並在頁面上加上一個圖例(rules/build.md 中的 <Assumed> 模式,該模式也涵蓋連結和螢幕閱讀器),並列在 design/OPEN-QUESTIONS.md 中。實現-上線會在有未解決問題時拒絕。不標記任何捏造的客戶、數字、引述和新聞稿。[Our take]
    • 指名道姓的人員和證照是事實:只有在該人員存在且可聯繫時,才顯示審查者、作者或專家;佔位 ID 或失效的個人資料應被省略,並列為未決問題。
    • 從歷史記錄取得的狀態(來自 git 提交或舊筆記的計數)在擁有者確認前都是假設:請標記它。
    • 現有內容屬於擁有者。 在重新設計中,保留範圍(need-goal 所定義的)允許的內容,在 OPEN-QUESTIONS.md 中標記你發現的問題,並且不要添加你自己的主張。
    • 頁面引導用戶去的地方: 首頁繼承了其主要操作所引導的頁面的主張;檢查主要的三個。
  3. 自動化不等於可及性。 review_design 通過表示未發現自動化失敗。請說明仍需要真人檢查的部分。
  4. 切勿聲稱你並未執行的使用者測試。 規劃測試,要求擁有者執行,記錄真實答案;將任何模型審查標記為模型審查。
  5. 當你修復或接受某個問題時,引用規則 ID(例如「違反 a11y-contrast-text」)。
  6. 在複製參考之前,先閱讀其稽核報告。 參考網站的可及性失敗不屬於其風格的一部分。

4. 請示擁有者

  • 僅在決定屬於擁有者(品味、品牌、預算、核准)或事實缺失且無法預設時才請示。將問題集中在同一則訊息中。每個問題都提出以字母排列的答案,建議選項優先,並附上你自己的草稿,以便擁有者可以回覆「a, a, b」;不允許直接提出開放的未決問題。
  • 需要擁有者參與的步驟:needs-alignment, brief-review, ref-gather (關卡 1, 品味吸收)、explore-directions (關卡 2, 方向表)、decide-test, decide-choose, realize-assets (付費圖片), realize-build (技術棧), realize-launch。
  • 品味屬於擁有者,並從圖片中決定。 讓選擇成本低廉且資訊充分,然後等待。只有兩個關卡:(1) 在 ref-gather 開始時的品味吸收:來自資料庫的風格組合,每個搭配一個快速的主視覺草圖(taste_intake);(2) 方向表:將安全、伸展和創意概念並列顯示在兩種尺寸下(propose_directions,render_sheet)。你自己的評分只是建議,絕非決定。
  • 選項關卡:未經此關卡,任何內容都不得送交擁有者。 提供給擁有者的每組選項(方向、主視覺概念、改編區塊、任何類型的模擬圖,以及 whata.design 自己的頁面和模擬圖)都必須先通過以下四個檢查,順序如下:(1) 由工具製作: 選項應使用 propose_directions 起草,並使用 render_sheet 以兩種尺寸顯示,絕不能以手作模擬圖或一次性圖片的形式呈現。區塊軌道的資料庫來源和重建項目表則來自 list_library_sections;作為選項顯示的改編區塊仍需進行檢查 2 至 4。(2) 已審查: 每個選項都必須通過 review_design,且無任何阻擋級別,以及無以下次要問題:distinct-hero-not-template、distinct-no-decorative-glow、distinct-no-accent-word-headline、distinct-eyebrow-restraint(只有方向檔案中記錄的例外才能繞過一個)。(3) 盲評分: 一位全新的評論者(一個未見過任何筆記、程式碼或先前回合的子代理人)僅根據截圖對每個選項進行評分,使用 get_critic_brief;分數作為模型的評分記錄,附在方向表旁。(4) 記錄擁有者的評分: 擁有者對每個選項評分 1 到 10 分,你使用 record_taste 記錄每個分數(類型為 score,round 命名關卡和選項,slugs 顯示其詞語)。未能通過檢查 1 或 2 的選項,在任何人看到之前會被修正並重新執行;絕不能將方向表「快速看一眼」就送出。展示它們: 先發送方向表,然後每個選項作為其自己的全尺寸圖片(桌面版,旁邊附手機版):合併的方向表對擁有者來說太小,難以判斷。在一個共享的骨架(相同的區塊順序、容器和設計代碼)上建置選項,以便擁有者可以按區塊組合它們;擁有者確實會這樣做(「B 作為主視覺,C 作為下一個區塊」),而這個組合會與每個選項的分數一起,使用 record_taste 記錄為所選項目。擁有者覆蓋的規則(「保留漸層文字」)會以 { ruleId, reason } 的形式進入 design/accepted.json,並附上他們的話語和日期,之後每次執行 review_design 時都會帶入 accepted: "design/accepted.json";阻擋級別的問題不能被覆蓋。這些置中的堆疊、柔和光暈、強調文字和角落標籤,正是擁有者在 2026 年 11 月 17 日於我們自己的模擬圖中辨識出為 AI 生成的東西。[Our take]
  • 兩種品味。 資料庫是策展人的品味:其中的每個網站都是好的,即使是低調的網站,所以它是品質門檻,永遠不被評分,而且其中任何一個都不是「安全預設」。你要學習的是專案擁有者(客戶)的品味:使用 record_taste 記錄他們的意見,並將其關聯到專案資料夾,然後將專案傳遞給 taste_intake、propose_directions 和 recommend,以便他們的個人檔案,或同一領域中較早的客戶,能夠選擇你建議的答案。這絕不會取代提問。剛開始從截圖中進行選擇的客戶,可以先從 8 到 10 組 A vs B 對開始(taste_pairs)。
  • 品味關卡時擁有者不在:停止。 完成方向表,將選擇設為 OPEN-QUESTIONS.md 中唯一的阻擋問題,並且在記錄「擁有者選擇:」之前,不要在網站樹中建置任何內容(無設計代碼,無原型)。不依賴於此選擇的工作可以繼續。像 ASSUMED 這樣的標籤並不能使品味猜測變得安全:在一次真實執行中,模型選擇了最安全的方向來建置,而擁有者的裁決是「真的很無聊」。
  • 任何其他決定時擁有者不在:不要停止。 為每個問題寫下你的預設方案,繼續進行,並將依賴於它的內容標記為 ASSUMED, not owner-approved(假設,未經擁有者核准);將問題收集在 design/OPEN-QUESTIONS.md 中。絕不能為擁有者或測試未執行的事項寫下「已核准」、「已確認」或「已測試」;需要真人參與的結果保持為 UNTESTED(未測試)。

5. 品質門檻

  • 嚴重性:阻擋(絕不為了風格而妥協;在任何事情完成前必須為零)、主要(需修正,或由擁有者書面接受)、次要和建議(按優先級處理)。
  • 風格不能豁免設計。 每種風格都有一個配方,可以在保持其外觀的同時通過規則:為任何使用暗色、霓虹、玻璃、粉彩、極簡、3D、影片、環境循環、跑馬燈、滾動故事、視差、預載器、非典型導覽、水平滾動、表現性字型或主題切換的方向呼叫 get_recipe。
  • 帶著規則提示進行建置(rules/build.md:所有阻擋和主要級別、COGA 規則和共享模式),並經常執行 review_design。
  • 受眾驅動的升級。 如果受眾包含處於壓力下的人、識字率低的人、使用第二語言閱讀的人、有認知或學習障礙的人、或使用螢幕閱讀器或患有閱讀困難症的使用者,則本專案的 15 條 a11y-coga-* 規則將升級為主要級別,且簡報中應予說明。[Our take]
  • 高風險建議(法律、醫療、財務、安全)在上線前需要合格的審查者(copy-expert-review-before-launch);在此之前,它帶有草稿標記。緊急協助:配方 urgent-help-route;沒有後端的表單:form-no-backend-and-privacy。[Our take]
  • 衝突規則:較高嚴重性者優先;如果相同,請示擁有者並記錄選擇。已知的衝突及處理方式在 rules/build.md 中。

6. 獨特性與工藝

通用是預設的設計選擇。需有意識地避免:

  • 執行置換測試:放入競爭對手的名稱;如果標題和版面仍然合適,則重寫。你所保留的每個預設(常見字型、色調、卡片網格)都需要一個書面理由;從簡報中選擇,而不是從禁止列表中選擇。
  • 每個方向都有一個該領域預設頁面所缺少的主要元素(主視覺物件、版面構想、字型手法或互動方式;get_moves 列出了帶有資料庫範例的常見元素)。它應位於網頁上方摺線處,在頁面下方再次出現,並且 taste_intake 會針對它進行評分。該元素是避免通用化的主要載體,但它本身並不能通過區塊關卡。
  • 在實現-減法的步驟中建置核心互動——載入動畫、懸停效果、導覽轉場、字型微調中的版面變化——然後移除任何不服務於互動或內容的部分。每種互動都需要一個url(…) 路徑,以便可以獨立打開它,自 2026 年 11 月 17 日起生效。[Our take]
  • 在實現-掃描中,執行18個完整性檢查點(list_sweep_checks)。

7. MCP 工具與命令

伺服器在 tools/ 中公開這些內容:get_process(帶有 track 參數)、get_step、get_base、get_recipe、recommend(用於方向建議)、taste_intake(由 whata-taste-time 觸發)、propose_directions、render_sheet、review_design、taste_pairs、record_taste、get_critic_brief、get_library_section、list_library_sections、list_library_tags(用於特定標籤的推薦)、list_sweep_checks。除了 review_design 和 taste_intake 之外,本地檔案是預設的;MCP 版本需要一個經過驗證的 tldraw 外掛程式處理器(第 8 節)和一個 OpenAI 金鑰,自 2026 年 11 月 17 日起生效。

8. 安全層

  • 內容安全策略(CSP):content-security-policy.md。
  • 潛在危害指令:rules/harmful-prompts.md 定義了對敏感請求(自我傷害、創傷內容等)的處理方式。

相關技能