progressive-building

Par n8n-io · n8n

Charger avant build-workflow et avant de définir la portée ou planifier de nouveaux workflows et ajouts de fonctionnalités, y compris les demandes couvrant plusieurs workflows. Implémenter un incrément par message utilisateur. Terminer la configuration et inspecter une exécution réelle réussie avant de proposer un incrément supplémentaire. Puis attendre la réponse suivante de l'utilisateur. Une configuration partielle est incomplète. Un premier refus de configuration ou de test suspend la construction. Suivre les exceptions full-build du skill. Prend également en charge les modifications et réparations de workflows. Pour les workflows qui créent ou écrivent dans des Data Tables, charger data-table-manager en premier. Les demandes visant uniquement à exécuter, inspecter ou gérer des ressources existantes utilisent leurs outils et skills habituels.

npx skills add https://github.com/n8n-io/n8n --skill progressive-building

Construction progressive

Appliquez cette politique lors de la création ou l'extension de workflows et la réparation de ces builds. Elle remplace les instructions conflictuelles de scoping et de configuration dans les conseils de construction et de post-build ci-dessus. Conservez leurs règles de validation, approbation, credential, publication et cleanup. Écrivez à l'utilisateur dans sa langue de conversation.

Les demandes pour exécuter, inspecter ou gérer des ressources existantes utilisent leurs outils et skills normaux sans ce processus de staging. Cela s'applique aussi quand l'utilisateur bascule vers une telle demande après une construction dans la même conversation.

Choisir la première version

Reconnaître la demande complète avant de sélectionner le résultat le plus petit et utile. Construire une partie fonctionnelle du workflow demandé. Ne pas créer une démo jetable. Utiliser un seul trigger et au maximum deux services credentialisés dans la première version. Chaque incrément suivant ajoute au maximum un nouveau trigger et au maximum deux nouveaux services credentialisés. Cela s'applique aussi quand les nouveaux triggers partagent une logique existante ou n'ont pas besoin de credentials. Compter le credential du trigger. Compter les services même quand leurs credentials sont connectés.

Les paramètres et placeholders ne comptent pas. Un provider IA compte dans le même total de deux services que le trigger et les autres services, même si son credential est manquant. Exclure un modèle uniquement quand les crédits Gateway sont confirmés disponibles pour ce modèle sur cette instance. S'il nécessite une clé API provider, le compter.

Garder cette limite interne. Expliquer ce que la première version fait et ce qui vient ensuite. Préserver les services de l'utilisateur. Préférer les credentials existants quand on choisit entre des points de départ également adaptés. Suivre les conseils du workflow-builder sur les préférences de configuration des credentials quand l'utilisateur laisse le service ouvert.

Poser une question à choix unique si plusieurs services nommés sont également centraux. Sinon énoncer une hypothèse de départ raisonnable. Ne pas proposer de liste multi-select qui ajoute des services ou des triggers à la première version.

Le skill planning et l'outil create-tasks ne sont pas disponibles dans ce mode. Garder les workflows supplémentaires comme des éléments ultérieurs de la roadmap.

Construire, configurer et exécuter

  1. Construire la version sélectionnée. Utiliser le flux de vérification et de configuration existant.
  2. Avant sa carte de configuration, expliquer l'objectif complet, ce que cette version fait et les résultats restants. Faire cela aussi sur les tours <workflow-setup-required> automatiques. Puis ouvrir la configuration. Ne pas ajouter plus de travail tant que la configuration est incomplète.
  3. Créer les prérequis manquants, tels que les onglets de feuille ou les en-têtes, via le flux ponctuel existant quand les credentials connectés le permettent.
  4. Après la configuration, offrir seulement une exécution en direct pour les triggers manuels ou planifiés. La carte d'approbation d'exécution fournit le consentement. Pour les triggers d'événement, expliquer comment commencer à écouter un événement test et effectuer l'événement, puis demander à l'utilisateur de faire un retour. Inspecter l'exécution résultante avec executions.
  5. Étendre seulement après une exécution réussie et non simulée de la version actuelle. Une sauvegarde réussie, une vérification mockée, des données épinglées ou la déclaration de l'utilisateur seul ne satisfont pas cette condition. Confirmer que chaque chemin requis ajouté ou modifié dans cet incrément s'est exécuté avec succès. Les chemins inchangés n'ont pas besoin d'une autre exécution. Signaler la vérification simulée comme simulée, non comme un succès de bout en bout. Réparer les défaillances avant d'étendre.
  6. Après la vérification et la configuration d'un incrément, terminer le tour. Choisir l'action suivante à partir de l'état de la version actuelle :
    • La configuration est incomplète : expliquer ce qui manque et offrir de terminer la configuration. Un résultat avec partial: true ou nodesStillNeedingSetup non vide reste dans cet état. Respecter les credentials ignorés. Si la configuration a été reportée, pauser sans la rouvrir.
    • La configuration est complète mais une exécution réelle réussie manque : demander seulement le test en direct décrit ci-dessus. Ne pas offrir de construire l'incrément suivant à la place.
    • Une exécution réelle réussie est confirmée : lire la sortie du nœud pertinent, utiliser ses champs réels pour proposer le résultat suivant et attendre une nouvelle réponse de l'utilisateur acceptant de continuer. Éditer le même workflow et le fichier source en l'étendant. Une vérification réussie n'autorise pas un autre incrément dans le même tour. La liste originale des résultats demandés ne remplace pas cette pause.

Conserver une courte roadmap Done/Next dans les réponses substantielles sur ce build. Marquer un résultat comme fait seulement après que la preuve d'exécution le confirme. Ne pas prétendre que la demande complète est terminée tant que des résultats restent. Garder les résultats ultérieurs comme des éléments de roadmap, pas comme des alternatives sélectionnables à une configuration inachevée ou à un test en direct. Une réponse comme « continuer » ou « quoi ensuite ? » maintient l'étape de configuration ou de test en direct actuelle. Ce n'est pas une demande de build complet ni un autre refus.

Après le premier refus explicite de configuration ou test, énoncer ce qui reste non testé et pauser. Ne pas offrir un autre incrément ou demander à l'utilisateur de répéter le refus. Un refus d'approbation d'exécution est un refus, non une permission de continuer la construction.

Terminer sans staging quand demandé

Construire une spécification d'implémentation précise et complète en une seule passe. Cela inclut une liste de nœuds explicite, un workflow attaché ou une séquence complète d'étapes. Une liste de capacités souhaitées ou de points d'entrée seul ne se qualifie pas. Si l'utilisateur demande explicitement de tout construire maintenant, terminer la portée restante en une seule passe. Ne pas déduire cette instruction d'une liste d'ajouts demandés.

Si l'utilisateur refuse deux fois la configuration ou les tests, arrêter d'exiger l'exécution entre les incréments. Terminer la portée demandée et offrir la configuration à la fin. Respecter les credentials précédemment ignorés. Énoncer les parties qui restent non testées.

Skills similaires