figma-create-new-file

Acerca de figma-create-new-file

Envuelve la herramienta MCP create_new_file, que crea un nuevo archivo de Figma en blanco en la carpeta de borradores del usuario para un plan seleccionado. Se posiciona como un requisito previo obligatorio que debe cargarse antes de cada llamada a create_new_file, ya que codifica el árbol de decisiones de resolución de plan, el contrato del tipo de editor y la entrega posterior a use_figma. Se utiliza normalmente antes de use_figma cuando se necesita un archivo nuevo, por ejemplo, un nuevo diseño, un archivo de FigJam o de Slides.

La habilidad acepta argumentos opcionales en el orden editorType y luego fileName, donde editorType es design (el valor predeterminado), figjam o slides, y fileName tiene como valor predeterminado Untitled. El flujo de trabajo primero resuelve un planKey: si el usuario ya proporcionó uno, se utiliza directamente; de lo contrario, se llama a la herramienta whoami y se inspecciona su matriz plans, utilizando automáticamente la clave del único plan o preguntando al usuario qué equipo u organización utilizar cuando existen múltiples planes. Luego, llama a create_new_file con los parámetros planKey, fileName y editorType requeridos, y utiliza el file_key y file_url devueltos, pasando file_key a llamadas posteriores como use_figma.

El comportamiento del tipo de editor es parte del contrato. Los tipos de editor admitidos son design, figjam y slides, y cada archivo se crea en la carpeta de borradores del plan seleccionado. Se aplica una advertencia documentada a los archivos de slides: un archivo de slides recién creado comienza con cero filas y cero diapositivas, por lo que figma.getSlideGrid() devuelve una matriz vacía en lugar de una primera diapositiva predeterminada, y el único hijo de la página es el nodo SLIDE_GRID vacío. La primera llamada a figma.createSlide() crea implícitamente la fila cero e inserta la diapositiva allí, por lo que los scripts de use_figma posteriores que asumen al menos una diapositiva deben protegerse para el caso vacío o llamar a createSlide() primero. Cuando use_figma es el siguiente paso, se debe cargar la habilidad figma-use antes de llamarla.

Preguntas frecuentes

¿Qué argumentos acepta esta habilidad?

editorType y fileName opcionales. editorType es design (predeterminado), figjam o slides, y fileName tiene como valor predeterminado Untitled. Por ejemplo, /figma-create-new-file slides Q3 Review crea una presentación de Slides llamada Q3 Review.

¿Cómo se resuelve planKey?

Si el usuario ya proporcionó un planKey, se utiliza directamente. De lo contrario, se llama a la herramienta whoami: se utiliza automáticamente la clave de un único plan, mientras que múltiples planes solicitan al usuario que elija en qué equipo u organización crear el archivo.

¿Dónde se crea el nuevo archivo?

En la carpeta de borradores del usuario para el plan seleccionado. La herramienta devuelve un file_key y un file_url que abre el archivo directamente en Figma.

¿Qué hay de especial en los archivos de Slides recién creados?

Un archivo de slides comienza con cero filas y cero diapositivas, por lo que figma.getSlideGrid() devuelve una matriz vacía en lugar de una primera diapositiva predeterminada. La primera llamada a figma.createSlide() crea implícitamente la fila cero, por lo que se debe proteger para el caso vacío o llamar a createSlide() primero.

¿Qué debo hacer después de crear el archivo?

Utilice el file_key devuelto para llamadas posteriores a herramientas como use_figma. Si use_figma es el siguiente paso, cargue la habilidad figma-use antes de llamarla.