SuperAPI AI 工具集

pencil-ui-design-system-vant

设计与创作

查看项目

更新于 10-16 14:23

技能介绍

用途

该技能用于初始化一套基于 Vant 规范的界面设计系统。其目标有两部分:一是在 .pen 文件中建立全局色板与设计令牌;二是创建初始的组件库画布(Component Overview)。

使用前提与触发条件

使用该技能存在明确约束:仅在用户明确提及“Pencil”和“Vant”(或“Vant 4”)时,或在编排 Pencil 设计系统初始化任务时使用。

主要能力

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

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

通过 mcp__pencil__set_variables 注册 Vant 设计令牌,遵循 .pen 文件 schema。资料中明确给出的令牌包括:

  • 主色与语义色:van-primary-color: #1989fa、van-success-color: #07c160、van-warning-color: #ff976a、van-danger-color: #ee0a24、van-gray-color: #323233。
  • 文本与边框:van-text-color: #323233、van-text-color-2: #646566、van-text-color-3: #969799、van-border-color: #ebedf0、van-border-radius: 4px。
  • 字体:van-font-size-md: 14px。 如需更多令牌,可从 Vant 主题文档中补充。

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

通过 mcp__pencil__batch_design 创建一个“Components Overview”画布,并按 Vant 文档的分组组织各区块:

  • 基础(Basic):Button、Cell、Icon、Image、Layout、Popup、Space、ConfigProvider。
  • 表单(Form):Calendar、Cascader、Checkbox、DatetimePicker、Field、Form、NumberKeyboard、PasswordInput、Picker、Radio、Rate、Search、Slider、Stepper、Switch、Upload。
  • 反馈(Feedback):ActionSheet、Dialog、DropdownMenu、Loading、Notify、Overlay、ShareSheet、SwipeCell、Toast。
  • 展示(Display):Badge、Circle、Collapse、CountDown、Divider、Empty、ImagePreview、Laziness、List、NoticeBar、Progress、Skeleton、Steps、Sticky、Swipe、Tag。
  • 导航(Navigation):ActionBar、Grid、IndexBar、NavBar、Pagination、Sidebar、Tab、Tabbar、TreeSelect。 组织画布时使用 Auto Layout。每次 batch_design 调用最多执行 25 个操作。

使用方式

该技能并不直接执行设计操作,而是输出 PENCIL_PLAN,由 Agent 依序调用 Pencil MCP 工具完成:先打开文档,再设置变量,然后批量构建设计,最后可选截图确认。

最佳实践

  • 对照 Vant 主题文档核验令牌取值。
  • 除非明确要求完全重置,否则 set_variables 使用 replace: false。
  • 组件概览画布使用 Auto Layout。

参考资料

资料中列出以下参考文件:references/contract.md(设计令牌与组件命名)、references/official.md(官方文档链接)、references/examples.md(示例 PENCIL_PLAN)、references/components.md(组件规范)。

限制

该技能仅适用于 Pencil 与 Vant/Vant 4 的场景;资料未提供具体的安装命令、收费方式、价格或效果说明,这些信息暂未提供。