SuperAPI AI 工具集

clearshot

编程与开发

查看项目

更新于 10-15 21:55

技能介绍

用途:clearshot 面向 UI 实现与评审场景,在“看图”和“就图作答”之间建立结构化中间表示,避免模型丢失空间关系、误读组件层级或臆造设计细节。

主要能力:分析分三级。Level 1(始终运行)把截图划为 5×5 网格,记录每个区域所属板块、相对视口大小与相邻关系,并逐元素记录类型、可见文本、位置、状态、尺寸、背景色与文字色(十六进制)、边框与圆角、阴影、图标,按板块分组;同时指出视觉落点、疏密、层级是否清晰。Level 2(始终运行)提取设计系统:颜色(页面背景、卡片/表面、主操作、次要、主/次文字、边框分隔、强调、危险、成功)、字体(标题、正文、说明的字号字重行高与字体族)、间距与形状(间距模式、圆角模式、整体密度)。Level 3(在需要实现、重建或克隆 UI 时升级)输出布局架构(页面布局模式、各板块内容布局、容器宽度、响应式断点、滚动线索、z-index 层级)与交互地图(主 CTA、次要操作、导航模式、表单分组、数据展示、可见状态)。

使用方式:先运行资料中给出的 bash 前置块以定位技能目录、读取配置并做版本检查与会话跟踪。若输出 CS_FIRST_RUN 为 yes,需先运行 ! {CS_SKILL_DIR}/bin/onboarding.sh 完成首次设置(更新偏好与遥测两项);若出现 CS_UPGRADE 的 UPGRADE_AVAILABLE,可运行 ! {CS_SKILL_DIR}/bin/update-prompt.sh {old} {new};若 CS_TEL_PROMPTED 为 no,可运行 ! {CS_SKILL_DIR}/bin/telemetry-setup.sh。分析前先做门槛判断:图像是否为数字界面、对话是否关于构建/调试/设计/评估 UI;两者皆否则退出技能,图像非 UI 但对话关于建 UI 时仅描述氛围质感,不结构化分析。输出按场景匹配:评审反馈先讲问题并落到具体色值、间距或元素;实现规格用分节结构;两张截图对比讲变化、改进、回退与待办。

适用场景:网站、应用、仪表盘、线框图、Figma 导出、带 UI 上下文的 CLI、可见页面的浏览器 DevTools 等界面截图,用于实现、调试、设计或评估 UI。

限制:照片、表情包、独立图表、演示幻灯片、文档、手写笔记不适用。分析要求具体到十六进制与像素估算,不确定时给出最佳估计并注明。内部自评 0-10 分仅用于遥测,不展示给用户;仅在用户纠正、重建完成后或单次会话 3 次以上分析且对话收尾时收集反馈,字段报告写入 ~/.clearshot/feedback/。遥测默认关闭,未生成配置前不发起网络请求。具体收费、价格与平台支持情况暂未提供。