Penpot 設計
僅限 Penpot MCP — 除非被要求,否則不要並行使用 HTML/CSS。先讀取一次 high_level_overview;在寫入前檢查聚焦頁面(shapeStructure、元件/代碼)。
先詢問
- 模式:
mockup(草稿)還是design(設計)? - 指示: 要建立/更改的內容。只有在被要求時才提供多重變體方案。
- 平台: 如果已設定專案規則則使用;否則詢問。絕不預設 iOS/Android/web。
缺少任一項時停止。
模式
草稿 — 低擬真驗證:結構、層次、流程;簡單填色、真實間距;除非被要求,否則不做修飾。
設計 — 較高擬真度:設計代碼、排版、狀態、Chrome。遵循相同的元件/彈性佈局規則。優先選擇群組 → 元件化 → 精煉,而非重建。
規則
元件: 出現兩次 → 建立元件/實例。相同基礎,不同狀態 → 變體(Active、State、Size……)。在主要元件上建立結構;在複本上覆寫;僅在需要分支時使用 detach()。命名:Toolbar/Button;圖層:background、icon、label(在變體間保持穩定)。深度 ≤ 4;主要元件內不得包含其他主要元件。
佈局: 彈性/網格;如果存在子元素則使用 penpotUtils.addFlexLayout。間距:8dp 尺度(半級為 4)。控制項:參考 material-alignment.md。啟用 = 變體/樣式,而非佈局位移。Z 順序:背景 → 內容 → 覆蓋層。
建構樹: 僅由外而內 — 容器(空的 + 彈性佈局)→ 其直接子層外殼(Z 順序)→ 遞迴進入每個子層的元素。絕不包裹現有的葉節點。詳細說明:參考 build-order.md。
流程: 函式庫:設計代碼 → 原子元件 → 變體。然後使用建構樹組合畫面。現有工作:群組 → createComponent → 用實例取代重複項。使用 export_shape 驗證。在大量重寫前先規劃。
API: 參考 penpot-api.md。深入探討:儲存庫中的 research/penpot-design-practices.md。
可擴展性
如果回饋可能成為通用的 Penpot 規則(而非專案特定),則詢問:「在我們完成後,將此新增到 penpot-design 嗎?」
- 是: 在任務期間記錄措辭;任務完成後編輯
personal-skills/skills/penpot-design/;重新安裝:
然後確認變更內容。npx skills add cucoreanu/personal-skills --skill penpot-design - 否: 僅限工作階段。除非使用者現在要求,否則絕不在任務進行中編輯技能。
完成
- 已確認模式、指示、平台(如果需要)
- 重複項為元件;狀態為變體
- 彈性/網格 + Material 啟發的控制項對齊
- 畫布由外而內建構(容器 → 子層外殼 → 巢狀元素)
- 草稿低擬真 / 設計高擬真依模式設定;已檢查匯出