SuperAPI AI 工具集

visual-development-skill

编程与开发

查看项目

更新于 10-16 04:57

技能介绍

用途:在开发或修改任何视觉元素(组件、页面、布局、样式)时,对改动进行视觉验证;资料强调不要仅凭代码判断 UI 效果。

准备:后台启动开发服务器 bun run dev,等待服务器就绪(监听 localhost:3000 或下一个可用端口)。

页面与布局验证:用 Playwright 截图整页,例如 npx playwright screenshot --wait-for-timeout=3000 http://localhost:3000/your-page /tmp/screenshot.png,再用 Read 工具读取截图进行目视检查;每次有意义的视觉改动后都应截图。暗色模式可追加 ?dark=true 或通过应用切换后再截一张;响应式可用 --viewport-size=375,812(移动)与 --viewport-size=1280,720(桌面)。

单个组件验证:用 Compodium 在 http://localhost:3000/compodium/devtools 隔离预览组件,命令为 npx playwright screenshot --wait-for-timeout=3000 "http://localhost:3000/compodium/devtools" /tmp/compodium.png;Compodium 会自动发现 app/components/ 下的所有组件,无需编写 stories。

迭代流程:做视觉改动→截图目标页面或组件→读取截图验证→不符合预期则调整并重复,直到视觉输出符合意图再继续。

常用标志:--wait-for-timeout=3000 等待水合/渲染;--viewport-size=375,812 移动视口;--viewport-size=1280,720 桌面视口;--full-page 截取整个可滚动页面;--color-scheme dark 强制暗色配色。

限制:资料未提供收费、平台支持范围、性能数据及替代方案等信息。