Community影像github.com

低擬真草稿線框圖

生成手繪風格的低擬真度行動裝置線框圖(不完美黑色筆觸、手寫字、陰影線、交叉圖像框),每個畫面輸出為 PNG,並附帶並排比較圖。適用於任何需要低擬真線框圖、草稿、手繪模型或用戶流程替代方案比較的專案。

低擬真草稿線框圖 是什麼?

這項技能用於生成手繪風格的低擬真度行動裝置線框圖,完全透過 Python 和 Pillow 程式碼繪製,無需 HTML 截圖或外部字型。它提供一個名為 `Screen` 的 API,讓使用者能以從上到下的方式組合畫面元素,包含標題、文字、媒體、輸入欄位、按鈕等,並且支援多個提案(N ≥ 1)的比較分析。每個提案的視覺風格遵循黑底白字、不完美筆觸、大寫手寫字、剖面線填充等規則,確保草稿感。最終輸出為一組 PNG 檔案(每個畫面一張)以及 All_Proposals.png 比較圖,適合用於探索資訊架構與流程,而非呈現最終 UI。技能支援 Claude Code、Cursor 及一般 AI Agent 與程式碼環境。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/3lCR3P3R/lowfi-sketch-wireframes/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

低擬真草稿線框圖 是做什麼的?

這項技能產生的行動裝置畫面看起來就像在紙上或 FigJam 中繪製。其目的在於探索結構與流程,而非呈現最終的使用者介面。所有內容皆透過程式碼(Python + Pillow)繪製:不使用 HTML 截圖,也不使用外部字型。

檔案

檔案用途
scripts/lowfi_kit.py主要函式庫。 Screen 類別從上到下使用游標(無需座標)配置畫面。render_project() 寫入 PNG 檔案、比較圖並執行檢查。
scripts/template_project.py起點。 包含 2 個提案 × 3 個畫面的虛構範例。複製並取代其中的畫面。
scripts/sketch.py繪圖基礎:抖動線條、矩形、圓形、交叉方塊、圖示。
scripts/hand.py一筆一畫繪製的大寫手寫字、剖面線(hatch)以及剖面線佔位長條(bar)。
examples/template_output.png範本的輸出結果,作為視覺參考。

需求:Python 3 + Pillow(pip install pillow)。

cp scripts/template_project.py my_flow.py   # 編輯畫面
OUT=./MyProject_Wireframes_v1 python3 my_flow.py

(將 my_flow.py 與 lowfi_kit.py、sketch.py 及 hand.py 放在同一目錄,或將 scripts/ 加入 sys.path。)


1. 工作流程

  1. 理解需求: 產品、使用者、流程、畫面數量及裝置尺寸(預設 375 × 812)。 在開始繪製前詢問想要多少個提案(參見「提案數量」)。預設值:2。
  2. 在繪製前撰寫每個畫面的最低限度內容: 標題、操作、範例資料與狀態。所有提案使用相同的資料。
  3. 在組合前定義提案之間的結構性差異(第 4 節)。
  4. 將每個畫面撰寫成函數 def screen(s): ...,使用 Screen 的方法。
  5. 執行 render_project({...}, out, "Title")。
  6. 驗證(第 5 節)並修正。
  7. 交付在一個有版本號的資料夾中(<Project>_Wireframes_vN/),切勿覆蓋舊版本。若被要求,新增 UX_ANALYSIS.md(第 6 節)。

提案數量(N)

提案數量是一個變數 N ≥ 1,預設值為 2。

  • 在組合前務必詢問,除非使用者已提供數字。當可行時使用選擇題,例如:「你希望這個流程有幾個替代提案?」 → 2(建議) · 1 · 3 · 其他。
  • 如果無人回答(無人執行的執行環境),則使用 2,並在交付內容頂端說明你使用了預設值。
  • N = 1: 跳過第 4 節的比較規則;只產生 Proposal_1_Full.png。
  • N ≥ 3: 每個提案都需要其自己的主導結構。抽象化測試適用於每一對提案,而不僅是前兩個。若無法讓某個提案具有真正的差異性,請提出並建議使用較小的 N 值,而非產生近似的重複提案。
  • render_project 接受字典中的任意數量項目。它為每個提案寫入一個 Proposal_<i>_Full.png,並將所有提案合併到 All_Proposals.png。

2. Screen API(lowfi_kit)

所有元素從 y≈98 處開始垂直堆疊。開頭的 "*" 表示該選項已被選取。

區域方法
頁首header(title, left='back'│'x'│'menu'│text, right=text, chip=text, link=text)
文字title(s) · text(s, cap, gray, bold) · label(s) · hint(s) · link(s) · lines(n) · placeholder_bar(frac)
媒體image(h)(交叉方塊) · avatar(cx, cy, initials)
輸入field(label, value│[lines], multiline) · select(label, value) · search(text) · radios([...]) · checkboxes([...]) · toggle(label, on) · chips([...]) · segmented([...], active) · tabs([...], active) · stepper(label, value, unit)
進度progress(n, total, name)(步驟列) · steps([names], current)(1 → 2 → 3)
內容list_item(title, sub, avatar, right, chevron, selected) · card_grid([labels], cols) · kv([(key, value)]) · row_edit(label) · check_line(s) · info(s, sub)
分組begin_box(title, kind='normal'│'strong'│'dashed', state='open') … end_box() · accordion(title, 'done'│'closed', right)
驗證alert(title, sub, chips)(虛線框內含「!」) · note([lines])(設計註解,非 UI)
按鈕button(label, 'pri'│'sec'│'off') · buttons([(label, kind), ...])
底部區域footer([(label, kind), ...])(固定式行動呼籲按鈕) · nav([(icon, label)], active) · fab(label, sub, hint)
變體sheet(title, dim_title)(底部工作表,背景變暗)
  • 可用圖示:home search list chat user bell plus back x chev down。
  • 對於未涵蓋的情況,可直接在 s.d(Sketch)上繪製,並使用 hand(s.d, x, y, text, cap)。
  • Screen(w=390, h=844) 支援其他尺寸;render_project(..., w=390, h=844) 會將其傳遞。

3. 視覺規則

  1. 僅使用黑白兩色。 灰色用於次要文字和註解。無顏色、漸層或陰影。
  2. 到處都是不完美的筆觸: 輕微抖動、線條末端超出、重疊閉合。
  3. 畫面內使用大寫手寫字。 尺寸:標題 12–15,內文 8–10,註解 7,標籤列最小 6。lowfi_kit 會在文字無法容納時自動縮小。
  4. 無實心填充按鈕: 主要按鈕 = 雙重外框;次要按鈕 = 單一外框;停用按鈕 = 灰色虛線。
  5. 選取狀態 = 剖面線(底部條紋或填充),從不使用黑色區塊。
  6. 示意性填充: 名稱和次要標題使用剖面線長條,段落使用線條,圖片使用交叉方塊。
  7. 最少文字: 只保留理解每個決策所需的內容。
  8. 無裝飾性元素: 每個元素都必須傳達某種功能。
  9. 平衡的留白: 如果畫面超過三分之一是空的,請將主要操作上移或緊湊配置。切勿用裝飾填滿。

4. 比較提案的 UX 規則

  • 相同情境: 相同使用者、相同資料、相同功能、相同畫面數量、相同最終結果。只有資訊架構、導覽、層級和操作安排可以改變。
  • 抽象化測試: 簡化為方塊和箭頭後,每個提案仍必須與其他所有提案看起來不同。每個提案都需要其自己的主導形狀,例如:
    • 引導式: 一列步驟、進度條、每個畫面一個行動呼籲按鈕、缺少必要欄位時進度受阻;
    • 模組化: 標籤頁或卡片網格、可摺疊區段、可原地修正的檢閱、復原;
    • 其他選項:搜尋優先、對話式、卡片式、單一長頁面。
  • 每個畫面只顯示一個狀態。 確認訊息、後續狀態及規則應使用 note() 記錄,或放在一個清楚分開的額外畫面中。
  • 看起來相似的操作必須用微文案區分(例如「類別已預選」 vs 「無類別」)。
  • 防錯與回饋保持可見: 必要欄位加上 *,警告使用 alert(),停用按鈕使用 'off'。
  • 未經使用者測試取得證據前,切勿宣布某個提案獲勝。

5. 交付前的驗證

render_project 已會針對以下三件事發出警告:

  • ⚠ … content reaches y=…:畫面溢出。移除內容或縮小高度。
  • ⚠ Characters without a glyph:某些字元被繪製成空白。請取代它們或將它們加入 hand.py(第 7 節)。
  • 如果任何一個畫面不是精確的 w × h,腳本會因 assert 而停止。

另外目視檢查 Comparison/All_Proposals.png 比較圖:

  • 無重疊文字,且所有內容都在框架內;
  • 所有畫面之間視覺一致;
  • 提案之間確實不同(抽象化測試)。

6. 交付結構

<Project>_Wireframes_vN/
├── Proposal_1_<Name>/01_<Screen>.png …
├── Proposal_2_<Name>/…
├── …                      (每個提案一個資料夾,總共 N 個)
├── Comparison/Proposal_1_Full.png … Proposal_N_Full.png · All_Proposals.png
└── UX_ANALYSIS.md   (若被要求)

比較圖將畫面未縮放、水平對齊、間距 40 像素貼上。

建議的 UX_ANALYSIS.md:

  1. 先前版本的問題。
  2. 變更及其 UX 理由(適當時引用 Nielsen 的啟發式評估)。
  3. 提案之間的差異對照表。
  4. 每個流程的優勢與限制。
  5. 需要與使用者驗證的問題。

7. 擴充

  • 新字元: 在 hand.py 的 G 中新增,格式為 'X': (width, [[(x, y), …], …])。網格為 6 單位高,y = 0 在頂端。目前已包含 A–Z、Ñ、Ü、重音母音、0–9 以及 + - = % # $ & @ ' " , . : · ! ? ¿ ( ) [ ] / * < > → ← —。
  • 新圖示: 使用相對於 (cx, cy) 和尺寸 s 的線條或圓形,加入 Sketch.icon()。
  • 新元件: 在 Screen 中新增一個從 self.y 開始繪製並在完成時推進 self.y 的方法。
  • 增加或減少抖動幅度: 調整 _wobble 中的 amp(方塊約 0.9,字母約 0.25)。

相關技能