用途:把某个主题以最小、最清晰的视觉形式呈现出来,跳过冗长前言,正文保持简短。适用于解释逻辑、运行时控制流、UI 结构、文件职责、组件交互、接口契约、类型或结构变更,以及需要展示真实界面变化的场景。
主要能力与视图类型:逻辑或算法用伪代码;运行时控制流或顺序用调用树;UI 结构用组件树(含关键状态与模块边界);文件职责或大范围重构用浅层文件树;组件交互、控制流或数据流用 Mermaid;新代码为主、省略上下文会掩盖归属或顺序、或读者需要可复制的目标形态时给出完整代码块;接口请求/响应用契约形式;关键类型或数据结构变形用类型 diff。diff 用于强调“变化了什么”,可对组件树、文件树、调用树或伪代码做 diff,而不是直接贴源码 diff。
参数:topic 必填,指定要可视化的内容;max-views 可选,限制返回视图数量,默认由调用方判断;size 可选,tight 让每个视图约 12 行以内并丢弃非关键细节,normal 保留主题所需内容,默认 normal。/pr 会以 size: tight 和较低的 max-views 调用,因为 PR 正文是快速浏览而非细读。
截图:当变化涉及 UI、布局或视觉状态时,真实截图优于文字视图。先让应用运行(若项目有启动技能则使用),用 Playwright 或浏览器扩展驱动到关键状态,截图保存到仓库外的文件并返回路径;若对比是重点,也截取变化前的状态。不要把截图提交进仓库,嵌入、上传和托管由请求方负责。若应用无法运行或驱动,应明确说明并提供最接近的文字视图,不要手写已有 UI 的模拟图。
使用建议:把每个视图放在它所支撑的短文本旁边,只保留回答当前问题所需的调用、文件、属性、状态和边界;每个视图必须增加信息而非重复正文。可选用一种或多种视图,很少全部使用,避免让读者过载。
限制:该技能只产出视图,不负责嵌入、上传或发布;截图不得提交进仓库;无法运行应用时不得伪造 UI。资料未提供具体安装命令、收费或平台信息。