Communitygithub.com

Penpot 模型設計

在 Penpot 中以使用者為中心的工作流程、分階精細度、六步驟流程以及由外而內的畫布組裝方式,規劃並建構 UI 模型。適用於建立模型、畫面模型、線框圖轉模型、低/高擬真 UI、特定平台版型,或在 Penpot 中遵循模型設計最佳實務。

Penpot 模型設計 是什麼?

此技能定義了一套在 Penpot 中設計 UI 模型的系統化方法,適用於 Claude Code、Cursor 等支援 Penpot MCP 的 AI 代理平台。它強制執行一個以使用者為中心的六步驟流程:定義目標與範圍、繪製線框圖、建立網格系統、套用色彩與排版、建構 UI 元件,最後精煉細節。在繪製時,技能要求遵循由外而內的畫布組裝順序(容器 → 子區塊殼層 → 巢狀元素),以確保圖層結構的一致性和可維護性。技能也明確區分 wireframe(佈局)、mockup(視覺設計)和 prototype(互動)三個階段,預設專注於靜態模型,並提供低擬真與高擬真兩種精細度選項。此外,它還包含了可及性、視覺一致性、真實世界考量(螢幕尺寸、方向)以及迭代回饋等最佳實務指引,並透過完成檢查清單確保所有關鍵步驟沒有遺漏。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/penpot-mockup

在你喜歡的 AI 中提問

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

說明文件

Penpot 模型設計 是做什麼的?

在 Penpot 中進行模型設計的方法論。透過 penpot-design(元件、Flex 排版、API、由外而內的樹狀結構)搭配 Penpot MCP 執行。在進行寫入操作前,請先閱讀一次 high_level_overview。

先提問

遇到以下任一資訊缺失時,請先停止:

  1. 目標與範圍 — 這是網站、行動應用程式、桌面應用程式還是響應式設計?需要設計哪些畫面或流程?
  2. 目標受眾 — 誰會使用這個產品?(例如:年長使用者 → 較大的字體、更簡單的導覽)
  3. 精細度 — 是 low(結構、佈局、流程)還是 high(色彩、字體、圖片、修飾)?
  4. 平台 — 行動裝置、網頁、桌面還是響應式。如果專案已有規則,請遵循;否則請提問,切勿自行假設。
  5. 指示 — 需要建立或修改的具體內容。僅在使用者要求時,才提供多重變化的替代方案。

模型 vs 線框圖 vs 原型

階段目的Penpot 的關注點
線框圖 (Wireframe)佈局、層級結構、使用者流程 — 無視覺修飾簡單形狀、佔位符、實際間距
模型 (Mockup)視覺設計 — 外觀與感受、UI 細節此技能
原型 (Prototype)互動性 — 點擊、流程、狀態僅在使用者要求時才處理;使用變體來處理狀態

除非使用者明確要求互動或原型行為,否則預設保持為 靜態視覺模型。

精細度

低擬真 — 快速驗證結構與流程。使用簡單填充、佔位符和網格對齊的佈局。在開始修飾前,先迭代調整佈局和使用者流程。對應 penpot-design 中的 mockup 模式。

高擬真 — 可交付客戶或用於開發交接。包含色彩組合、字體、圖片、品牌元件。對應 penpot-design 中的 design 模式。

六步驟工作流程

請依此順序進行。在結構驗證完成前,不要跳過步驟直接進行修飾。

  1. 定義目標與範圍 — 目的、目標受眾、平台限制。
  2. 線框圖 — 使用佔位符勾勒區塊、內容區域、導覽、行動呼籲按鈕。專注於層級結構和流程。
  3. 網格系統 — 對齊元素;保持一致的間距(依照 penpot-design 的 8dp 比例)。建立視覺層級(標題 > 輔助文字)。
  4. 色彩與字體 — 使用有限的色彩組合;選擇易讀的字體(大小、行高、字距);確保足夠的對比度。請參閱 mockup-practices.md。
  5. UI 元件 — 按鈕、輸入框、導覽列、圖示。出現兩次即建立為元件。狀態則使用變體。元件的位置和大小對可用性至關重要。
  6. 精煉細節 — 圖片、圖示、間距、對比度。使用 export_shape 來匯出驗證。

畫布組裝(必要)

上述方法論是 需要決定什麼。在 Penpot 中繪製時,請遵循 penpot-design 的由外而內順序 — 不要自行發明不同的圖層順序:

  1. 畫面/容器底板(空的 + Flex 排版)
  2. 直接子層的區塊殼層(頁首、內容區、頁尾等),按 Z 軸順序排列
  3. 每個區塊內的元件,然後是這些元件的內部元素,依此類推遞迴

切勿先建立葉節點再將它們包裹起來。完整規則:../penpot-design/references/build-order.md

最佳實務

  • 以使用者為中心 — 為使用者目標而設計;考慮人物誌和流程中的痛點。
  • 可及性 — 可讀的字體、足夠的對比度、避免僅以顏色傳達資訊;在相關處保持鍵盤可導覽的結構。
  • 視覺一致性 — 單一風格指南:所有畫面統一使用同一套字體、色彩、間距、圖示。
  • 真實世界考量 — 考慮螢幕尺寸和方向;當平台支援多種裝置時,使用響應式佈局。
  • 迭代回饋 — 優先處理關於佈局、字體、色彩和流程的可執行回饋,而非主觀的修飾。

核心元件檢查清單

每個畫面模型應包含:

  • 佈局與構成(網格、對齊、層級結構)
  • 色彩與字體(色彩組合、易讀字體)
  • UI 元件與圖示(行動呼籲按鈕、輸入框、導覽 — 以元件化方式建立)
  • 圖片與媒體(相關性高、不造成雜亂)
  • 品牌識別(標誌、品牌色彩、字體保持一致)

常見陷阱

挑戰應對方式
過早陷入過多細節在佈局和流程驗證完成前,保持低擬真
資源限制(時間、技術、預算)專注於 MVP 功能;重複使用設計系統元件
利害關係人意見不一致提供設計理由;將決策與使用者目標連結

深度參考:mockup-practices.md

完成檢查清單

  • 目標、受眾、精細度、平台、指示已確認
  • 結構優先於修飾(線框圖 → 網格 → 設計代碼 → 元件 → 細節)
  • 畫布由外而內建立(容器 → 子區塊殼層 → 巢狀元素)
  • 以使用者為中心、可及性高、視覺一致
  • 依照 penpot-design 建立元件/變體;已檢查匯出結果

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Monitor one GitHub PR for new review feedback, implement only meaningful fixes, and answer reviewers with evidence, friendly wit, and pushback on unrealistic or overly defensive comments. Use when the user asks to babysit, watch, or monitor Codex/reviewer comments on a PR.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

相關技能