用途:该技能通过 Pencil MCP 工具 snapshot_layout,捕获 Pencil .pen 文件中节点树的结构快照,用于理解节点层级与布局关系、检查元素边界和识别裁剪或重叠等布局问题。若客户端对 MCP 工具做命名空间处理,工具可能显示为 mcp__pencil__snapshot_layout。
主要能力:输出带布局信息(边界、约束)的树结构;可限制返回深度;可只针对某节点的子树;可只返回存在布局问题的节点。
使用前提:仅当用户明确提到 Pencil,或当前对话明确属于 Pencil 设计任务时才使用该技能;若用户只是说分析布局、检查结构而未提 Pencil,不应使用,因为可能指 HTML/CSS 布局分析。
输入参数:filePath(字符串,可选,指定 .pen 文件路径,默认当前活动文档);maxDepth(整数,可选,限制节点树下探深度,0 表示仅顶层节点,建议指定 2 或 3 避免上下文溢出);parentId(字符串,可选,仅返回该节点子树的布局);problemsOnly(布尔,可选,设为 true 时只返回有布局问题的节点,如被父节点裁剪,默认 false)。
用法步骤:先确定范围,是需要整页(maxDepth=1)还是特定区域(parentId=...);再调用 snapshot_layout;最后分析返回的树结构与布局信息。常见场景包括获取顶层框架布局、查看特定框架子元素定位、深入检查某区域的裁剪等布局问题。
适用触发语:Pencil 布局快照、分析 Pencil 页面结构、检查 Pencil 布局问题、获取 Pencil 节点层级等。关键词包括 snapshot layout、layout analysis、node hierarchy、structure check、bounds check、layout problems;中文为布局快照、布局分析、节点层级、结构检查、边界检查、布局问题。
限制:技能本身仅封装该 MCP 工具调用,具体返回内容取决于工具与文件;是否需要特定客户端、安装方式、收费与价格等信息资料未提供。