Build, Plan et révision

Vue d'ensemble

Comment Swiftask Code travaille sur votre projet : choisir un mode, planifier un travail important, contrôler les autorisations, et vérifier les changements.

Prérequis

• Swiftask Code installé et connecté

• Une compréhension de base du panneau de chat (voir Chat et contexte)

Guide étape par étape

1. Choisir le bon mode

Choisissez un mode dans la zone de saisie du chat selon ce que vous voulez qu'il se passe.

2. Comprendre les trois modes

Build (par défaut) — pour implémenter des fonctionnalités, corriger des bugs, refactoriser, lancer des tests. Swiftask Code peut rechercher dans votre projet, modifier des fichiers et exécuter des commandes.

Ask — pour apprendre le code, poser des questions d'architecture, réviser sans modifier. Swiftask Code lit et recherche uniquement.

Plan — pour un travail important où vous voulez un plan écrit avant tout changement de code. Swiftask Code étudie votre projet et rédige un plan structuré. Il ne modifiera pas les fichiers source tant que vous n'aurez pas choisi Build.

3. Planifier avant de développer (pour un travail non trivial)

1. Passez en mode Plan

2. Décrivez ce que vous voulez — périmètre, contraintes, tout ce qui est important

3. Swiftask Code produit un plan que vous pouvez lire dans le chat

4. Ouvrez-le depuis la Plans library (icône liste de contrôle) pour le lire ou le modifier

5. Quand vous êtes satisfait, cliquez sur Build pour démarrer l'implémentation en mode Build

Vous pouvez rester en mode Plan et demander des mises à jour du même plan avant de développer.

4. Contrôler ce qui s'exécute automatiquement

Dans Swiftask Settings → Permissions, choisissez jusqu'où Swiftask Code peut agir sans demander :

Les trusted commands sont des commandes shell que vous êtes à l'aise d'approuver automatiquement — par exemple yarn test, npm run typecheck, ou git status. Modifiez la liste dans Settings.

Les modifications de fichiers demandent toujours une confirmation en mode Ask before sensitive actions.

Exemples d'approbation

Quand Swiftask Code demande des précisions

Si votre demande est ambiguë, Swiftask Code peut se mettre en pause avec des questions de clarification dans la zone de saisie du chat — avant de modifier des fichiers ou d'exécuter des commandes.

Cela est distinct des autorisations Allow / Deny. Les autorisations contrôlent les actions à risque ; les questions de clarification permettent de résoudre ce que vous vouliez dire.

Ce que vous verrez

• Une ou quelques questions courtes (jusqu'à quatre)

• Des réponses suggérées à cliquer (généralement 2 à 4 options)

• Une option Other pour votre propre formulation

• Parfois une courte note « pourquoi c'est important » sous la question

• Continue une fois que vous avez répondu ; vous pouvez Skip une question si elle ne s'applique pas

• S'il y a plusieurs questions, utilisez le pager pour naviguer entre elles

Certaines questions permettent plusieurs options ; d'autres n'acceptent qu'un seul choix.

Ce qui se passe ensuite

Une fois vos réponses envoyées, Swiftask Code continue le même tour avec vos choix — vous n'avez pas besoin de reformuler toute la demande.

Les questions de clarification peuvent apparaître dans n'importe quel mode, y compris quand les autorisations sont réglées sur Run everything.

Astuce : Soyez précis dans votre premier message (périmètre, fichiers, contraintes) pour réduire les questions de suivi. Vous pouvez aussi @-mentionner les fichiers ou dossiers qui vous intéressent — voir Chat et contexte.

5. Vérifier les changements de fichiers

En mode Build, quand Swiftask Code modifie des fichiers, vous les vérifiez avant de continuer.

Dans le chat — une section Files changed liste ce qui a été modifié. Vous pouvez :

• Keep all — accepter tous les changements

• Undo all — annuler tout ce qui a été fait dans ce tour

• Ouvrir un diff par fichier

• Conserver ou annuler un fichier à la fois

Dans l'éditeur — sur un fichier modifié, la barre de titre peut afficher Keep agent edits et Undo agent edits.

6. Suivre la progression sur des tâches à plusieurs étapes

Sur des tâches à plusieurs étapes, Swiftask Code peut afficher une checklist dans le chat pour que vous voyiez ce qui est fait et ce qui reste — particulièrement utile pendant un travail Plan → Build.

Cas d'usage pratiques

Copiez et adaptez ces prompts — choisissez d'abord le mode, puis collez-les dans le chat.

Mode Build :

Vérifiez Files changed avant Keep all.

Mode Plan :

Lisez le plan dans la Plans library, ajustez si nécessaire, puis cliquez sur Build.

D'autres exemples en lecture seule (explorer le code, revue de code) se trouvent dans Chat et contexte.

Conseils et bonnes pratiques

Astuce : Décrivez le résultat (« ajouter des collections de sessions avec une interface de liste ») plutôt que chaque fichier à modifier — Swiftask Code les découvrira pendant la planification.

Demandez d'abord en cas de doute : Liste les principaux endroits qui dépendent de [module]. — puis passez en mode Plan ou Build.

Auto-format : facultatif — Settings → Permissions → Auto-format on finish exécute votre formateur sur les fichiers modifiés après chaque tour.

Exemples d'approbation :

Ressources supplémentaires

• Chat et contexte — sessions, @-mentions, exemples en mode Ask

• Personnaliser — règles et valeurs par défaut des autorisations

• Aide et FAQ — astuces, autorisations et problèmes de modification