La commande /goal lance une boucle d'agent axée sur un objectif où Kiro travaille de façon autonome vers un objectif que vous définissez. Contrairement à une requête ordinaire, l'agent enchaîne les cycles d'implémentation et d'autovérification, ne marquant la tâche comme terminée que lorsque les critères d'acceptation sont respectés. Par défaut, l'agent effectue jusqu'à 5 itérations — augmentez ce nombre avec --max :
# Default: 5 iterations /goal refactor the auth module to use JWT tokens and ensure all tests pass # Allow more iterations for complex tasks /goal --max 10 migrate the entire test suite from Jest to Vitest
Lorsque vous définissez un objectif, l'agent entre dans une boucle itérative :
- Planifie les étapes nécessaires pour atteindre l'objectif
- Implémente les changements
- Vérifie le résultat par rapport aux critères d'acceptation de l'objectif
- Si la vérification échoue, itère avec des corrections
- Marque l'objectif comme terminé une fois que tous les critères sont respectés
Ce cycle se poursuit jusqu'à ce que l'agent confirme que le travail est terminé ou que vous annuliez l'objectif.
L'agent dérive les critères d'acceptation de l'énoncé de votre objectif. Soyez explicite sur ce à quoi ressemble « terminé » — « tous les tests passent » ou « aucune erreur TypeScript » donne à l'agent une cible de vérification concrète. Des objectifs vagues comme « améliorer le code » peuvent amener l'agent à itérer plus longtemps que nécessaire.
# Set a goal with clear acceptance criteria /goal refactor the auth module to use JWT tokens and ensure all tests pass # Cancel an active goal /goal clear
Les objectifs fonctionnent mieux pour les tâches à plusieurs étapes où vous voulez une exécution autonome avec un contrôle de qualité intégré :
- Refactorisation avec contraintes — « migrer toutes les routes API d'Express vers Hono et s'assurer que la suite de tests passe »
- Correction de bogues avec vérification — « corriger la condition de concurrence dans le pool de workers et ajouter un test de régression »
- Génération de code avec critères — « ajouter la validation des entrées à tous les composants de formulaire et s'assurer que les tests d'accessibilité passent »
- Changements multi-fichiers — « renommer le modèle User en Account dans l'ensemble du code source sans casser les importations »
Pour les tâches simples, à une seule étape, où vous savez déjà ce que vous voulez, une requête ordinaire est plus rapide. Utilisez /goal lorsque vous voulez que l'agent assume l'étape de vérification.
Pendant qu'un objectif est en cours d'exécution, vous avez deux options :
- Le diriger — utilisez le queue steering (Ctrl+S) pour envoyer une correction en milieu de boucle sans annuler
- L'annuler — exécutez
/goal clearpour arrêter la boucle et revenir au mode interactif standard
/goal clear
Les changements de fichiers déjà effectués restent sur le disque. Utilisez votre système de contrôle de version pour les annuler si nécessaire.
L'agent respecte les mêmes limites de tours et contraintes de fenêtre de contexte que les requêtes ordinaires. S'il épuise son contexte ou rencontre un motif d'échec répété, il s'arrête et rapporte ce qu'il a tenté. Vous pouvez aussi utiliser le queue steering pour orienter l'agent en milieu de boucle sans annuler complètement l'objectif.
- Queue steering — rediriger l'agent en plein tour sans annuler
- Effort — contrôler la profondeur de raisonnement du modèle
- Rewind — créer une bifurcation d'une conversation à un tour antérieur
Goal