SuperAPI AI 工具集

pencil-mcp-get-variables

设计与创作

查看项目

更新于 10-16 10:21

技能介绍

用途:该技能用于调用 Pencil 的 MCP 工具 get_variables(部分客户端中可能显示为 mcp__pencil__get_variables),读取当前文档中定义的设计变量/令牌,包括颜色、字体、间距等,帮助保持设计一致性。

使用条件:必须先判断意图。只有在用户明确提到 Pencil,或当前对话上下文明显属于 Pencil 设计任务时才可使用;否则不要使用。例如普通的“获取变量”可能指环境变量或代码变量,不应触发。典型场景包括:需要了解 Pencil 中可用的设计令牌;希望用语义名称(如 primary-color)替代硬编码十六进制色值;检查当前主题。触发语包括“获取 Pencil 变量”“读取 Pencil 设计令牌”“检查 Pencil 颜色”“列出 Pencil 主题值”。

输入参数:filePath(字符串,可选),指向 .pen 文件路径。

使用方式:调用工具 get_variables()。读取返回结果,结果是变量定义列表或映射。随后在 batch_design 操作中使用变量 ID 或名称,例如 fill: { type: "var", id: "var_123" }。

示例:读取当前文档全部变量时传入 {};从指定文件(如共享库)读取时传入 {"filePath": "/Users/design/system/tokens.pen"};主题审计为概念性用法,同样传入 {}。

限制:仅在明确涉及 Pencil 时使用,否则可能误判。关于收费、价格、平台、效果等资料未提供。