用途
本技能用于调用 Pencil MCP 工具 search_all_unique_properties(在部分客户端中可能显示为 mcp__pencil__search_all_unique_properties),在 Pencil 设计文件中执行全局属性搜索。它适合设计审计场景,例如查找所有使用红色背景的节点、列出文档中使用的全部字体或字号、定位样式使用不一致的地方。
主要能力
- 在指定的父节点范围内搜索属性。
- 列出某个属性的所有唯一取值。
- 输出结果按属性值对节点进行分组,便于比对与审计。
- 支持同时搜索多个属性,例如 fills、strokes、fontSize、fontFamily。
使用方式
调用工具时使用以下输入参数:
filePath(字符串,可选)。parents(数组,必填):要搜索的父节点 ID 列表。properties(数组,必填):要搜索的属性名列表,例如["fills", "typography"]。
基本步骤:
- 确定审计范围,即选择要审计的父节点(例如 Root Frame)。
- 调用工具,例如
search_all_unique_properties(parents=[...], properties=["fills"])。 - 分析输出,结果会按属性值对节点分组。
示例:
- 简单:查找所有颜色
{
"properties": ["fills"]
}
- 中等:局部字体审计
{
"parents": ["frame:card-123"],
"properties": ["fontFamily"]
}
- 复杂:综合样式审计
{
"parents": ["section:header", "section:footer"],
"properties": ["fills", "strokes", "fontSize", "fontFamily"]
}
适用场景
- 在 Pencil 中执行设计审计。
- 查找不一致的使用情况,例如“我们在哪里用了错误的字体?”。
- 列出某个属性的全部唯一值,例如“列出所有使用过的字号”。
触发短语包括:
- “Search Pencil properties”(搜索 Pencil 属性)
- “Find usage of color X in Pencil”(查找 Pencil 中颜色 X 的使用)
- “Audit Pencil fonts”(审计 Pencil 字体)
- “List unique values in Pencil”(列出 Pencil 唯一值)
限制
使用前必须进行意图识别:即使用户语句匹配触发短语,也需确认用户是否明确要求使用 Pencil,或当前对话上下文是否明确属于 Pencil 设计任务。如果答案是否定的,则不应使用本技能。只有在用户明确提及 Pencil 时,才可使用本技能。
关键词:search properties、design audit、find usage、unique values、property check、style consistency;搜索属性、设计审计、查找使用、唯一值、属性检查、样式一致性。