Communitygithub.com

do-design

UI 與視覺設計,以具約束力的 DESIGN.md 為依據,並為所有可衡量的項目提供腳本。用於設計或重新設計頁面與元件、審查 UI 變更、審計與評分 UI、重新設計網站、在設計前進行市場調研、推動大膽方向,或在儲存庫中安裝設計護欄。指令:do-audit, do-design-new, do-design-review, do-design-renew, do-crazy。

do-design 是什麼?

do-design 是一套以腳本驅動的 AI 技能,專為 UI 與視覺設計審查、審計與生成而設計,核心法則為一份具約束力的 DESIGN.md 文件。它提供五個主要指令(do-audit、do-design-new、do-design-review、do-design-renew、do-crazy),分別對應審計、新設計、一致性審查、重新設計與大膽創新等場景。技能內建多個 Python 腳本,可測量設計與代碼間的偏差、進行對比度與可及性檢查、渲染頁面截圖分析、市場研究等,所有結果需以結構化資料(如 JSON)輸出,避免以猜測取代實測。支援 Persuade、Operate、Read、Experience 四種模式,用以決定設計偏離慣例的程度。do-design 也提供設計護欄安裝腳本,可將 DESIGN.md 範本與檢查機制整合至專案中。總體而言,它讓 AI 代理能以可重複、可驗證的方式進行設計工作,降低主觀判斷與偏誤。

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

在你喜歡的 AI 中提問

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

說明文件

do-design 是做什麼的?

路徑相對於此技能資料夾;P 為專案根目錄。腳本是標準 Python 3.8+。在推理任何腳本測量的內容之前,先執行該腳本,引用其輸出,且絕不重新推導或估算它報告的數據。

模型

  1. 專案的 DESIGN.md(紙本文件)具有約束力,優先於此技能。若發生衝突,以紙本文件為準;請明確說明。
  2. 每條規則都必須附帶理由。 沒有理由的規則,在第一次造成不便時就會被刪除。
  3. 證據優先於預設。 一份簡短的簡報(例如「讓它煥然一新」加上一個標誌)是進行研究的理由,而非回歸常見外觀或憑空捏造事實的藉口。沒有來源就沒有主張:請標註缺口或提問。
  4. 懶加載。 只載入指令表格中提到的檔案。為了「完整性」而添加額外層級是方法上的失敗。
  5. 慣例是預設,而非失敗。 由模式決定偏離程度。

模式:每個指令開始時用一行說明

模式訪客正在推勁道
Persuade決策與行動強:模板就是失敗
Operate完成任務節制:慣例是特色
Read理解事物中等:閱讀舒適度優先
Experience沉浸於作品中強:成品本身主導

根據表面而非產品選擇:開發者工具的首頁是 Persuade,其設定畫面則是 Operate。

指令:載入一個指令檔案,加上其行名所指的內容

指令使用時機同時載入風險
do-design-review「這符合紙本文件嗎?」成本最低,最常執行專案的 DESIGN.md-
do-audit「這有多好?」評分加上排名發現references/critique-rubric.md、references/slop-catalog.md、範圍涵蓋的 00-05 層-
do-design-new「建構 X」:符合慣例、勝任、遵循紙本文件layers/00、任務觸及的 1-3 層;若簡報簡略或面對客戶,則加上 layers/06低
do-design-renew「重做這個外觀」:全新世界,相同的產品真實性layers/00、layers/06中等
do-crazy「做出這個領域中沒有人會做的事」layers/00、layers/06高,刻意為之

層級:00-craft-floor(所有模式)· 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research。撰寫紙本文件:templates/DESIGN.md、examples/01-two-papers.md、references/interview.md。

腳本(全部接受 --json)

執行產出
scripts/check-design.py --root P與紙本文件令牌區塊的偏差。退出碼 0 表示無偏差,1 表示有偏差,2 表示無紙本文件/令牌。--init 從程式碼草擬令牌
scripts/audit.py scan P來源說明(ID 與 slop 目錄一致)、可及性與瀏覽器表面缺口、價值庫存
scripts/audit.py copy P散文與微文案說明、句子節奏、未填補的缺口標記
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdWCAG 對比度比率
scripts/audit.py score H L S C T U D加權評分、等級、工作清單
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE]在 1280/768/390 解析度下的繪製頁面:重疊、橫向捲動、裁剪、繪製對比度、點擊目標、焦點可見性。--inject-css 可在部署前針對已上線頁面測量 CSS 修復。需要 Chrome/Chromium
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh P從範本產生 DESIGN.md、AGENTS.md/CLAUDE.md 區塊、檢查器

螢幕截圖消耗的上下文遠多於腳本輸出:僅在需要肉眼判斷時(層級、區別、構圖)才使用,且僅限於視口,優先使用 390。腳本也可能出錯:在回報看似不合理的 P0 問題前,先確認一次(透過針對性截圖或元素幾何資訊),若為誤報則修正腳本。

共享定義

互換測試。 將產品名稱替換為競爭對手名稱。如果沒有出現問題,則該頁面並未真正表達此產品的特色:是未經選擇,而非不好看。應透過文案、視覺元素和一個獨特的細節來修正,絕不能靠添加裝飾。

方向,五行。 在開始建構前撰寫,展示後等待同意(如果被告知「直接做」,則用一行說明假設):

Product:    一句平實的話說明它做什麼、為誰而做
Character:  2-3 個具體的詞彙(絕不使用:乾淨、現代、時尚、簡約、高級)
World:      它所屬的場所或材質;設定中性色調、強調色、意象
Moments:    1-2 個畫面變豐富的地方
Signature:  一個只有此產品才有的細節,且一致使用

缺口標記。 [需要數量]、[需要來源]、[需要照片] 用於缺少事實或素材的地方。audit.py copy 會列出仍處於開放狀態的缺口;沒有任何缺口可以出貨。

評分:每個評估指令都以此結束

#領域問題權重
1層級結構能否在 2 秒內說出最重要的東西?3
2易讀性對比度、字級、字長、每個寬度都有真實文案3
3系統統一的調色盤、縮放比例、圓角邏輯、動態語言2
4工藝對齊、間距節奏、狀態、瀏覽器表面2
5內容真實性真實資料、具體文案、無虛構聲明3
6可用性任務可完成;操作提示明顯;錯誤可復原3
7區別性是否通過互換測試?2

每個領域以 0-4 分評分(4 = 真正出色,而非「還可以」),並用 audit.py score 計算。等級:85+ 強健,出貨並僅修復 P0 · 70-84 穩健,在修復指定的 P1 後出貨 · 50-69 弱,需要一次真正的修整 · <50 失敗,方向錯誤:重建(do-design-renew)。評分對象是渲染結果,而非原始碼。無法檢查的領域標記為 u:該項計 0 分,顯示為 unverified,絕不做估算。區別性只有在你能說出是什麼讓它成為此產品的獨特之處時才能得 4 分。得分最低的三個領域即為工作清單,每個領域一項行動。

嚴重程度:P0 阻礙出貨(損壞、無法閱讀、硬性禁止),全部報告 · P1 損害信任,最多 5 項 · P2 工藝問題,最多 5 項 · P3 打磨,僅列出。發現格式:[Pn] 位置 - 問題 - 修復方式;腳本發現保留其 ID。

沒有紙本文件

說明「無 DESIGN.md:護欄無從強制執行。」提議撰寫一份(範本 + 訪談),或從程式碼進行改造(check-design.py --init + 訪談 §Retrofit):v1.0 即為出貨版本,舊值放入 legacy:(計數,不視為失敗),缺口放入紙本文件的差異清單中。封存與示範檔案透過令牌區塊中的 skip:(或 --skip a,b)以資料夾或檔案為單位排除在掃描之外。在跳過之前,請先 grep 搜尋 import:封存資料夾中經常包含仍在使用的部分。絕不為了讓檢查器通過而憑空捏造紙本文件。

不可協商事項

  1. 絕不破壞可運作的程式碼。 Props、狀態、路由、處理器和可及性必須保持完整;文案必須保留原意。
  2. 簡報優先。 明確指定的品牌、字體或顏色優先於個人品味,即使它們位於拒絕清單中。將其寫入紙本文件(令牌區塊中的 allow: 可有目的地關閉某項檢查器規則或審計 ID)。
  3. 絕不捏造事實、素材或來源。 刪除模糊的主張;絕不用虛構的具體內容取代它。使用缺口標記。
  4. 保留作者的語氣。 去除機器習慣,保留個人的特點。
  5. 密度而非存在。 針對群集(3 個以上明顯的 P0/P1 跡象)採取行動,絕不針對一個漸變或一個 em dash。乾淨的結果是有效的;絕不製造發現。
  6. 修復,而非指責。 絕不說「這看起來像 AI 生成的」;指出什麼是未經選擇的,以及該如何處理。
  7. 除了要求外,保持唯讀,適用於審查與審計。

相關技能