SuperAPI AI 工具集

pencil-mcp-search-all-unique-properties

设计与创作

查看项目

更新于 10-16 07:54

技能介绍

用途

本技能用于调用 Pencil MCP 工具 search_all_unique_properties(在部分客户端中可能显示为 mcp__pencil__search_all_unique_properties),在 Pencil 设计文件中执行全局属性搜索。它适合设计审计场景,例如查找所有使用红色背景的节点、列出文档中使用的全部字体或字号、定位样式使用不一致的地方。

主要能力

  • 在指定的父节点范围内搜索属性。
  • 列出某个属性的所有唯一取值。
  • 输出结果按属性值对节点进行分组,便于比对与审计。
  • 支持同时搜索多个属性,例如 fills、strokes、fontSize、fontFamily。

使用方式

调用工具时使用以下输入参数:

  • filePath(字符串,可选)。
  • parents(数组,必填):要搜索的父节点 ID 列表。
  • properties(数组,必填):要搜索的属性名列表,例如 ["fills", "typography"]。

基本步骤:

  1. 确定审计范围,即选择要审计的父节点(例如 Root Frame)。
  2. 调用工具,例如 search_all_unique_properties(parents=[...], properties=["fills"])。
  3. 分析输出,结果会按属性值对节点分组。

示例:

  1. 简单:查找所有颜色
{
  "properties": ["fills"]
}
  1. 中等:局部字体审计
{
  "parents": ["frame:card-123"],
  "properties": ["fontFamily"]
}
  1. 复杂:综合样式审计
{
  "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;搜索属性、设计审计、查找使用、唯一值、属性检查、样式一致性。