Communitygithub.com

应用设计工作室

从应用名称或网站/网页应用创意生成完整的、高保真UI设计仓库——包含所有页面/屏幕、每种状态(加载、空状态、错误、离线)、弹窗、表单、组件、交互,并配有锁定设计系统和可测量的可用性门控。

应用设计工作室 是什么?

app-design-studio 是一个 AI 设计师技能,旨在从单个应用名称或创意生成生产级 UI 设计仓库。它通过锁定设计系统(颜色、排版、间距、尺寸)和可测量的可用性标准(对比度、触摸目标、文本大小),解决了图像模型常见的不一致性和可用性问题。该技能支持三种目标:移动应用(纵向屏幕)、网站(横向桌面和窄响应式布局)和网页应用/后台/仪表盘。其工作流程包括定义目标、生成屏幕清单、起草设计计划(含三个方向的圣经与调色板,并由人工选择)、生成令牌和组件表、按清单渲染屏幕、检查所有状态(空、错误、加载)、通过脚本自我批评和门控,最后导出包含 PNG、规格和报告的设计仓库。它特别强调美学与可用性的平衡:将可用性作为不可妥协的地板(触摸目标 >=48dp,正文 >=16sp,对比度 4.5:1),在此之上添加人格化元素。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/app-design-studio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

应用设计工作室 是做什么的?

目标:从一个应用名称出发,生成一个设计仓库,同时美观且可用,所有屏幕保持一致,可随时交给设计师、构建 Compose/Flutter/React Native 的智能体或 Compose-to-Figma 桥接工具使用。

为什么需要这个技能:图像模型能绘制漂亮的单个屏幕,但无法在不同屏幕间保持一致,会遗漏状态,悄悄破坏可用性(文字过小、对比度不足、触摸目标过小)。解决方案:先生成一个锁定的设计系统,然后依此生成屏幕,最后用脚本检查可测量的部分,用评分表外加人工判断检查不可测量的部分(审美)。

目标 = 描述(在 S0 中优先确定;当用户提到网站/门户/仪表盘时,不要静默使用默认值)

目标方向/尺寸阅读这些(仅这些以匹配目标措辞)
mobile(应用)纵向 9:19.5 屏幕,单一尺寸screen-taxonomy.md,design-bible-template.md 和 prompt-templates/README.md 中的移动端区块,dp/sp 单位的地板值
web 类型 site(网站、落地页、商店、博客)横向桌面 16:10(1440x900) 页面,外加该页面的窄 390px 响应式布局web-design.md,prompt-templates/web.md,design-bible-template.md 中的 Web 区块,px 单位的地板值
web 类型 app(门户、仪表盘、管理后台、SaaS)横向桌面优先;其次窄布局。仅当用户说手机是主要设备时,设置 "mobile_first": true 并将窄布局设为主要布局与 site 相同
both共享一套圣经和令牌,两套描述两套内容,绝不混合在同一提示中

在 inventory.json 中设置 "platform": "mobile" | "web"。每个提示只使用一套描述的措辞。

关键词卫生(此部分之所以存在的原因): 图像模型遵循你提供的词语。一个包含“纵向”、“手机”、“状态栏”、“9:19.5”、“底部导航”、“拇指区域”、“Android/iOS”或“应用屏幕”的网站提示会生成手机屏幕。Web 提示应使用“网站页面”、“横向桌面 16:10,宽 1440”、“带链接的页眉”、“侧边栏”、“无浏览器”。窄布局称为“窄响应式布局,宽 390px”,而非“手机屏幕”。python scripts/prompt_lint.py <design-dir> 会在 prompts/ 中的任何提示使用了另一套描述的词语时失败;在发送批量生成前运行它。

输出规则(始终遵循)

  • 图像即 UI 本身,铺满边缘:无设备边框、无手机/笔记本电脑模型、无浏览器 Chrome、无额外背景、无画布边框。(仅当用户要求展示板时使用演示边框。)移动端:纵向屏幕。Web:横向桌面页面以及(如果列出)窄布局;长页面作为一张高图像或 2-3 张相同宽度的局部图像。
  • 此技能中的示例仅为模式的说明,而非内容约束:不要复制其名称、文字、调色板、字体或布局到提示中(references/design-craft.md 中的偏差防护)。
  • 高保真:真实文字、真实图标、真实图像。无 lorem ipsum,无占位品牌名称。
  • 整个集合中使用一个设计系统。绝不为每个屏幕发明新样式。
  • 两种提示模式(references/design-craft.md):简要(简短意图 + 少数关键事实 + 感觉;用于首次渲染和 S2 方向,产生最独特的结果)和 锁定(确切字符串、计数、圣经区块;用于选择后的同级屏幕和修复)。先渲染简要,查看,然后锁定必须一致的部分。模型在不一致性上失败远多于在美观上,但过度约束首次渲染会使结果机械。
  • 编辑,而非重做:通过一个仅命名该更改的编辑通过修复一个错误字符串;完全重做会丢弃所有已批准的内容。
  • 无真实品牌、标志或真实人物面部;仅使用虚构名称和通用标记。切勿将 API 密钥写入仓库。
  • 用用户使用的语言回复(通常是罗马乌尔都语/印度英语);文件和提示保留英文。

工作流程(S0-S9)

在用户的项目文件夹下工作,路径为 design/<app-slug>/(布局:references/repo-layout.md)。在 design/<app-slug>/STATUS.md 中跟踪阶段状态。仅当答案会改变结果时才询问用户(S0 时最多 3 个问题);否则选择合理的默认值并说明。

S0 接收阶段。 应用/网站名称、一行目的、受众、目标 + 类型(上表;若出现“网站”、“门户”、“仪表盘”或“落地页”且目标不明确则询问)、平台感觉(移动端默认:Android + iOS 中性,偏向 Material 3;Web:中性)、语气词、浅色/深色(默认:浅色 + 深色令牌,屏幕为浅色)。编写 BRIEF.md(问题、受众、范围、非目标);如果用户不可用,则在顶部说明你的理解,而不是等待。阅读 references/aesthetic-vs-usability.md 一次。

S1 屏幕清单。 从 references/screen-taxonomy.md(Web:references/web-design.md 第 4 节)构建 inventory.json:固定核心(启动画面、语言、引导、权限、身份验证、主页、设置)+ 此应用特有的功能屏幕 + 详情 + 状态 + 弹窗 + 表单 + 组件。每个项目包含 id、组、目的、状态、优先级。向用户展示一个紧凑列表;确认后再花费图像积分。

S2 设计计划 + 圣经 + 3 个方向(人工门控)。 首先为每个方向编写 10 行设计计划(references/design-craft.md 第 2 节)并对照通用默认值进行自我审查。然后编写圣经(references/design-bible-template.md)作为三个简短替代方案(不同情绪、调色板逻辑、字体、形状语言)。每个圣经需注明每种填充颜色上的文字颜色(主色上的颜色、强调色上的颜色、徽章文本)以及平台的状体栏(Android:时间在左,图标在右;iOS:9:41 样式)。在渲染之前,将每个方向的调色板放入一个小型令牌文件,并运行 scripts/contrast_check.py:方向若仅因对比度不足而看起来不错,则不能进入人工选择。将每个提示写入 prompts/<id>.<direction>.md,然后发送该文件的确切文本(保存的提示是可复现的)。每个方向渲染一个主屏幕(Web:同一页面,桌面和移动端)。在同一个 Codex 调用中批量生成所有三个。停下来让用户选择 —— 审美是脚本无法判断的唯一事物,因此这是人类决定的地方。将选择记录在 DESIGN.md 中。

S3 令牌。 根据所选方向编写 tokens.json(颜色浅色/深色、字号比例、间距 4/8 网格、圆角、阴影、图标大小、触摸目标)。运行 scripts/contrast_check.py tokens.json 并立即修复失败的配对——比之后修复 40 个屏幕更省成本。

S4 组件板。 根据令牌生成组件清单(按钮、输入框、筹码、卡片、列表行、导航、顶栏、吐司提示、弹窗、表单)。此图像作为后续所有生成的视觉参考,从而保持屏幕一致性。

S5 屏幕。 使用 references/prompt-templates/ 按清单顺序生成屏幕。每个提示以锁定的圣经区块开始,然后确切的字符串和计数,最后是一个明确的“不要添加”列表。根据任务选择引擎:对于完整屏幕,使用支持文本的模型(gpt-image/Codex、Nano Banana、Stitch),或使用 HTML 渲染路径(确切的文本和计数,然后截图;已在 21 个屏幕的 PDF 阅读器集合上端到端测试:从 tokens.json CSS 变量和 Iconify 图标编写 html/<group>/<id>.html,然后 node scripts/render_screens.mjs <design-dir> 写入 PNG 以及根据真实 DOM 测量 的 <id>.spec.json,run_gates.py 审核它;需要 Node + playwright,如果本地未安装则设置 PLAYWRIGHT_MODULE/CHROME_PATH 环境变量)—— FLUX/Runware 会弄乱 UI 文本和计数,因此仅用于屏幕内部的装饰艺术。使用 Iconify MCP 获取图标,以使图标样式保持一致。在工具支持时,将组件板作为样式参考传递。保存为 screens/<group>/<id>.png 及 <id>.spec.json(元素包含尺寸、字号、颜色、交互标志——架构见 references/repo-layout.md)。

S6 状态、弹窗、表单。 相同提示,相同圣经。空状态引导下一步操作;错误在视觉上区别于空;加载使用与真实布局匹配的骨架屏。

S7 自我批评、判定和提示日志。 在向用户展示渲染之前,自行批评每个渲染(references/critique-template.md:可用性通过/失败并附证据 + 审美评分表,写入 reports/critique/<id>.md);低于 4.0 或任何可用性 FAIL 意味着通过编辑传递修复或拒绝并重新生成,无需等待用户。在查看每个生成的图像后,编写判定(接受 / 修复 / 拒绝)并记录:python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...;拒绝的图像移至 rejected/。prompt_log.py summary 显示每个提示模式的接受率和重复失败标签;任何标签被拒绝两次,则成为 references/design-craft.md 中“经验教训”的一行(这就是技能改进的方式)。然后运行 python scripts/run_gates.py design/<app-slug>。它运行对比度、令牌 lint、元素审核(触摸目标、最小文本大小)和状态覆盖率,并写入 reports/gates.md。然后使用 references/aesthetic-vs-usability.md 中的评分表为每个屏幕评分(打开 PNG 查看——不要凭记忆评分)。重新生成失败的屏幕,每个最多尝试 2 次;如果仍然失败,则标记给用户,而不是循环下去。

S8 导出。 组装仓库(references/repo-layout.md):PNG、规格、令牌、DESIGN.md、清单、流程图、copy/strings.json、报告。可选附加功能,仅当用户需要时: (a) HTML 真值层以获得精确的 CSS 值(references/image-qa-loop.md), (b) 商店资产——图标、功能图形、商店截图(标题渲染为 HTML 文本),由 scripts/validate_assets.py 对照 references/store-asset-specs.md 验证。对于营销商店截图(类似热门应用的标题主导集合),使用 store-screenshots 技能并以这些屏幕作为输入。可选交接:令牌/规格提供给 Compose 代码 + Figma 桥接;在 HANDOFF.md 中说明。

S9 人工审查。 展示联系表和门控报告。在真实应用存在之前生成的任何内容标记为 concept(切勿将概念商店图形呈现为真实捕获)。

判断指南(审美 vs 可用性)

地板值取决于目标:移动端 = 以下 dp/sp 数值;Web = references/web-design.md 第 3 节中的 px 地板值(44px 点击区域,正文 >= 16px,65ch 行宽,390px 宽度无水平滚动)。将可用性视为地板,审美视为天花板。地板数值不可协商,因为它们是可测量的:触摸目标 >= 48dp(iOS 44pt),正文 >= 16sp,且没有小于 12sp,对比度 4.5:1(大文本和图标为 3:1),每个屏幕一个主要操作,关键操作在下方拇指区域,4/8 间距网格。在地板之上,体现个性:独特的字体搭配、克制的强调色、每个操作流程中一个令人难忘的插画或图像时刻、充足的间距。当它们冲突时(例如浅灰色优雅标签),可用性获胜,你应在其他地方(粗细、间距、大小对比)恢复优雅,而非降低地板。

避免(“AI 痕迹”)

在编写第一个提示之前阅读 references/design-craft.md、references/interaction-and-density.md 和 references/ai-tells-avoid.md(简报指明密度目标:少量词语、充足空间、一个主要操作)。简短版本:紫蓝渐变、无理由的玻璃卡片、盒中盒嵌套、虚假图表垃圾、十二个小工具的主页、通用图标包混合、微小装饰标签、lorem ipsum 文本、通过小编辑克隆的屏幕。

参考映射

  • references/screen-taxonomy.md——哪些屏幕/状态/弹窗/表单存在及其时机(仅限 MOVILE 目标)。
  • references/web-design.md——网站/网页应用目标:视口、px 地板值、页面分类、布局、Web AI 痕迹。
  • references/prompt-templates/web.md——Web 格式/内容块和每页面类型的提示。
  • references/aesthetic-vs-usability.md——度盘、地板值、评分表、重新生成规则。
  • references/design-bible-template.md——在每个提示中重复的区块。
  • references/prompt-templates/——每屏幕类型的提示。
  • references/design-craft.md——简要与锁定提示、设计计划、通用默认值、一处的大胆性、文字规则、批评循环。
  • references/ai-tells-avoid.md——反模式。
  • references/repo-layout.md——文件夹布局和 JSON 架构。
  • references/image-qa-loop.md——每图像验证/编辑循环、可选的 HTML 真值层、strings.json。
  • references/store-asset-specs.md——Play/App Store 尺寸和规则(提交前请重新检查官方页面)。
  • references/interaction-and-density.md——文字/密度预算、逐步披露、可见交互状态、审查问题(在每个简报和批评中使用)。
  • references/critique-template.md——每图像自我批评和修复循环。
  • scripts/prompt_log.py——判定日志 + 经验教训摘要(见 S7)。
  • assets/——示例 tokens.json、inventory.json、spec.json、DESIGN.md 骨架。
  • scripts/——确定性门控(仅使用 Python 3 标准库):contrast_check、token_lint、spec_audit、state_coverage、validate_assets、run_gates。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

screenshot-to-compose

Turn app design screenshots (JPG/PNG, often AI-generated) or Figma frames into a native Kotlin Jetpack Compose UI that matches them, design-first. Measures pixels and colours (px to dp), writes screen/asset inventories and a design system with observed vs inferred values, builds Iconify icons into VectorDrawables, generates artwork instead of cropping the screenshots, implements MVI screens, then compares emulator or Roborazzi renders against the reference. Use whenever the user supplies screenshots, mockups or a design repository and wants them built as an Android Compose app, says "make this screen in Compose", "match the design", "px to dp", "screenshot to code", or wants a whole app UI built design-first, even if they never say "Compose".

store-screenshots

Create App Store and Google Play marketing screenshot sets that look like top-chart apps - a headline-led story of 5-8 frames with a poster-style first frame, zoomed real UI fragments, a dominant brand colour, panoramic links between frames, social proof and human touches - generated frame by frame with Codex (GPT Image) using the app's real screens as reference images, text-checked and edit-passed, then fitted to the exact store sizes. Use whenever the user wants store screenshots, "App Store screenshots", "Play Store images", listing graphics, a screenshot redesign or "before/after" for a store page, or wants their app's store page to convert better, even if they only say "screenshots" for an app. Takes real app screens (for example from app-design-studio) as input.

相关技能