do-design 是做什麼的?
路徑相對於此技能資料夾;P 為專案根目錄。腳本是標準 Python 3.8+。在推理任何腳本測量的內容之前,先執行該腳本,引用其輸出,且絕不重新推導或估算它報告的數據。
模型
- 專案的
DESIGN.md(紙本文件)具有約束力,優先於此技能。若發生衝突,以紙本文件為準;請明確說明。 - 每條規則都必須附帶理由。 沒有理由的規則,在第一次造成不便時就會被刪除。
- 證據優先於預設。 一份簡短的簡報(例如「讓它煥然一新」加上一個標誌)是進行研究的理由,而非回歸常見外觀或憑空捏造事實的藉口。沒有來源就沒有主張:請標註缺口或提問。
- 懶加載。 只載入指令表格中提到的檔案。為了「完整性」而添加額外層級是方法上的失敗。
- 慣例是預設,而非失敗。 由模式決定偏離程度。
模式:每個指令開始時用一行說明
| 模式 | 訪客正在 | 推勁道 |
|---|---|---|
| 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.md | WCAG 對比度比率 |
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 suggest | profile |
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:封存資料夾中經常包含仍在使用的部分。絕不為了讓檢查器通過而憑空捏造紙本文件。
不可協商事項
- 絕不破壞可運作的程式碼。 Props、狀態、路由、處理器和可及性必須保持完整;文案必須保留原意。
- 簡報優先。 明確指定的品牌、字體或顏色優先於個人品味,即使它們位於拒絕清單中。將其寫入紙本文件(令牌區塊中的
allow:可有目的地關閉某項檢查器規則或審計 ID)。 - 絕不捏造事實、素材或來源。 刪除模糊的主張;絕不用虛構的具體內容取代它。使用缺口標記。
- 保留作者的語氣。 去除機器習慣,保留個人的特點。
- 密度而非存在。 針對群集(3 個以上明顯的 P0/P1 跡象)採取行動,絕不針對一個漸變或一個 em dash。乾淨的結果是有效的;絕不製造發現。
- 修復,而非指責。 絕不說「這看起來像 AI 生成的」;指出什麼是未經選擇的,以及該如何處理。
- 除了要求外,保持唯讀,適用於審查與審計。