use_figma — Compétence API Plugin Figma pour FigJam

Cette compétence contient le contexte spécifique à FigJam pour l'outil MCP use_figma. La compétence figma-use fournit le contexte fondamental pour l'exécution de l'API plugin via MCP ainsi que l'API plugin Figma complète pour les cas d'usage plus avancés qui ne sont pas décrits ici.

Passez toujours skillNames: "figma-use-figjam" lors de l'appel de use_figma pour les opérations FigJam. C'est un paramètre de journalisation utilisé pour suivre l'utilisation des compétences — il n'affecte pas l'exécution.

Inspection des fichiers FigJam

get_figjam est l'outil d'inspection pour les fichiers FigJam. Il retourne l'arborescence complète des nœuds en XML, incluant les IDs des pages, sections, stickies, connecteurs et autres nœuds que vous devez référencer dans les appels use_figma suivants.

• Utilisez get_figjam en amont avant d'écrire tout code use_figma qui doit référencer des nœuds existants (IDs de pages, IDs de sections, etc.). N'essayez pas de découvrir les IDs en exécutant un script d'inspection — la sortie de console.log de use_figma n'est pas retournée à l'agent (voir figma-use Règle critique #4). Seule la valeur return est retournée.
• get_metadata NE fonctionne PAS sur les fichiers FigJam — c'est mode design uniquement et échouera immédiatement avec « unsupported for FigJam files ».
• get_screenshot nécessite un nodeId valide — passer un nodeId vide retourne une erreur « invalid nodeId ». Récupérez les IDs de get_figjam en premier.
• Si vous avez oublié de return un ID d'un appel use_figma précédent et en avez besoin maintenant, appelez get_figjam plutôt que de réexécuter un script d'inspection.

Chargement efficace des documents de référence

Chargez uniquement les références dont votre tâche a besoin — mais quand vous devez charger plusieurs documents, émettez toutes les lectures dans un seul appel batch d'outils parallèles, pas séquentiellement entre les tours. Pour une tâche typique de création de tableau, cela signifie un seul message contenant les lectures pour plan-board-content plus les 3-4 références de type de nœud spécifiques que vous utiliserez.

Outils différés — Chargement en batch des schémas

Les outils MCP Figma (use_figma, get_figjam, get_screenshot, get_metadata, create_new_file, whoami) apparaissent souvent comme des outils différés qui nécessitent ToolSearch pour charger leurs schémas avant de pouvoir être appelés. Chargez tous les schémas dans un seul appel ToolSearch en utilisant la syntaxe select: au lieu d'un appel par outil :

ToolSearch query="select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file"

Six appels ToolSearch séquentiels représentent six allers-retours avant que tout travail ne commence. Un seul appel batch représente un aller-retour.

Documents de référence

• plan-board-content - Lisez ceci pour toute demande de contenu de tableau — modèle de tableau, rétrospective, brainstorm, brise-glace, tableau de réunion, scaffold
  • Couvre la planification du contenu du tableau généré, incluant le plan séquentiel, les sections, les intentions et le texte hiérarchique
  • Délègue à d'autres références pour les détails d'API spécifiques
• create-section — Créer et configurer les sections FigJam (dimensionnement, dénomination, couleurs, visibilité du contenu, organisation des nœuds, mises en page en colonnes)
• create-sticky — Créer et configurer les sticky notes FigJam (couleurs, dimensionnement, texte, visibilité de l'auteur, création en batch)
• create-connector — Créer et configurer les connecteurs FigJam (points de terminaison, flèches, types de lignes, étiquettes, couleurs, câblage de diagrammes)
• create-text — Créer et configurer les nœuds de texte FigJam (chargement de polices, polices et couleurs prédéfinies, dimensionnement, listes, opérations de mind map)
• position-figjam-nodes — Positionner, dimensionner et reparenter les nœuds sur le canevas (incluant dans les sections)
• create-shape-with-text — Créer et configurer les formes FigJam avec texte intégré (types de formes, présets de couleurs, dimensionnement adapté au texte, mises en page de diagrammes)
• create-code-block — Créer et configurer les nœuds de bloc de code FigJam (langages, coloration syntaxique, positionnement, intégration dans les sections)
• create-table — Créer et configurer les tableaux FigJam (lignes, colonnes, texte de cellule, présets de couleurs, redimensionnement)
• edit-text — Éditer les nœuds de texte existants (chargement de polices, plages stylisées, rechercher/remplacer, couleur FigJam Charcoal par défaut)
• create-label — Créer et configurer les nœuds d'étiquette FigJam (petits marqueurs de légende numérotés/lettrés, séquences, positionnement)
• batch-modify — Modèles pour modifier de nombreux nœuds existants à la fois (modifications de style en masse, repositionnement, mises à jour de propriétés)