用途:该技能封装 Pencil MCP 工具 replace_all_matching_properties,用于在 Pencil 的 .pen 文件中跨节点批量替换匹配的样式属性,例如颜色、字体、字号。客户端可能以命名空间形式呈现为 mcp__pencil__replace_all_matching_properties。
主要能力:支持在指定父节点范围内搜索并替换属性;可同时传入多条替换规则,一次完成多属性批量迁移;可用于全局改色、批量更新字体、样式重构(如把十六进制色值替换为变量)、主题切换等。典型触发语包括“替换 Pencil 属性”“修改 Pencil 所有颜色”“批量更新 Pencil 字体”“Pencil 全局样式替换”。
使用方式:先定义规则,例如“查找 fills: #FF0000,替换为 fills: #0000FF”;再调用 replace_all_matching_properties(...);最后调用 get_screenshot 验证全局改动。参数包括 filePath(可选字符串)、parents(必填,父节点 ID 数组,限定搜索范围)、properties(必填,替换规则列表,每条规则含 property、from、to)。示例规则结构:property 为 fills 时 from/to 为 { "color": "#FF0000" } 形式;property 为 fontFamily 或 fontSize 时 from/to 为字符串或数值。
限制:必须仅在用户明确提到 Pencil 时使用;即使触发短语匹配,也需确认用户是否明确要求使用 Pencil,或当前对话是否明显属于 Pencil 设计任务,否则不应使用。例如“Replace properties”可能指代码重构,不属于本技能。资料未提供 .pen 文件格式细节、工具报错处理、性能上限与权限要求。