Communitygithub.com

Penpot 界面模型设计

以用户为中心的工作流程,在 Penpot 中规划和构建不同保真度的 UI 模型,遵循六步设计法和由外到内的画布构建顺序。适用于在 Penpot 中创建屏幕模型、低保真/高保真 UI、平台特定布局以及遵循最佳实践。

Penpot 界面模型设计 是什么?

该技能提供了一套完整且结构化的方法论,专门用于在 Penpot 设计工具中创建 UI 模型(Mockup)。其核心在于遵循一个以用户为中心的六步工作流程,从定义目标与范围、创建线框图,到应用网格系统、色彩和排版,再到构建 UI 组件和细化细节,确保设计从结构到视觉的逐步完善。技能强制要求采用由外到内的画布组装顺序,即先创建容器,再构建内部的子部分和元素,以保证图层逻辑的清晰和可维护性。该技能支持基于 `penpot-design` MCP 工具,通过区分“mockup”和“design”模式来处理低保真(验证结构和流程)和高保真(客户端就绪或开发交付)两种设计需求,并内置了关于线框图、模型和原型之间差异的清晰定义,以及多个实用检查清单和常见陷阱提示,帮助设计者避免过早陷入细节而忽略整体结构。

兼容平台~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 MCP 工具执行(涉及组件、弹性布局、API、由外到内树形结构)。执行写操作前,请先阅读 high_level_overview 一次。

首先确认

当以下任何一项缺失时,请立即停下并询问:

  1. 目标与范围 — 是网站、移动应用、桌面应用还是响应式设计?涉及哪些屏幕或流程?
  2. 受众 — 谁将使用这个产品?(例如,老年用户 → 需要更大的字体和更简单的导航)
  3. 保真度 — 是低保真(关注结构、布局、流程)还是高保真(关注色彩、排版、图像、细节打磨)?
  4. 平台 — 移动端、网页端、桌面端还是响应式。如果项目已设置规则,则遵循规则,否则请主动询问。切勿自行假设。
  5. 指令 — 需要构建或修改的具体内容。仅在被要求时才提供多方案替代。

界面模型 vs 线框图 vs 原型

阶段目的Penpot 侧重点
线框图布局、层级结构、用户流程 — 无视觉打磨使用简单形状、占位符,确保真实间距
界面模型视觉设计 — 外观和感觉,UI 细节此技能的核心
原型交互性 — 点击、流程、状态仅在用户要求时制作;使用变体表示状态

默认创建静态视觉模型,除非用户明确要求交互或原型行为。

保真度

低保真 — 快速验证结构和流程。使用简单的填充色、占位符和对齐网格的布局。在打磨细节之前,先迭代布局和用户流程。对应 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. 屏幕/容器面板(空的 + 弹性布局)
  2. 直接子级区域外壳(如头部、主体、底部等),按 Z 轴顺序排列
  3. 每个区域的组件,以及这些组件的子元素,递归进行

永远不要先创建叶子节点然后去包裹它们。完整规则请见:../penpot-design/references/build-order.md

最佳实践

  • 以用户为中心 — 根据用户目标进行设计;考虑用户画像和旅程中的摩擦点。
  • 无障碍性 — 使用清晰易读的字体、足够的对比度,避免仅通过颜色传达信息;在相关结构上确保可通过键盘导航。
  • 视觉一致性 — 所有屏幕使用一套风格指南:统一的字体、颜色、间距和图标。
  • 贴近现实 — 考虑实际的屏幕尺寸和方向;当平台支持多设备时,采用响应式布局。
  • 迭代反馈 — 优先处理关于布局、字体、颜色和流程的可行反馈,而不是主观的打磨。

核心组件检查清单

每个屏幕模型应检查以下项目:

  • 布局与构图(网格、对齐、层级)
  • 色彩与排版(配色方案、可读字体)
  • UI 组件与图标(操作按钮、输入框、导航 — 组件化)
  • 图片与媒体(相关且不造成干扰)
  • 品牌呈现(Logo、品牌色、字体使用保持一致)

常见陷阱

挑战应对方法
过早陷入过多细节保持低保真,直到布局和流程通过验证
受限于时间、技术或预算关注 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.

相关技能