SuperAPI AI 工具集

visual-mockups

设计与创作

查看项目

更新于 10-16 04:55

技能介绍

用途:当讨论内容本身是视觉性的(UI 布局、导航、组件摆放、架构图、数据流、设计打磨、空间关系等),用浏览器展示交互式原型;纯文字或表格内容(需求问题、取舍清单、概念性 A/B、技术决策)仍用聊天。注意:UI 话题不一定是视觉问题,“哪种向导?”是概念性的,“哪种向导布局更合适?”才是视觉性的。

主要能力:启动本地服务器后,向 screen_dir 写入 HTML 内容片段,服务器自动套用模板(页头、CSS 主题、选择指示器、交互 JS),可生成选项、卡片、原型容器、分屏、优缺点对比、线框图组件(mock-nav、mock-sidebar、mock-content、mock-button 等)。用户点击选项会记录到 $STATE_DIR/events,可读取交互路径作为结构化反馈,聊天消息为主要反馈。

使用方式:运行 scripts/start-server.sh --project-dir /path/to/project,返回含 URL、screen_dir、state_dir 的 JSON,让用户打开 URL。平台差异:macOS/Linux(Claude Code)默认后台;Windows(Git Bash)用 --foreground;远程/容器用 --host 0.0.0.0 --url-host localhost;Codex 自动前台;Gemini CLI 用 --foreground。URL 不可达时可绑定 0.0.0.0 并通过 --url-host 暴露。默认写内容片段,仅在需要完全控制时写完整 HTML 文档。每次屏幕用新文件名(如 layout.html、layout-v2.html),不得复用。回到聊天时推送等待屏清除旧内容。清理用 scripts/stop-server.sh $SESSION_DIR;使用 --project-dir 时原型文件持久保存在 .superpowers/visual-mockups/,仅 /tmp 会话在停止时删除。

设计建议:保真度与问题匹配,线框用于布局、精修用于外观问题;每屏最多 2-4 个选项;必要时用真实内容;每页写明问题。

限制:每次新屏幕会清空 events 文件;若无该文件说明用户未在浏览器交互;输出中未提供收费、平台支持范围等更多信息。