Cómo instalar Google Stitch Skills: Stitch MCP, Codex, Claude Code y configuración del flujo de trabajo de diseño

Google Stitch Skills proporciona habilidades de diseño, construcción y asistencia para Stitch MCP. Este artículo explica la instalación, las dependencias, la instalación selectiva y los límites de configuración comunes de Codex y Claude Code.

Google Stitch Skills es un conjunto de habilidades de agente y complementos para Stitch. Sigue el estándar abierto Agent Skills y se puede utilizar con agentes de codificación como Codex, Gemini CLI, Claude Code y Cursor. No es un “paquete de palabras rápido” separado: se requiere oficialmente que Stitch MCP esté configurado y ejecutándose antes de que estas habilidades puedan acceder al flujo de trabajo de diseño correspondiente. Almacén oficial

Si ya tiene Codex Skills Workflow, puede considerarlo como una colección más enfocada de complementos de diseño: stitch-design es responsable de las tareas de diseño, stitch-build está orientado a la construcción y los componentes, y stitch-utilities proporciona capacidades auxiliares.

Haga tres confirmaciones antes de la instalación.

  1. La configuración, las credenciales y el acceso a la red de Stitch MCP están disponibles;
  2. Dejar en claro si la habilidad se ejecuta a nivel de usuario, a nivel de proyecto o a nivel de espacio de trabajo, y evitar instalar un contexto de diseño específico del proyecto en el sistema global;
  3. Sepa qué diseños, códigos o capturas de pantalla se pueden entregar a un servicio externo y cuáles deben permanecer locales.

No se limite a instalar Skills y luego solucionar el problema de “por qué no hay herramientas”. Las habilidades son responsables de indicarle al Agente cómo trabajar, y es el servidor MCP el que realmente proporciona las capacidades de Stitch.

Primero verifique Stitch MCP en un proyecto en blanco

No solucione todavía la primera ronda de problemas en el proyecto principal. Cree un directorio temporal o utilice un proyecto de prueba sin datos de diseño confidenciales, complete la autenticación y conexión MCP de acuerdo con el documento Stitch y luego verifique desde el cliente si el servidor MCP se muestra como conectado. Luego haga que el Agente realice una tarea de solo lectura o de solo borrador, como enumerar los recursos de diseño disponibles o generar una variante de página que no se publica basada en un componente de muestra.

El objetivo de este paso no es hacer un diseño formal, sino resolver el problema en capas: cuando no se puede ver la herramienta MCP, verifique el comando del servidor, la autenticación y la red; cuando se pueda ver la herramienta pero la habilidad no surta efecto, verifique el alcance de la instalación del complemento; cuando se puede llamar pero el resultado es incorrecto, volver a las reglas, entradas y permisos del proyecto. No mezcle los tres tipos de problemas y resuélvalos “reinstalando”.

Después de confirmar que el entorno de prueba está disponible, decida la ubicación de instalación. Las habilidades comunes que los individuos utilizan con frecuencia pueden ubicarse al nivel del usuario; las habilidades que dependen de bibliotecas de componentes, tokens o especificaciones de diseño específicos se pueden ubicar a nivel de proyecto; solo los espacios de trabajo compartidos en equipo se pueden considerar a nivel de espacio de trabajo. Cuanto mayor sea el alcance, mayor será la necesidad de revisar si contiene enlaces internos, capturas de pantalla o contexto de diseño propietario.

Mercado de complementos de instalación de Codex

El método de instalación oficial de Codex CLI es el siguiente:

1
2
3
4
5
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

--sparse se utiliza para extraer solo las rutas requeridas y reducir el contenido del primer clon. Después de registrarse en el mercado, instale complementos de diseño, compilación o herramientas según sea necesario; No instale por defecto todos los complementos en cada proyecto.

El ejemplo oficial de Claude Code con Cursor es una instalación de alcance de proyecto o espacio de trabajo:

1
2
npx plugins add google-labs-code/stitch-skills --scope project --target claude-code
npx plugins add google-labs-code/stitch-skills --scope workspace --target cursor

Una vez completada la instalación, cierre y vuelva a abrir el cliente y confirme que la entrada correspondiente se pueda ver en la lista de complementos. Si el comando se ejecuta correctamente pero el cliente no está cargado, primero verifique si el directorio actual es el directorio raíz del proyecto, si --scope es el esperado y si la configuración del equipo anula la configuración personal; no omita el administrador de complementos copiando manualmente el directorio oculto. De esta manera, todavía hay entradas rastreables para actualizaciones, desinstalaciones y comprobaciones de dependencia posteriores.

No te pierdas las dependencias al instalar de forma selectiva

Cuando solo se necesitan algunas habilidades, utilice:

1
npx skills add google-labs-code/stitch-skills

Pero el consejo oficial es que puede haber dependencias entre Stitch Design Skills. Cuando aparece “Las habilidades se pueden ver pero no se pudieron ejecutar” después de una instalación selectiva, primero verifique si las dependencias a las que hace referencia están instaladas al mismo tiempo, en lugar de repetir la instalación o copiar manualmente el directorio.

Complete una tarea de diseño con un conjunto mínimo de complementos

Por ejemplo, cuando solo necesita convertir un Panel existente en una página de filtro, primero instale stitch-design y sus dependencias declaradas, y mantenga stitch-build solo cuando realmente desee generar código de componente. Deje que el Agente genere primero el borrador del diseño y las instrucciones de cambio, sin otorgar permiso para escribir en el repositorio o publicar proyectos compartidos. Compruebe que el borrador pueda reutilizar la navegación, los tokens de color, los campos de tabla y los nombres de componentes existentes; Una vez que estas restricciones sean correctas, déjelo pasar a la fase de construcción.

También se debe volver a ejecutar el mismo conjunto de tareas de prueba antes de actualizar el complemento o MCP. Registre la versión del cliente, la versión del complemento, la configuración de MCP y la entrada de prueba; Si la nueva versión cambia el nombre de la herramienta o genera resultados, puede retroceder rápidamente en lugar de solucionar temporalmente el problema del proyecto de diseño real.

Cómo escribir tareas de diseño antes de que puedan ser revisadas

No le diga simplemente al Agente “cree una página de inicio más moderna”. Una tarea más estable debería proporcionar entradas, efectos secundarios permitidos y criterios de aceptación:

1
2
3
4
基于现有 Dashboard 组件创建一个新的筛选页草案。
只生成设计变体,不修改仓库代码,不发布到共享项目。
保留现有颜色 token、导航和表格字段。
输出两个变体,并说明每个变体改变了哪些组件和交互状态。

Esto evita que las herramientas de diseño omitan “generar borrador” directamente y pasen a “modificar el código de producción” o “sobrescribir el diseño compartido”.

Lista de verificación práctica antes del parto

Al final de una tarea de diseño, el agente debe dar, en lugar de solo dar pistas en la conversación: qué habilidades y herramientas MCP se utilizaron, qué recursos de diseño se leyeron, qué páginas se generaron o modificaron y qué acciones aún no se han realizado. Vuelva a verificar manualmente si el proyecto compartido no se lanzó accidentalmente, si los componentes clave aún usan tokens existentes y si las capturas de pantalla contienen datos comerciales que no deben transmitirse externamente.

Si la tarea debe caer en el almacén de códigos, divida “finalización del borrador del diseño” y “finalización del cambio de código” en dos puntos de envío o dos puntos de aprobación. El primero permite la exploración, mientras que el segundo debe seguir los procesos de prueba, revisión de código y lanzamiento existentes. De esta manera, Stitch Skills puede ayudar a los agentes a comprender el flujo de trabajo de diseño sin desdibujar los límites de responsabilidad entre las herramientas de diseño y los cambios de producción.

Preguntas frecuentes

Fenómeno verificación de prioridad
Habilidad instalada pero sin herramienta Stitch ¿Stitch MCP está configurado, ejecutándose y certificado?
Después de la instalación, solo es visible en un proyecto determinado. Compruebe si --scope project o el alcance del espacio de trabajo son los esperados
Capacidades faltantes después de una instalación selectiva Verifique las dependencias de Skills relacionadas, no copie solo un solo directorio
Los resultados del diseño no están en la marca. Escribir token, biblioteca de componentes, operaciones deshabilitadas y aceptación de capturas de pantalla en las reglas del proyecto

Resumen

La secuencia correcta de Stitch Skills es: primero tener disponible el Stitch MCP, luego seleccionar complementos o habilidades de acuerdo con las necesidades del proyecto y, finalmente, restringir al Agente con aportes de diseño claros y criterios de aceptación. Una instalación exitosa es sólo el comienzo; El alcance, las dependencias y los límites de los datos de diseño determinan si se pueden utilizar de manera estable en los procesos del equipo.

记录并分享
Creado con Hugo
Tema Stack diseñado por Jimmy