figma-create-new-file

Sobre figma-create-new-file

Envolve a ferramenta MCP create_new_file, que cria um novo arquivo Figma em branco na pasta de rascunhos do usuário para um plano selecionado. É posicionada como um pré-requisito obrigatório que deve ser carregado antes de toda chamada create_new_file, pois codifica a árvore de decisão de resolução de plano, o contrato do tipo de editor e a transferência pós-criação para usar_figma. É tipicamente usada antes de use_figma quando um arquivo novo é necessário, por exemplo, um novo design, FigJam ou arquivo de Slides.

A habilidade aceita argumentos opcionais na forma editorType seguido por fileName, onde editorType é design (o padrão), figjam ou slides, e fileName assume o valor padrão Untitled. O fluxo de trabalho primeiro resolve um planKey: se o usuário já forneceu um, ele é usado diretamente; caso contrário, a ferramenta whoami é chamada e sua matriz plans é inspecionada, usando automaticamente a chave do único plano ou perguntando ao usuário qual equipe ou organização usar quando existem múltiplos planos. Em seguida, chama create_new_file com os parâmetros planKey, fileName e editorType obrigatórios, e usa o file_key e file_url retornados, passando file_key para chamadas subsequentes como use_figma.

O comportamento do tipo de editor faz parte do contrato. Os tipos de editor suportados são design, figjam e slides, e todo arquivo é criado na pasta de rascunhos do plano selecionado. Uma advertência documentada aplica-se a arquivos de slides: um arquivo de slides recém-criado começa com zero linhas e zero slides, portanto figma.getSlideGrid() retorna uma matriz vazia em vez de um primeiro slide padrão, e o único filho da página é o nó SLIDE_GRID vazio. A primeira chamada a figma.createSlide() cria implicitamente a linha zero e insere o slide nela, portanto scripts subsequentes de use_figma que assumem pelo menos um slide devem proteger-se contra o caso vazio ou chamar createSlide() primeiro. Quando use_figma é a próxima etapa, a habilidade figma-use deve ser carregada antes de chamá-la.

Perguntas Frequentes

Quais argumentos esta habilidade aceita?

editorType e fileName opcionais. editorType é design (padrão), figjam ou slides, e fileName assume o valor padrão Untitled. Por exemplo, /figma-create-new-file slides Q3 Review cria uma apresentação de Slides chamada Q3 Review.

Como o planKey é resolvido?

Se o usuário já forneceu um planKey, ele é usado diretamente. Caso contrário, a ferramenta whoami é chamada: a chave de um único plano é usada automaticamente, enquanto múltiplos planos solicitam que o usuário escolha em qual equipe ou organização criar o arquivo.

Onde o novo arquivo é criado?

Na pasta de rascunhos do usuário para o plano selecionado. A ferramenta retorna um file_key e um file_url que abre o arquivo diretamente no Figma.

O que há de especial nos arquivos de Slides recém-criados?

Um arquivo de slides começa com zero linhas e zero slides, portanto figma.getSlideGrid() retorna uma matriz vazia em vez de um primeiro slide padrão. A primeira chamada a figma.createSlide() cria implicitamente a linha zero, portanto proteja-se contra o caso vazio ou chame createSlide() primeiro.

O que devo fazer após a criação do arquivo?

Use o file_key retornado para chamadas subsequentes de ferramentas como use_figma. Se use_figma for a próxima etapa, carregue a habilidade figma-use antes de chamá-la.