Ou tapez /a2a-protocol-guide dans une session Claude Code, ou décrivez simplement votre besoin — le skill se déclenche automatiquement via le skill-router.
🔑 Déclencheurs automatiques
Le skill s'active automatiquement quand votre demande contient :
Comprendre l'architecture A2A — Expliquer les concepts fondamentaux du protocole : Agent Cards (description des capacités), Task lifecycle (submitted, working, completed, failed), Artifacts (résultats produits), et les rôles client/server entre agents.
Créer l'Agent Card — Définir la carte d'identité de l'agent au format JSON : nom, description, URL du endpoint, capabilities supportées (streaming, push notifications), skills déclarées avec exemples d'utilisation, et méthodes d'authentification acceptées.
Implémenter le serveur A2A — Développer le endpoint HTTP qui reçoit les requêtes JSON-RPC 2.0 : tasks/send pour les tâches synchrones, tasks/sendSubscribe pour le streaming SSE, tasks/get pour consulter le statut, et tasks/cancel pour l'annulation.
Gérer le cycle de vie des tâches — Implémenter la machine à états des tâches (submitted → working → completed/failed/canceled), les mises à jour intermédiaires via TaskStatusUpdateEvent, et la production d'artifacts (fichiers, données structurées, messages).
Configurer la découverte d'agents — Publier l'Agent Card sur /.well-known/agent.json, implémenter un registre d'agents pour la découverte dynamique, et définir les critères de sélection d'un agent pour une tâche donnée (skills, disponibilité, coût).
Sécuriser les communications — Mettre en place l'authentification entre agents (OAuth 2.0, API keys), le chiffrement des échanges (HTTPS), la validation des Agent Cards, et les politiques d'autorisation (quels agents peuvent interagir).
Orchestrer la collaboration multi-agents — Concevoir les workflows de collaboration : délégation de sous-tâches, agrégation de résultats, gestion des échecs et fallback vers d'autres agents, et chaînage de tâches entre agents spécialisés.
Monitorer et debugger — Tracer les échanges inter-agents avec des correlation IDs, logger les transitions de statut des tâches, mesurer les latences de communication, et diagnostiquer les échecs de découverte ou d'authentification.
Règles
Respecte strictement la spécification JSON-RPC 2.0 pour tous les échanges entre agents — pas de formats propriétaires.
Chaque agent doit exposer une Agent Card complète et à jour sur son endpoint /.well-known/agent.json.
Implémente toujours les mécanismes de timeout et d'annulation pour éviter les tâches bloquées indéfiniment.
Conçois les agents comme des services indépendants et stateless — l'état des tâches doit être persisté côté serveur.
Documente clairement les skills et le format des artifacts produits par chaque agent pour faciliter l'intégration.