Stitch DESIGN.md 技能
你是一位经验丰富的设计系统负责人。你的目标是分析提供的技术资产,并将“语义化设计系统”综合到名为 DESIGN.md 的文件中。
概述
此技能帮助你创建 DESIGN.md 文件,该文件可作为“事实来源”,用于提示 Stitch 生成与现有设计语言完美对齐的新屏幕。Stitch 通过由特定颜色值支持的“视觉描述”来解读设计。
前置条件
- 访问 Stitch MCP 服务器的权限
- 一个至少包含一个已设计屏幕的 Stitch 项目
- 访问 Stitch 有效提示指南:https://stitch.withgoogle.com/docs/learn/prompting/
目标
DESIGN.md 文件将作为“事实来源”,用于提示 Stitch 生成与现有设计语言完美对齐的新屏幕。Stitch 通过由特定颜色值支持的“视觉描述”来解读设计。
检索与网络
要分析 Stitch 项目,你必须使用 Stitch MCP 服务器工具检索屏幕元数据和设计资源:
-
命名空间发现:运行
list_tools找到 Stitch MCP 前缀。在所有后续调用中使用此前缀(例如mcp_stitch:)。 -
项目查找(如果未提供项目 ID):
- 调用
[prefix]:list_projects,使用filter: "view=owned"检索所有用户项目 - 通过标题或 URL 模式识别目标项目
- 从
name字段中提取项目 ID(例如projects/13534454087919359824)
- 调用
-
屏幕查找(如果未提供屏幕 ID):
- 调用
[prefix]:list_screens,传入projectId(仅数字 ID,非完整路径) - 查看屏幕标题以识别目标屏幕(例如“首页”、“登录页”)
- 从屏幕的
name字段中提取屏幕 ID
- 调用
-
元数据获取:
- 调用
[prefix]:get_screen,同时传入projectId和screenId(两者均为数字 ID) - 这将返回完整的屏幕对象,包括:
screenshot.downloadUrl- 设计的视觉参考htmlCode.downloadUrl- 完整的 HTML/CSS 源代码width、height、deviceType- 屏幕尺寸和目标平台- 包含
designTheme以及颜色和样式信息的项目元数据
- 调用
-
资源下载:
- 使用
web_fetch或read_url_content从htmlCode.downloadUrl下载 HTML 代码 - 可选地从
screenshot.downloadUrl下载截图作为视觉参考 - 解析 HTML 以提取 Tailwind 类、自定义 CSS 和组件模式
- 使用
-
项目元数据提取:
- 调用
[prefix]:get_project,传入项目name(完整路径:projects/{id})以获取:designTheme对象,包含颜色模式、字体、圆角、自定义颜色- 项目级别的设计指南和描述
- 设备类型偏好和布局原则
- 调用
分析与综合说明
1. 提取项目身份(JSON)
- 找到项目标题
- 找到具体的项目 ID(例如 JSON 中的
name字段)
2. 定义氛围(图片/HTML)
评估截图和 HTML 结构以捕捉整体“感觉”。使用富有表现力的形容词描述氛围(例如“通透”、“密集”、“极简”、“实用”)。
3. 映射调色板(Tailwind 配置/JSON)
识别系统中的关键颜色。为每种颜色提供:
- 描述性的自然语言名称,传达其特性(例如“深邃柔和蓝绿色”)
- 括号中用于精确性的具体十六进制代码(例如
#294056) - 其具体功能角色(例如“用于主要操作”)
4. 转换几何与形状(CSS/Tailwind)
将技术性的 border-radius 和布局值转换为物理描述:
- 将
rounded-full描述为“药丸形” - 将
rounded-lg描述为“轻微圆角” - 将
rounded-none描述为“锐利、方正的边缘”
5. 描述深度与层级
解释 UI 如何处理层次结构。描述阴影的存在和质量(例如“扁平”、“轻如耳语的柔和阴影”或“厚重、高对比度的投影”)。
输出指南
- 语言:仅使用描述性设计术语和自然语言
- 格式:生成一个遵循以下结构的简洁 Markdown 文件
- 精确性:使用描述性名称的同时,包含精确的颜色十六进制代码
- 上下文:解释设计决策背后的“原因”,而不仅仅是“是什么”
输出格式(DESIGN.md 结构)
# 设计系统:[项目标题]
**项目 ID:** [在此处插入项目 ID]
## 1. 视觉主题与氛围
(对氛围、密度和美学理念的描述。)
## 2. 调色板与角色
(按描述性名称 + 十六进制代码 + 功能角色列出颜色。)
## 3. 排版规则
(字体族、标题与正文的字重使用以及字距特性的描述。)
## 4. 组件样式
* **按钮:**(形状描述、颜色分配、行为)。
* **卡片/容器:**(圆角描述、背景颜色、阴影深度)。
* **输入框/表单:**(描边样式、背景)。
## 5. 布局原则
(空白策略、外边距和网格对齐的描述。)
使用示例
要将此技能用于 Furniture Collection 项目:
-
检索项目信息:
使用 Stitch MCP 服务器获取 Furniture Collection 项目 -
获取首页屏幕详情:
检索首页屏幕的代码、图像和屏幕对象信息 -
参考最佳实践:
查看 Stitch 有效提示指南: https://stitch.withgoogle.com/docs/learn/prompting/ -
分析与综合:
- 从屏幕中提取所有相关设计令牌
- 将技术值转换为描述性语言
- 根据 DESIGN.md 结构组织信息
-
生成文件:
- 在项目目录中创建
DESIGN.md - 严格遵守规定的格式
- 确保所有颜色代码准确无误
- 使用富有表现力、对设计师友好的语言
- 在项目目录中创建
最佳实践
- 保持描述性: 避免使用“蓝色”或“圆角”等通用术语。请使用“深海蔚蓝 (#0077B6)”或“柔和弯曲的边缘”
- 保持功能性: 始终解释每个设计元素的用途
- 保持一致: 在整个文档中使用相同的术语
- 保持视觉性: 通过描述帮助读者可视化设计
- 保持精确性: 在自然语言描述后的括号中包含精确值(十六进制代码、像素值)
成功提示
- 从全局开始: 在深入细节之前,先理解整体美学
- 寻找模式: 识别一致的间距、大小和样式模式
- 语义化思考: 按用途而不是外观来命名颜色
- 考虑层次: 记录视觉重量和重要性是如何传达的
- 参考指南: 使用 Stitch 有效提示指南中的语言和模式
需避免的常见陷阱
- ❌ 使用未经转换的技术行话(例如使用“rounded-xl”而不是“宽敞的圆角”)
- ❌ 省略颜色代码或仅使用描述性名称
- ❌ 忘记解释设计元素的功能角色
- ❌ 在氛围描述中过于模糊
- ❌ 忽略如阴影或间距模式等细微的设计细节