SuperAPI AI 工具集

pencil-ui-design-system-bootstrap

设计与创作

查看项目

更新于 10-16 12:50

技能介绍

用途

本技能用于初始化一套基于 Bootstrap 规范的设计系统,具体包括两部分:一是设置全局颜色与设计令牌,二是在 .pen 文件中创建初始的组件库框架(Components Overview)。它适合在需要从零搭建 Bootstrap 风格设计系统、并希望将其落到 Pencil 文件中的场景使用。

使用前提与触发条件

技能带有明确约束:只有在用户显式提到「Pencil」和「Bootstrap」时,或正在编排 Pencil 设计系统初始化任务时,才应使用本技能。

主要能力

技能会输出一个 PENCIL_PLAN,随后由 Agent 按顺序调用 Pencil MCP 工具:open_document、set_variables、batch_design,可选调用 get_screenshot。

第一步:初始化变量(set_variables)

使用 mcp__pencil__set_variables 注册 Bootstrap 设计令牌,遵循 .pen 文件 schema。给出的令牌包括:

主色与语义色:

  • bs-primary: #0d6efd
  • bs-secondary: #6c757d
  • bs-success: #198754
  • bs-danger: #dc3545
  • bs-warning: #ffc107
  • bs-info: #0dcaf0
  • bs-light: #f8f9fa
  • bs-dark: #212529

正文与边框:

  • bs-body-color: #212529
  • bs-border-color: #dee2e6
  • bs-border-radius: 0.375rem (6px)

字体:

  • bs-font-size-base: 1rem (16px)

如需更多令牌,可从 Bootstrap 的 Sass 变量 / CSS 变量中补充。

第二步:创建组件概览结构(batch_design)

使用 mcp__pencil__batch_design 创建「Components Overview」框架,并按 Bootstrap 文档划分区块:

布局(Layout):Container、Grid、Stack

内容(Content):Typography、Images、Tables

表单(Forms):Form、Input、Select、Checkbox、Radio、Switch、Range

组件(Components):Accordion、Alert、Badge、Breadcrumb、Buttons、Button group、Card、Carousel、Close button、Collapse、Dropdowns、List group、Modal、Navbar、Offcanvas、Pagination、Placeholders、Popovers、Progress、Scrollspy、Spinners、Toasts、Tooltips

工具类(Utilities):Borders、Colors、Display、Flex、Float、Spacing

使用 Auto Layout 组织框架,每次 batch_design 调用最多执行 25 个操作。

最佳实践

  • 对照 Bootstrap 文档(Sass/CSS 变量)核验令牌值。
  • 使用 set_variables 时,除非明确要求完整重置,否则使用 replace: false。
  • 组件概览框架使用 Auto Layout。

适用场景

需要在 Pencil 中搭建 Bootstrap 规范的设计系统、统一颜色与基础令牌、并生成组件库初始框架的初始化任务。

限制与暂未提供的信息

技能内容明确了触发约束(必须显式提及 Pencil 与 Bootstrap)以及工具调用顺序与操作上限。关于收费、价格、平台支持范围、实际渲染效果等信息,资料中暂未提供。

关键词

pencil、bootstrap、design system、init、variables、components

参考文件

  • references/contract.md – 设计令牌与组件命名。
  • references/official.md – 官方文档链接。
  • references/examples.md – 示例 PENCIL_PLAN。
  • references/components.md – 组件规范。