用途
pencil-mcp-set-variables 是一个用于调用 Pencil MCP 工具 set_variables 的技能，主要作用是设置或更新设计变量，帮助建立或维护 Design Token（设计令牌）系统。
主要能力
该技能调用 Pencil MCP 工具 set_variables。如果客户端对 MCP 工具进行命名空间处理，该工具可能显示为 mcp__pencil__set_variables。
通过该技能可以：
- 在 Pencil 中初始化设计系统（例如初始化 uView Pro 颜色）。
- 更新主题（例如应用深色模式）。
- 定义新的设计令牌。
使用方式
触发条件
意图识别非常关键。即使触发短语匹配，也必须验证用户意图：
- 用户是否明确要求使用 Pencil？
- 当前对话上下文是否明确属于 Pencil 设计任务？
如果答案为否，则不要使用该技能。例如，“Set variables”可能指 .env 文件。
关键前提：只有当用户明确提及 Pencil 时，才应使用该技能。
触发短语包括：
- “Set Pencil variables”（设置 Pencil 变量）
- “Update Pencil tokens”（更新 Pencil 令牌）
- “Change Pencil theme”（修改 Pencil 主题）
- “Define Pencil colors”（定义 Pencil 颜色）
输入参数
- filePath（字符串，可选）：.pen 文件路径。
- variables（对象，必填）：符合 .pen schema 的变量定义。
- replace（布尔值，可选）：
- true：完全替换所有现有变量。
- false（默认）：合并/更新现有变量。
使用步骤
- 定义 Schema：构造变量对象（名称、类型、值、主题模式）。
- 调用工具：set_variables(variables={...})。
- 验证：可选调用 get_variables 确认更改。
示例
简单：添加颜色
注册单个新颜色变量。
{ "variables": [ { "name": "brand/primary", "value": "#0066FF", "type": "color" } ] }
中等：更新主题令牌
通过合并方式为特定主题（例如深色模式）更新多个变量。
{ "replace": false, "variables": [ { "name": "bg/default", "value": "#121212", "type": "color" }, { "name": "text/primary", "value": "#FFFFFF", "type": "color" } ] }
复杂：完整系统替换
用一组新的令牌完全替换现有变量系统。
{ "replace": true, "variables": [ { "name": "spacing/small", "value": 8, "type": "float" }, { "name": "spacing/medium", "value": 16, "type": "float" }, { "name": "font/base", "value": "Inter", "type": "string" } ] }
适用场景
- 在 Pencil 中初始化设计系统。
- 更新 Pencil 中的主题，例如应用深色模式。
- 定义新的设计令牌。
- 维护 Design Token 系统。
限制
- 仅在用户明确提及 Pencil 或上下文明确属于 Pencil 设计任务时使用。
- 若用户意图不明确（例如“Set variables”可能指 .env 文件），不应使用该技能。
- 关于收费、价格、平台支持范围等信息，资料暂未提供。
关键词
英文关键词：set variables, update tokens, define theme, design system init, color definition, style dictionary
中文关键词：设置变量, 更新令牌, 定义主题, 设计系统初始化, 颜色定义, 样式字典