Google Stitch Workflow — Google Stitch 工作流程

Google Stitch 工作流 使用 Google Stitch 作为受控设计探索和屏幕迭代表面，而不是盲代码生成器。正常循环是： 检查项目和可用屏幕。 生成或编辑一个屏幕。 查看实际视觉工件。 以小步骤迭代，注重保留现有内容。 仅在一个方向被明确接受后才转到代码。 有关完整细节、边缘情况和扩展的配方，请阅读 references/complete-operator-manual.md 作为索引，并仅加载任务所需的专注参考。

何时使用 在以下任务中使用此技能： 检查 Stitch 项目和屏幕，然后进行更改 从结构化文本提示生成新屏幕 使用小的受控编辑来完善生成的屏幕 组织多屏幕重设计，而不丢失修订历史 将模糊的设计请求转换为更强的 Stitch 提示 决定何时保持在 Stitch 中，何时转到生产代码

不要使用 Stitch 作为主要路径，当实际任务是： 确定性代码端 UI 修复，在现有应用中 不需要设计探索的像素完美实现修复 在一个巨大的提示中进行整个产品规划，假设浏览器仅有的 Stitch 功能存在于 MCP 启动握手中

运行能力优先检查，在第一次生成或编辑之前。 关键：不要使用通用 MCP 模式发现作为 Stitch 的可靠性测试。 一些 Stitch MCP 环境即使直接工具调用有效，也会返回模式发现错误。 使用您的代理运行时的直接 MCP 调用机制： # Mavis / MiniMax 代理示例 mavis mcp call stitch list_projects '{}' # mcporter 风格示例 mcporter call stitch.list_projects '{}' 对于其他代理，直接调用等效的 stitch.list_projects 工具。 如果 list_projects 成功，Stitch 即可运行。 然后使用相同的运行时适配器探测可选的跟踪工具： generation_status，带有 {"operation": "last"} list_generations，带有 {"projectId": ""} 如果可选的跟踪调用失败，返回 "工具未找到"，记录此环境仅使用 list_screens 轮询。 仅在 Stitch 未配置或用户明确要求设置帮助时，才进入设置模式。 一些包装器自动检测项目 ID；仍然需要在编辑或生成之前确认活动项目。

预期基线工具： list_projects get_project list_screens get_screen create_project generate_screen_from_text edit_screens

可选工具： list_design_systems create_design_system update_design_system apply_design_system generate_variants generation_status list_generations fetch_screen_image fetch_screen_code get_screen_image get_screen_code build_site

如果基线工具缺失，停止并修复环境状态。 如果可选工具缺失，继续使用基线工作流。

运行适配器 此技能是代理中立的。它需要访问配置的 Stitch MCP 服务器，而不是特定的代理运行时。 使用可用的任何适配器： Mavis / MiniMax 代理：mavis mcp call stitch '' mcporter：mcporter call stitch. '' Codex、Claude、OpenClaw、Cursor 或其他代理：使用该运行时的 MCP 工具调用接口，用于相同的 Stitch 工具名称

不要使 mavis、mcporter、stitch-mcp-auto 或包装器图像/代码帮助器成为硬性要求，除非本地环境或用户明确选择该路径。

操作规则 在任何 generate、edit 或 variants 调用之前，将用户请求重写为更强的设计提示。 在编辑之前检查：列出项目/屏幕并读取目标屏幕。 一次处理一个屏幕。 保持提示简短、明确和保留现有内容。 在询问颜色、类型、运动或视觉抛光之前，选择屏幕结构。 仅使用提供的证明：不要发明指标、推荐语、客户标志、价格或社会证明来使生成的屏幕感觉完整。 定义必须保持不变的内容，而不仅仅是应该改变的内容。 在下一个主要步骤之前查看屏幕截图或视觉工件。 要求用户使用人类描述进行选择，而不是不透明的屏幕 ID。 期望 edit_screens 创建一个修订的屏幕，而不是修改原始屏幕。 不要在轮询窗口期间重试相同的失败有效负载。 仅在一个规范屏幕方向被接受后才转到代码。 将生成的代码视为种子，而不是完成的生产实现。 当提示模糊、太长或产生通用结果时，请阅读 references/prompt-structuring.md。

参数纪律 Stitch有效负载是参数敏感的。 deviceType：使用大写 "MOBILE" 或 "DESKTOP" 进行生成。 对于 edit_screens，除非活动模式证明否则，否则完全省略 deviceType。 selectedScreenIds：使用裸屏幕 ID 作为数组，而不是完整的资源名称。 modelId：仅使用活动 MCP 模式暴露的标识符。 提示长度：保持提示简短，通常在 500 个字符以下。 示例编辑有效负载： { "projectId": "8675077932533356979", "selectedScreenIds": [123, 456], ... }