应用设计工作室 是做什么的?
目标:从一个应用名称出发,生成一个设计仓库,同时美观且可用,所有屏幕保持一致,可随时交给设计师、构建 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。