Penpot 设计
仅限 Penpot MCP — 除非被要求,否则不要并行使用 HTML/CSS。在写入之前,先阅读 high_level_overview 一次;然后检查目标页面(shapeStructure、组件/设计令牌)。
先询问
- 模式:
mockup(原型)还是design(设计)? - 指令: 要构建/更改的内容。仅当被问及时才提供多变体替代方案。
- 平台: 如果项目规则已设置,则使用项目规则;否则询问。切勿假设为 iOS/Android/Web。
缺少任何一项时停止。
模式
原型 — 低保真验证:结构、层次、流程;简单的填充、真实的间距;除非被要求,否则不进行打磨。
设计 — 更高保真度:设计令牌、排版、状态、界面框架。遵循相同的组件/flex 规则。优先选择分组 → 组件化 → 细化,而不是重建。
规则
组件: 出现两次 → 组件/实例。相同基础,不同状态 → 变体(Active、State、Size……)。在主组件上构建结构;在副本上进行覆盖;仅使用 detach() 进行分支。命名:Toolbar/Button;图层:background、icon、label(在变体间保持一致)。深度 ≤ 4;主组件内不能有主组件。
布局: flex/grid;如果存在子元素,使用 penpotUtils.addFlexLayout。间距:8dp 比例(4 为半步)。控件:请参考 material-alignment.md。激活状态 = 变体/样式,而非布局偏移。Z 顺序:背景 → 内容 → 覆盖层。
构建树: 仅由外而内 — 容器(空 + flex)→ 其直接子元素外壳(按 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 - 否: 仅限本次会话。除非用户现在要求,否则切勿在任务中途编辑技能。
完成检查
- 模式、指令、平台(如果需要)已确认
- 重复项是组件;不同状态是变体
- Flex/grid + Material 启发式控件对齐
- 画布由外而内构建(容器 → 子外壳 → 嵌套元素)
- 原型模式低保真 / 设计模式高保真;已检查导出