Outils du gestionnaire GitHub

Le gestionnaire GitHub fournit un ensemble complet d'outils activés par la voix pour gérer les dépôts GitHub, les issues, les pull requests, et plus encore. Chaque outil est conçu pour être déclenché par des commandes en langage naturel et des mots-clés spécifiques.

Gestion des dépôts

Obtenir les dépôts de l'utilisateur

Outil : get_user_repositories

Description : Récupérer une liste de dépôts pour l'utilisateur authentifié.

Phrases déclencheuses :

"Montrer mes dépôts"
"Lister mes dépôts GitHub"
"Quels dépôts ai-je ?"
"Montrer mes dépôts privés/publics"
"Obtenir mes derniers dépôts"

Paramètres :

visibility : Filtrer par visibilité du dépôt (all, public, private)
affiliation : Filtrer par affiliation utilisateur (owner, collaborator, organization_member)
sort : Trier les dépôts par (created, updated, pushed, full_name)
per_page : Nombre de résultats par page

Obtenir les détails du dépôt

Outil : get_repository_details

Description : Obtenir des informations complètes sur un dépôt spécifique.

Phrases déclencheuses :

"Montrer les détails de [nom du dépôt]"
"Parle-moi du dépôt [propriétaire]/[dépôt]"
"Quel est l'état de [dépôt] ?"
"Obtenir des informations sur [dépôt]"
"Décrire le dépôt [dépôt]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)

Obtenir le contenu du dépôt

Outil : get_repository_contents

Description : Parcourir le contenu d'un répertoire ou d'un fichier dans un dépôt.

Phrases déclencheuses :

"Montre-moi les fichiers dans [dépôt]"
"Lister le contenu de [chemin] dans [dépôt]"
"Qu'y a-t-il dans le répertoire [dossier] ?"
"Parcourir la structure du dépôt [dépôt]"
"Montre-moi le répertoire racine de [dépôt]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
path : Chemin vers le répertoire ou le fichier (optionnel, par défaut racine)
ref : Branche ou commit ref (optionnel, par défaut branche par défaut)

Obtenir le contenu d'un fichier

Outil : get_file_content

Description : Récupérer le contenu brut d'un fichier spécifique dans un dépôt.

Phrases déclencheuses :

"Montre-moi le contenu de [fichier]"
"Lire [fichier] de [dépôt]"
"Obtenir le code de [fichier]"
"Afficher le contenu de [fichier]"
"Ouvrir [fichier] dans [dépôt]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
path : Chemin vers le fichier (requis)
ref : Branche ou commit ref (optionnel)

Obtenir l'arborescence du dépôt

Outil : get_repository_tree

Description : Obtenir la structure complète de l'arborescence Git d'un dépôt.

Phrases déclencheuses :

"Montre-moi la structure complète de [dépôt]"
"Obtenir l'arborescence complète des fichiers"
"Afficher la hiérarchie du dépôt"
"Montrer tous les fichiers et dossiers dans [dépôt]"
"Cartographier la structure du projet"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
tree_sha : SHA de l'arbre ou nom de branche (optionnel, par défaut branche par défaut)
recursive : Obtenir l'arbre de manière récursive (optionnel, par défaut true)

Rechercher du code dans le dépôt

Outil : search_repository_code

Description : Rechercher des modèles de code, des fonctions ou du texte dans un dépôt.

Phrases déclencheuses :

"Rechercher [terme] dans [dépôt]"
"Trouver [nom de fonction] dans le code"
"Chercher [modèle] dans [dépôt]"
"Rechercher [mot-clé] dans [dépôt]"
"Trouver toutes les occurrences de [texte]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
query : Requête de recherche (requis)
path : Limiter la recherche à un chemin spécifique
language : Filtrer par langage de programmation
per_page : Résultats par page

Analyser la structure du code

Outil : analyze_code_structure

Description : Fournir des informations sur l'organisation du projet, l'architecture et les modèles.

Phrases déclencheuses :

"Analyser la structure de [dépôt]"
"Quelle est l'architecture de ce projet ?"
"Donne-moi des informations sur [dépôt]"
"Analyser la base de code de [dépôt]"
"Décrire l'organisation du projet"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
include_dependencies : Inclure l'analyse des dépendances (optionnel)

Obtenir les branches du dépôt

Outil : get_repository_branches

Description : Lister toutes les branches dans un dépôt.

Phrases déclencheuses :

"Montrer les branches dans [dépôt]"
"Lister toutes les branches"
"Quelles branches existent dans [dépôt] ?"
"Obtenir la liste des branches pour [dépôt]"
"Montre-moi les branches disponibles"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)

Obtenir les étiquettes du dépôt

Outil : get_repository_labels

Description : Obtenir toutes les étiquettes disponibles dans un dépôt.

Phrases déclencheuses :

"Montrer les étiquettes pour [dépôt]"
"Lister les étiquettes d'issues"
"Quelles étiquettes sont disponibles ?"
"Obtenir toutes les étiquettes dans [dépôt]"
"Montre-moi les options d'étiquettes"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)

Gestion des issues

Obtenir les issues du dépôt

Outil : get_repository_issues

Description : Récupérer les issues pour un dépôt spécifique avec des options de filtrage.

Phrases déclencheuses :

"Montrer les issues dans [dépôt]"
"Lister toutes les issues ouvertes"
"Obtenir les issues avec l'étiquette [étiquette]"
"Montrer les issues fermées"
"Quelles issues nécessitent de l'attention ?"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
state : Filtrer par état (open, closed, all)
labels : Filtrer par étiquettes (séparées par des virgules)
sort : Trier par (created, updated, comments)
direction : Direction de tri (asc, desc)
per_page : Résultats par page

Obtenir les détails d'une issue

Outil : get_issue_details

Description : Obtenir des informations complètes sur une issue spécifique.

Phrases déclencheuses :

"Montre-moi l'issue #[numéro]"
"Obtenir les détails de l'issue [numéro]"
"Quel est l'état de l'issue #[numéro] ?"
"Parle-moi de l'issue [numéro]"
"Ouvrir l'issue numéro [numéro]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
issue_number : Numéro de l'issue (requis)

Créer une issue

Outil : create_issue

Description : Créer une nouvelle issue dans un dépôt. Mentionne automatiquement @claude dans la description.

Phrases déclencheuses :

"Créer une nouvelle issue"
"Ouvrir une issue sur [sujet]"
"Signaler un bug"
"Créer une issue pour [problème]"
"Créer une issue intitulée [titre]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
title : Titre de l'issue (requis)
body : Description de l'issue
labels : Étiquettes à appliquer
assignees : Utilisateurs à assigner

Mettre à jour une issue

Outil : update_issue

Description : Modifier une issue existante. Mentionne automatiquement @claude dans les mises à jour.

Phrases déclencheuses :

"Mettre à jour l'issue #[numéro]"
"Changer le titre de l'issue [numéro]"
"Fermer l'issue #[numéro]"
"Rouvrir l'issue [numéro]"
"Ajouter des étiquettes à l'issue [numéro]"
"Assigner l'issue [numéro] à [utilisateur]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
issue_number : Numéro de l'issue (requis)
title : Nouveau titre
body : Nouvelle description
state : Changer l'état (open, closed)
labels : Mettre à jour les étiquettes
assignees : Mettre à jour les assignés

Ajouter un commentaire à une issue

Outil : add_issue_comment

Description : Ajouter un commentaire à une issue ou une pull request. Mentionne automatiquement @claude.

Phrases déclencheuses :

"Commenter l'issue #[numéro]"
"Ajouter un commentaire à l'issue [numéro]"
"Répondre à l'issue [numéro]"
"Poster un commentaire sur la PR #[numéro]"
"Répondre à l'issue [numéro]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
issue_number : Numéro de l'issue ou de la PR (requis)
body : Texte du commentaire (requis)

Obtenir les commentaires d'une issue

Outil : get_issue_comments

Description : Récupérer tous les commentaires d'une issue ou d'une pull request.

Phrases déclencheuses :

"Montrer les commentaires sur l'issue #[numéro]"
"Obtenir les commentaires de l'issue [numéro]"
"Lire les commentaires de la PR #[numéro]"
"Lister tous les commentaires sur l'issue [numéro]"
"Que disent les gens sur l'issue [numéro] ?"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
issue_number : Numéro de l'issue ou de la PR (requis)

Obtenir un commentaire d'issue

Outil : get_issue_comment

Description : Obtenir les détails d'un commentaire spécifique par son ID.

Phrases déclencheuses :

"Montrer le commentaire [id]"
"Obtenir le commentaire avec l'ID [id]"
"Lire le commentaire spécifique [id]"
"Afficher le commentaire numéro [id]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
comment_id : ID du commentaire (requis)

Gestion des pull requests

Obtenir les pull requests

Outil : get_pull_requests

Description : Lister les pull requests pour un dépôt avec des options de filtrage.

Phrases déclencheuses :

"Montrer les pull requests"
"Lister les PRs ouvertes"
"Obtenir les PRs pour [dépôt]"
"Montrer les pull requests fusionnées"
"Quelles PRs nécessitent une revue ?"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
state : Filtrer par état (open, closed, all)
head : Filtrer par branche head
base : Filtrer par branche base
sort : Trier par (created, updated, popularity)
direction : Direction de tri (asc, desc)
per_page : Résultats par page

Obtenir les détails d'une pull request

Outil : get_pull_request_details

Description : Obtenir des informations complètes sur une pull request spécifique.

Phrases déclencheuses :

"Montrer la PR #[numéro]"
"Obtenir les détails de la pull request [numéro]"
"Quel est l'état de la PR [numéro] ?"
"Parle-moi de la pull request [numéro]"
"Revoir la PR numéro [numéro]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
pr_number : Numéro de la pull request (requis)

Créer une pull request

Outil : create_pull_request

Description : Créer une nouvelle pull request. Mentionne automatiquement @claude dans la description.

Phrases déclencheuses :

"Créer une pull request"
"Ouvrir une PR de [branche] vers [base]"
"Soumettre une PR pour revue"
"Créer une pull request intitulée [titre]"
"Fusionner [head] dans [base]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
title : Titre de la PR (requis)
head : Branche head (requis)
base : Branche base (requis)
body : Description de la PR
draft : Créer comme brouillon de PR

Mettre à jour une pull request

Outil : update_pull_request

Description : Modifier une pull request existante. Mentionne automatiquement @claude.

Phrases déclencheuses :

"Mettre à jour la PR #[numéro]"
"Changer le titre de la pull request [numéro]"
"Fermer la PR [numéro]"
"Modifier la pull request [numéro]"
"Modifier la description de la PR"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
pr_number : Numéro de la pull request (requis)
title : Nouveau titre
body : Nouvelle description
state : Changer l'état (open, closed)

Surveillance des PR

Démarrer la surveillance des PR

Outil : start_pr_monitoring

Description : Commencer à surveiller un dépôt pour les nouvelles pull requests avec notifications vocales.

Phrases déclencheuses :

"Commencer à surveiller [dépôt] pour les PRs"
"Surveiller [dépôt] pour les nouvelles pull requests"
"M'alerter des nouvelles PRs dans [dépôt]"
"Surveiller les pull requests"
"Suivre les nouvelles PRs dans [dépôt]"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)
checkIntervalMs : Intervalle de vérification en millisecondes (optionnel, par défaut : 30000)
voiceAnnouncements : Activer les notifications vocales (optionnel, par défaut : true)

Arrêter la surveillance des PR

Outil : stop_pr_monitoring

Description : Arrêter de surveiller un dépôt pour les pull requests.

Phrases déclencheuses :

"Arrêter de surveiller [dépôt]"
"Arrêter de surveiller les PRs"
"Désactiver les alertes PR pour [dépôt]"
"Désactiver la surveillance des PR"
"Arrêter de suivre les pull requests"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)

Vérifier l'état de surveillance des PR

Outil : check_pr_monitoring_status

Description : Voir l'état actuel de surveillance des PR pour tous les dépôts ou un dépôt spécifique.

Phrases déclencheuses :

"Quels dépôts suis-je en train de surveiller ?"
"Montrer l'état de surveillance"
"Vérifier la surveillance des PR pour [dépôt]"
"Lister les dépôts surveillés"
"Est-ce que je surveille [dépôt] ?"

Paramètres :

owner : Propriétaire du dépôt (optionnel)
repo : Nom du dépôt (optionnel)

Vérifier manuellement les nouvelles PRs

Outil : manually_check_new_prs

Description : Effectuer une vérification ponctuelle des nouvelles pull requests.

Phrases déclencheuses :

"Vérifier les nouvelles PRs maintenant"
"Y a-t-il de nouvelles pull requests dans [dépôt] ?"
"Vérifier manuellement [dépôt] pour les PRs"
"Chercher les PRs récentes"
"Vérification rapide des pull requests"

Paramètres :

owner : Nom d'utilisateur du propriétaire du dépôt (requis)
repo : Nom du dépôt (requis)

Outils de navigation

Naviguer vers un ticket

Outil : navigate_to_ticket

Description : Naviguer directement vers une issue ou une pull request GitHub par numéro.

Phrases déclencheuses :

"Aller à l'issue #[numéro]"
"Ouvrir le ticket [numéro]"
"Naviguer vers la PR [numéro]"
"Montre-moi l'issue numéro [numéro]"
"Emmène-moi à la pull request [numéro]"

Paramètres :

ticket_number : Numéro de l'issue ou de la PR (requis)
reason : Raison de la navigation

Naviguer vers un chemin

Outil : navigate_to_path

Description : Naviguer vers des chemins et pages d'application spécifiques.

Phrases déclencheuses :

"Aller à [nom de page]"
"Naviguer vers les paramètres"
"Ouvrir le tableau de bord"
"Emmène-moi à [section]"
"Montre-moi la [page]"

Paramètres :

path : Chemin de l'application (requis)
query : Paramètres de requête
reason : Raison de la navigation

Lister les routes de l'application

Outil : list_app_routes

Description : Afficher toutes les routes d'application et options de navigation disponibles.

Phrases déclencheuses :

"Vers quelles pages puis-je naviguer ?"
"Montrer les routes disponibles"
"Lister toutes les pages"
"Quelles options de navigation y a-t-il ?"
"Montre-moi tous les chemins disponibles"

Paramètres : Aucun

Navigation dans la page

Outil : in_page_navigation

Description : Contrôler le défilement et la navigation dans la page actuelle.

Phrases déclencheuses :

"Défiler vers le bas"
"Aller en haut"
"Défiler vers le bas"
"Page vers le haut/bas"
"Défiler vers [élément]"

Paramètres :

action : Action de navigation (scroll_down, scroll_up, page_down, page_up, scroll_to_top, scroll_to_bottom, scroll_to_element)
selector : Sélecteur CSS pour scroll_to_element
amount : Quantité de défilement en pixels

Retourner à la conversation

Outil : return_to_conversation

Description : Retourner à l'interface de conversation vocale après avoir navigué ailleurs.

Phrases déclencheuses :

"Retourner à la conversation"
"Retourner au chat vocal"
"Ramène-moi"
"Retour à la conversation"
"Retourner à l'écran principal"

Paramètres :

reason : Raison du retour

Gestion du système

Réinitialiser l'état de l'agent

Outil : reset_agent_state

Description : Effacer différents types d'état et de contexte de l'agent pour un nouveau départ.

Phrases déclencheuses :

"Réinitialiser l'agent"
"Effacer tout l'état"
"Repartir à zéro"
"Effacer l'historique de conversation"
"Réinitialiser l'espace de travail"

Paramètres :

clearWorkspace : Effacer les données de l'espace de travail (par défaut : true)
clearConversation : Effacer l'historique de conversation (par défaut : true)
clearEventLogs : Effacer les journaux d'événements (par défaut : true)
clearNavigationHistory : Effacer l'historique de navigation (par défaut : true)
clearToolCallHistory : Effacer l'historique des appels d'outils (par défaut : true)
clearPRMonitoring : Effacer l'état de surveillance des PR (par défaut : false)
clearAuthentication : Effacer les tokens d'authentification (par défaut : false)
clearUserPreferences : Effacer les préférences utilisateur (par défaut : false)
clearCache : Effacer les caches (par défaut : true)
clearTempFiles : Effacer les fichiers temporaires (par défaut : true)

Conseils pour une utilisation efficace

Langage naturel : Les outils sont conçus pour comprendre le langage naturel. Vous n'avez pas besoin d'utiliser des phrases exactes.
Conscience du contexte : L'agent se souvient du contexte de votre conversation, vous pouvez donc vous référer à "le dépôt" ou "cette issue" après l'avoir mentionné une fois.
Mentions automatiques : Lors de la création ou de la mise à jour d'issues, de PRs et de commentaires, l'agent inclut automatiquement des mentions @claude pour maintenir la traçabilité.
Retour vocal : De nombreux outils fournissent un retour vocal lorsque les opérations se terminent, en particulier pour les tâches de surveillance et de navigation.
Enchaînement d'opérations : Vous pouvez enchaîner plusieurs opérations ensemble, comme "Créer une issue sur le bug dont nous venons de discuter et me l'assigner."
Valeurs par défaut intelligentes : La plupart des paramètres optionnels ont des valeurs par défaut sensées, vous n'avez donc besoin de spécifier que ce que vous voulez changer.
Gestion des erreurs : L'agent fournira des messages d'erreur utiles si quelque chose se passe mal et suggérera des alternatives si possible.

Flux de travail courants

Flux de travail de signalement de bugs

"Créer une issue intitulée 'Le bouton ne fonctionne pas sur mobile'"
"Ajouter les étiquettes bug et haute priorité"
"L'assigner à l'équipe mobile"
"Ajouter un commentaire avec la capture d'écran"

Flux de travail de revue de PR

"Montre-moi les pull requests ouvertes"
"Obtenir les détails de la PR #42"
"Montre-moi les changements dans la PR #42"
"Ajouter un commentaire approuvant les changements"

Exploration de dépôt

"Montre-moi la structure du dépôt"
"Rechercher le code d'authentification"
"Montre-moi le contenu du dossier auth"
"Obtenir le contenu du fichier login.js"

Configuration de la surveillance

"Commencer à surveiller mon-dépôt pour les nouvelles PRs"
"Vérifier l'état de surveillance"
"M'alerter vocalement lors de l'arrivée de nouvelles PRs"
"Arrêter la surveillance quand c'est terminé"