Gérer les requêtes

L'interface Kiro CLI offre des capacités complètes de gestion des requêtes pour les requêtes locales et les requêtes du Model Context Protocol (MCP). Ce système vous permet de créer, modifier, organiser et utiliser des requêtes réutilisables dans votre flux de développement.

Le système de requêtes prend en charge trois types de requêtes :

• Requêtes locales : requêtes propres à un projet, stockées dans votre espace de travail
• Requêtes globales : requêtes à l'échelle de l'utilisateur, disponibles dans tous les projets
• Requêtes MCP : requêtes fournies par des serveurs MCP avec des fonctionnalités améliorées

Toute la gestion des requêtes s'effectue au moyen de la commande /prompts et de ses diverses sous-commandes.

/prompts list

Affiche toutes les requêtes disponibles selon une mise en page à trois colonnes montrant les noms, les descriptions et les sources. Indique le nombre de requêtes et précise lesquelles proviennent du stockage local, du stockage global ou des serveurs MCP.

/prompts create --name name [--content content]

Crée une nouvelle requête locale dans l'espace de travail actuel.

name (obligatoire) : Nom de la requête (50 caractères maximum)

--content content (optionnel) : Spécification directe du contenu

Comportement :

• Si --content est fourni, la requête est créée avec le contenu spécifié
• Si aucun contenu n'est fourni, votre éditeur par défaut s'ouvre pour la création du contenu
• Les requêtes sont enregistrées dans .kiro/prompts/ dans l'espace de travail actuel

/prompts edit name

Ouvre une requête existante dans votre éditeur par défaut pour la modifier.

Requêtes prises en charge :

• Requêtes de l'espace de travail local
• Requêtes globales de l'utilisateur
• Requêtes MCP (lorsque le serveur le prend en charge)

/prompts details name

Affiche des renseignements complets sur une requête, notamment :

• Les métadonnées et les détails des arguments
• Le contenu complet de la requête avant le traitement par l'IA
• Les exigences relatives aux paramètres et des exemples
• Les renseignements sur la source (local, global ou serveur MCP)

Une fois que vous avez créé des requêtes, invoquez-les dans le clavardage à l'aide du préfixe @ :

@prompt-name

En plus des requêtes, vous pouvez utiliser la syntaxe @ pour faire référence directement à des fichiers et à des répertoires dans vos messages. Kiro développera automatiquement ces références pour inclure le contenu ou la structure dans votre conversation.

Syntaxe de base :

# Include file contents
> Review @src/auth.rs for security issues

# Include directory tree
> What's the structure of @crates/agent/?

# Quoted paths for spaces
> Check @"my file.txt" for errors

# Relative paths
> Compare @./v1/api.rs with @./v2/api.rs

Fonctionnalités :

• Complétion par tabulation – Appuyez sur Tab après @ pour compléter automatiquement les chemins de fichiers et de répertoires
• Coloration syntaxique – Les références sont mises en évidence en violet pour une meilleure visibilité
• Mise en forme automatique – Les fichiers sont affichés sous forme de blocs de code, les répertoires sous forme de listes arborescentes
• Priorisation intelligente – Les requêtes connues ont priorité sur les chemins de fichiers

Limites de taille :

• Fichiers : 250 Ko maximum (les fichiers plus grands sont tronqués avec un avertissement)
• Répertoires : 3 niveaux de profondeur, 10 éléments par niveau maximum
• Les fichiers binaires ne sont pas pris en charge (un message d'erreur s'affiche)

Règles de priorité :

Lorsque vous utilisez @name, Kiro effectue une vérification dans cet ordre :

1. Requêtes connues – Si @name correspond à une requête (locale, globale ou MCP), elle est traitée comme une requête
2. Fichiers – Sinon, vérifié comme chemin de fichier
3. Répertoires – S'il ne s'agit pas d'un fichier, vérifié comme répertoire

Cela signifie que vos requêtes ont toujours priorité sur les fichiers portant le même nom.

Limitations :

• Aucun motif global (glob) (@*.rs ne fonctionnera pas)
• Aucune syntaxe de plage de lignes (@file.rs:10-20 ne fonctionnera pas)
• Aucune expansion du répertoire personnel (@~ ne fonctionnera pas)
• Les fichiers binaires ne sont pas pris en charge
• Les fichiers sans autorisation de lecture affichent des erreurs

@code-review
# Uses your local code-review prompt

@src/auth.rs
# Includes the contents of src/auth.rs file

@crates/agent/
# Shows the directory structure of crates/agent/

Les requêtes des serveurs MCP peuvent accepter des arguments pour personnaliser leur comportement. Les requêtes basées sur des fichiers (locales et globales) ne prennent pas en charge les arguments.

@server-name/prompt-name <required-arg> [optional-arg]

Utilisez /prompts details prompt-name pour découvrir les arguments qu'une requête MCP accepte.

# Example: Using MCP prompt with arguments
@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

• Emplacement : project/.kiro/prompts/
• Portée : disponible uniquement dans le projet actuel
• Priorité : la plus élevée (remplace les requêtes globales et MCP portant le même nom)

• Emplacement : ~/.kiro/prompts/
• Portée : disponible dans tous les projets
• Priorité : moyenne (remplace les requêtes MCP portant le même nom)

• Source : fournies par les serveurs MCP configurés
• Portée : dépend de la configuration du serveur
• Priorité : la plus faible (remplacée par les requêtes locales et globales)

Lorsque plusieurs requêtes portent le même nom, le système utilise cet ordre de priorité :

1. Requêtes locales (priorité la plus élevée)
2. Requêtes globales
3. Requêtes MCP (priorité la plus faible)

Cela vous permet de remplacer des requêtes MCP ou globales par des versions propres au projet, au besoin.

Le système affiche le contenu complet de la requête avant de l'envoyer au modèle d'IA, ce qui élimine toute confusion sur les renseignements réellement traités.

• Les erreurs des serveurs MCP sont converties en messages clairs pour l'utilisateur
• Des exemples d'utilisation utiles sont générés à partir des métadonnées des requêtes
• Des indications claires sont fournies pour les paramètres invalides ou les exigences manquantes

• Style de terminal cohérent pour toutes les opérations liées aux requêtes
• Affichage approprié du contenu pour tous les types de messages de requête
• Mise en page à trois colonnes pour une meilleure lisibilité dans les listes

Le système de requêtes s'intègre parfaitement aux serveurs MCP :

• Découverte automatique : les requêtes MCP sont découvertes automatiquement à partir des serveurs configurés
• Expérience utilisateur améliorée : expérience utilisateur améliorée pour la gestion des requêtes MCP
• Traduction des erreurs : les erreurs JSON brutes sont converties en messages exploitables
• Aperçu du contenu : aperçu complet du contenu des requêtes MCP avant l'exécution

Ces exemples illustrent la création de requêtes basées sur des fichiers et l'utilisation des requêtes MCP.

# Create a simple prompt without arguments
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"

# Use the prompt (no arguments supported for file-based prompts)
@code-review

# Using MCP prompts with arguments
@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"