Skill de bot Discord pour Claude : créer et tester une commande

Un skill de bot Discord pour Claude doit guider l’agent jusqu’à une fonctionnalité opérationnelle : définir la commande, créer l’application Discord, demander les permissions minimales, protéger le token et tester dans un serveur que vous contrôlez. Une liste de vérifications obligeant Claude à tester la commande dans Discord est plus utile qu’un dossier d’extraits génériques.

Commencer par une commande et ses permissions

Imaginons qu’une communauté souhaite que /resources topic:design renvoie un lien sélectionné. Précisez qui peut l’utiliser, où elle doit répondre, si la réponse peut être publique et où les liens sont conservés. Cela suffit pour créer et tester un premier parcours complet. Une demande comme « créer un bot communautaire » ne définit ni les permissions, ni le traitement des données, ni les critères de réussite.

Le guide de démarrage de Discord explique l’application, le compte du bot, les identifiants et le parcours d’installation. Consultez sa version actuelle lors de la configuration : les réglages du portail et les libellés des permissions peuvent changer. La documentation des commandes d’application décrit la structure des commandes slash et la gestion des interactions.

Installer une méthode de travail, puis développer dans le projet

Claude Code peut charger les instructions d’un skill, comme l’explique sa documentation des skills. Installez le skill Discord Bot Builder pour le brief, la revue des permissions et la liste de tests. Fournissez à Claude les fichiers du projet existant et l’environnement d’hébergement. Le skill doit s’adapter au langage et au framework du projet, sans les remplacer par principe.

Conservez le token du bot dans une variable d’environnement ou un gestionnaire de secrets. Ne le collez jamais dans une conversation, un fichier source ou un bundle envoyé au navigateur. Si un token a été exposé, remplacez-le dans le Discord Developer Portal et actualisez le secret de déploiement. Demandez à Claude de montrer un .env.example contenant uniquement les noms des variables.

Pour un bot fondé sur des commandes, envisagez les commandes d’application avant de lire tous les messages d’un serveur. Ne demandez un intent privilégié que si la fonctionnalité en a besoin et si l’application est configurée pour cela. Accordez au bot les portées d’installation et les permissions minimales nécessaires à son comportement.

Faire vérifier le premier parcours par Claude

A useful build prompt is: “In this Node project, implement one Discord slash command, /resources topic, using the existing stack. Return one curated link for design and a clear response for unknown topics. Use environment variables for credentials, ask for only the scopes and permissions this command needs, register it in my test guild, and add tests for valid input and missing configuration. Show the exact manual guild checks before calling it complete.”

Claude peut écrire les fichiers et les tests, mais un test unitaire réussi ne prouve pas que la commande est enregistrée, installée et réactive dans Discord. Utilisez un serveur que vous contrôlez. Appelez la commande avec un utilisateur autorisé, avec un sujet inconnu et dans un contexte où le bot manque d’une permission. Notez le résultat observé et corrigez la configuration ou le code en cause.

Déployer en gardant le contrôle du bot

Placez les identifiants dans les réglages de secrets de l’hébergeur et définissez une procédure de redémarrage. Journalisez les noms des commandes, les catégories d’erreurs et les identifiants de requêtes utiles ; évitez les tokens et le contenu des messages privés. Documentez la désactivation du bot, le remplacement de son token et la mise à jour des commandes enregistrées. S’il stocke des données utilisateur, précisez lesquelles, pourquoi et pendant combien de temps.

Le premier déploiement est terminé lorsque la commande fonctionne dans le serveur prévu et que l’équipe peut reproduire la configuration à partir d’instructions écrites. Ajoutez ensuite les fonctionnalités une à une et réexaminez les permissions chaque fois qu’une nouveauté exige un accès plus large.

Questions fréquentes

Un bot à commandes slash doit-il lire tous les messages ?

Non. Une commande comme /resources peut répondre à sa propre interaction. Si une fonctionnalité ultérieure exige le contenu des messages ou un autre intent privilégié, décrivez-la, vérifiez les exigences actuelles de Discord et adaptez explicitement la configuration. Ne demandez pas un accès large par facilité.

Que fournir à Claude avant de commencer ?

Fournissez le dépôt existant, l’environnement d’exécution, la spécification d’une commande, le serveur de test, l’hébergement prévu et les permissions que vous acceptez d’accorder. Donnez les noms des variables d’identification, jamais les valeurs des tokens. Demandez un compte rendu des tests effectués dans le code et des vérifications manuelles encore nécessaires dans Discord.