Stitch 设计技能(Stitch Design Skills)
一组面向 Google Stitch 的智能体技能(agent skills)与插件,遵循 Agent Skills 开放标准。兼容 Codex、Antigravity、Gemini CLI、Claude Code、Cursor 以及 OpenCode(需手动安装)等编程智能体。
快速入门
1. 安装插件(推荐)
这是全局安装完整 Stitch 插件套件的最快方式。
Codex
添加 Stitch Skills 市场,然后安装你需要的插件。
通过 CLI(推荐)
codex plugin marketplace add google-labs-code/stitch-skills --ref main \
--sparse .agents/plugins \
--sparse plugins/stitch-design \
--sparse plugins/stitch-build \
--sparse plugins/stitch-utilities
[!TIP]
--sparse标志为可选项——它们用于将检出范围限定到上述路径,从而加快克隆速度。如果省略,会拉取整个仓库。
通过 Codex 界面
进入 Settings → Plugin Marketplaces → Add 并填写:
| 字段 | 值 |
|---|---|
| Source(来源) | https://github.com/google-labs-code/stitch-skills |
| Git ref(Git 版本) | main |
| Sparse paths(稀疏路径) | (可选) .agents/plugins、plugins/stitch-design、plugins/stitch-build、plugins/stitch-utilities |
注册好市场之后,可以任意组合安装:
stitch-design—— 面向设计的技能stitch-build—— 构建与组件相关的技能stitch-utilities—— 工具与辅助类技能
Claude Code 与 Cursor
# Claude Code —— 安装到当前项目
npx plugins add google-labs-code/stitch-skills --scope project --target claude-code
# Cursor —— 安装到当前工作区
npx plugins add google-labs-code/stitch-skills --scope workspace --target cursor
OpenCode
OpenCode 不使用 npx plugins / npx skills,也不使用 Codex/Claude 的市场结构。需要手动安装技能与 Stitch MCP 服务器:
1. 技能(Skills) —— 将所需的技能目录复制到一个可被自动发现的路径:
# 项目本地安装(推荐)
mkdir -p .opencode/skills
cp -R plugins/stitch-design/skills/generate-design .opencode/skills/generate-design
# 对 plugins/*/skills/ 下的其他技能重复上述操作
OpenCode 同样会自动发现 .claude/skills/ 与 .agents/skills/(参见 OpenCode 技能文档)。
命名说明: OpenCode 要求技能的
name前置字段(frontmatter)必须使用小写 kebab-case(短横线连接的全小写格式),且与所在目录名一致。使用stitch::…这类名称(或非 kebab 形式名称)的技能,需要先重命名name字段与目录,OpenCode 才会加载。其余的前置字段(例如allowed-tools)将被忽略。
2. Stitch MCP —— 在完成 Stitch MCP 设置 后,在项目中的 opencode.json 或 ~/.config/opencode/opencode.json 中添加一个远程 MCP 条目:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"stitch": {
"type": "remote",
"url": "YOUR_STITCH_MCP_URL",
"enabled": true
}
}
}
请将 YOUR_STITCH_MCP_URL 替换为 Stitch MCP 设置流程中提供的端点(该指南中的凭据/环境变量同样适用)。
技能指令中出现的工具名称可能与 OpenCode 内置工具不同(例如使用 webfetch / bash 而非 web_fetch / run_command)。在为 OpenCode 适配技能时,请优先使用 OpenCode 的工具名称。
2. 选择性安装技能
仅选择并安装你需要的特定技能。
[!IMPORTANT]
Stitch Design Skills 之间常常存在相互依赖关系。如果选择按需安装,请务必包含所有必需的依赖技能。
npx skills add google-labs-code/stitch-skills
你可以运行以下命令查看插件与技能相关的帮助文档:
npx plugins --help
npx skills --help
前置条件
这些技能要求 Stitch MCP 服务器已在你的智能体环境中配置并运行。请务必按照 Stitch MCP 设置说明 完成服务器注册,并设置相应的环境变量与凭据。
文档导航提示: 如果 stitch.withgoogle.com/docs 上的某个链接跳转不正确,请直接在该域名下打开对应的目标路径(例如
https://stitch.withgoogle.com/docs/learn/device-types/)。
可用插件
Design(stitch-design)
在 Stitch 中用于创建、管理与优化设计的核心工作流。
| 技能 | 描述 | 提示词示例 |
|---|---|---|
| stitch::code-to-design | 通过提取 HTML 并结合设计系统与上传流程,将前端代码(React、Vue 等)转换为 Stitch Design | "将位于 /path/to/dashboard 的前端代码上传到名为 'Dashboard-Migration-2026' 的 Stitch 项目中。" |
| stitch::generate-design | 根据文本或图像生成新的界面、编辑既有界面,并创建设计变体 | · "为一款主打浪漫与约会创意的移动应用,制作一个浏览标签页。" |
· "编辑登录界面,新增一个 'Remember Me' 复选框,并将按钮颜色改为蓝色。"
· "为主页生成 3 个设计变体,需包含深色模式与高密度布局。" |
| stitch::manage-design-system | 在 Stitch 中管理设计系统——上传 DESIGN.md,并将主题应用到界面 | "从 .stitch/DESIGN.md 上传我们的设计系统,并将其应用到所有界面。" |
| stitch::extract-design-md | 直接从前端源码中提取一份完整的 DESIGN.md | "扫描 /src 目录,并将设计系统提取到 .stitch/DESIGN.md。" |
| stitch::extract-static-html | 从正在运行的 Web 应用中提取自包含的静态 HTML,内联 CSS 与图片 | "提取 http://localhost:3000/profile 的静态 HTML 快照。" |
| stitch::upload-to-stitch | 将本地资源(图片、摹本、HTML 文件)上传到 Stitch 项目 | "将 .stitch/landing_page.html 上传到 Stitch 项目 projects/987654321。" |
Build(stitch-build)
基于 Stitch 设计进行代码生成、框架集成以及资源编译。
| 技能 | 描述 | 提示词示例 |
|---|---|---|
| stitch::react-components | 将 Stitch 界面转换为 React 组件系统,并自动校验设计令牌的一致性 | · "将 Stitch 项目 projects/123 中的所有界面转换为 React 组件。" |
· "将应用同步到 Stitch 项目 13039335308618232534 的最新版本。" |
||
| stitch::react-native | 将 Stitch 的 HTML 设计转换为可直接用于生产环境的 React Native 组件,包含 StyleSheet 与平台特定代码 | · "将 Stitch 设计转换为带有合适主题与导航的 React Native 组件。" |
· "将应用同步到 Stitch 项目 13039335308618232534 的最新版本。" |
||
| remotion | 使用 Remotion 从 Stitch 项目生成带有平滑过渡与缩放效果的演示视频 | "为 Stitch 项目 projects/456 生成一段演示视频。" |
| shadcn-ui | 在应用中集成并使用 shadcn/ui 组件构建界面的专家级指南 | "初始化 shadcn/ui,并构建一个支持排序与筛选的数据表格。" |
| react-vite-dashboard | 将 Stitch 界面转换为 React + Vite 仪表盘,结合 TanStack Query、DESIGN.md 令牌以及 Web3 读取模式 | "依据我们的 DESIGN.md,将此 Stitch 界面构建为一个 DeFi 投资组合仪表盘。" |
Utilities(stitch-utilities)
用于优化提示词、生成设计规范并强制执行设计标准的辅助工具。
| 技能 | 描述 | 提示词示例 |
|---|---|---|
| design-md | 分析 Stitch 项目,并以语义化语言生成完整的 DESIGN.md 文件 | "分析 Stitch 项目 projects/123,并生成一份 DESIGN.md。" |
| enhance-prompt | 将模糊的 UI 想法转化为经过润色的、面向 Stitch 优化的提示词,并补充 UI/UX 关键词 | "优化这条提示词:'做一个设置页面'。" |
| stitch-loop | 通过单条提示词自动生成完整的多页面网站,并进行自动校验 | "使用 Stitch 构建一个 5 页的作品集网站。" |
| taste-design | 生成严格执行高品质、反通用化 UI 标准的 DESIGN.md 文件 | "生成一份对排版与配色有严格要求的高品质 DESIGN.md。" |