Communitygithub.com

SamuelChien/mega-skills-collection

Coordonner des équipes d'agents Claude Code via un protocole basé sur le système de fichiers. Utiliser pour orchestrer plusieurs agents Claude sur des tâches parallèles, pour la gestion des dépendances de tâches, la revue de code multi-agents ou l'implémentation. Ne pas utiliser lorsqu'un seul agent suffit ou que la tâche n'est pas parallélisable.

Qu'est-ce que mega-skills-collection ?

Cette compétence, intitulée « Agent Teams Coordination », permet à plusieurs processus Claude CLI de collaborer sur un travail partagé via un protocole de coordination basé sur le système de fichiers. Chaque membre de l'équipe s'exécute comme un processus `claude` indépendant dans un volet tmux, communiquant via des fichiers JSON protégés par des verrous `fcntl`. Aucune base de données, aucun démon, aucune couche réseau requis. Elle est particulièrement utile pour les implémentations parallèles multi-fichiers, la revue de code multi-agents, les refactorisations importantes et toute tâche bénéficiant d'une parallélisation naturelle. La compétence est conçue pour fonctionner avec Claude Code en ligne de commande et tmux, et inclut des mécanismes de gestion des dépendances de tâches, de communication par messagerie, de rôles d'équipe, de surveillance de la santé des agents, et d'intégration avec le modèle de délégation Conjure. Elle ne devrait pas être utilisée pour des modifications d'un seul fichier ou des tâches nécessitant un raisonnement séquentiel strict.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-teams

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Table des matières

Coordination des équipes d'agents

Vue d'ensemble

Claude Code Agent Teams permet à plusieurs processus Claude CLI de collaborer sur un travail partagé via un protocole de coordination basé sur le système de fichiers. Chaque membre de l'équipe s'exécute comme un processus claude indépendant dans un volet tmux, communiquant via des fichiers JSON protégés par des verrous fcntl. Aucune base de données, aucun démon, aucune couche réseau.

Cette compétence fournit les schémas pour orchestrer efficacement les équipes d'agents.

Quand utiliser

  • Implémentation parallèle sur plusieurs fichiers ou modules
  • Revue de code multi-agents (un agent révise, un autre implémente des corrections)
  • Refactorisation importante nécessitant des changements coordonnés entre sous-systèmes
  • Tâches avec parallélisme naturel qui bénéficient d'agents concurrents

Quand NE PAS utiliser

  • Modifications d'un seul fichier ou petites tâches (la surcharge dépasse le bénéfice)
  • Tâches nécessitant un raisonnement séquentiel strict (les agents se coordonnent de manière lâche)
  • Lorsque l'interface en ligne de commande claude n'est pas disponible ou que tmux n'est pas installé

Prérequis

# Vérifier Claude Code CLI
claude --version

# Vérifier tmux (nécessaire pour le mode à volets)
tmux -V

# Activer la fonctionnalité expérimentale (définie automatiquement par le générateur)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Architecture du protocole

~/.claude/
  teams/<nom-de-léquipe>/
    config.json            # Métadonnées de l'équipe + liste des membres
    inboxes/
      <nom-agent>.json    # File de messages par agent
      .lock                # Verrou exclusif fcntl
  tasks/<nom-de-léquipe>/
    1.json ... N.json      # Fichiers de tâches auto-incrémentés
    .lock                # Verrou exclusif fcntl

Principes de conception :

  • Le système de fichiers est la base de données : fichiers JSON, écritures atomiques via tempfile + os.replace
  • Verrouillage fcntl : empêche la corruption de lecture/écriture concurrente sur les boîtes de réception et les tâches
  • Tâches numérotées : identifiants auto-incrémentés avec nommage séquentiel des fichiers
  • Couplage lâche : les agents interrogent leur propre boîte de réception ; pas de notifications push

Démarrage rapide

1. Créer une équipe

# Configuration programmatique de l'équipe (via MCP ou API directe)
# La configuration de l'équipe est écrite dans ~/.claude/teams/<nom-de-léquipe>/config.json

La configuration de l'équipe contient :

  • name, description, created_at (timestamp en ms)
  • lead_agent_id, lead_session_id
  • members[] — tableau d'objets LeadMember et TeammateMember

2. Lancer les coéquipiers

Chaque coéquipier est un processus claude CLI séparé lancé avec des indicateurs d'identité :

claude --agent-id "backend@mon-equipe" \
       --agent-name "backend" \
       --team-name "mon-equipe" \
       --agent-color "#FF6B6B" \
       --parent-session-id "$SESSION_ID" \
       --agent-type "general-purpose" \
       --model sonnet

Voir modules/spawning-patterns.md pour la gestion des volets tmux et l'attribution des couleurs.

3. Créer des tâches avec dépendances

{
  "id": "1",
  "subject": "Implémenter les points d'accès API",
  "description": "Créer les points d'accès REST pour la gestion des utilisateurs",
  "status": "pending",
  "owner": null,
  "blocks": ["3"],
  "blocked_by": [],
  "metadata": {}
}

Voir modules/task-coordination.md pour la machine d'état et la gestion des dépendances.

4. Coordonner via des messages

{
  "from": "chef-déquipe",
  "text": "Les points d'accès API sont prêts pour les tests d'intégration",
  "timestamp": "2026-02-07T22:00:00Z",
  "read": false,
  "summary": "API prête"
}

Voir modules/messaging-protocol.md pour les types de messages et les opérations sur la boîte de réception.

Flux de coordination

  1. agent-teams:team-created — Initialiser la configuration et les répertoires de l'équipe
  2. agent-teams:teammates-spawned — Lancer les agents dans les volets tmux
  3. agent-teams:tasks-assigned — Créer des tâches avec dépendances, attribuer des responsables
  4. agent-teams:coordination-active — Les agents réclament les tâches, échangent des messages, marquent l'achèvement
  5. agent-teams:team-shutdown — Arrêt progressif avec protocole d'approbation

Rôles de l'équipe

Chaque membre de l'équipe a un role qui détermine ses capacités et sa compatibilité avec les tâches. Cinq rôles sont définis : implementer (par défaut), researcher, tester, reviewer, et architect. Les rôles contraignent les niveaux de risque qu'un agent peut gérer — voir modules/crew-roles.md pour la matrice complète des capacités et le tableau de compatibilité rôle-risque.

Surveillance de la santé

Les membres de l'équipe peuvent être surveillés pour leur santé via des messages de pulsation et l'expiration des réclamations. Le chef interroge la santé de l'équipe toutes les 60 secondes avec un protocole de détection de blocage en 2 étapes (sonde health_check + attente de 30 s). Les agents bloqués voient leurs tâches libérées et sont redémarrés ou remplacés suivant la doctrine "remplacer, ne pas attendre". Voir modules/health-monitoring.md pour le protocole complet et la machine d'état.

Référence des modules

  • team-management.md : Cycle de vie de l'équipe, format de configuration, gestion des membres
  • messaging-protocol.md : Types de messages, opérations sur la boîte de réception, schémas de verrouillage
  • task-coordination.md : CRUD des tâches, machine d'état, détection de cycles de dépendances
  • spawning-patterns.md : Lancement tmux, indicateurs CLI, gestion des volets
  • crew-roles.md : Taxonomie des rôles, matrice des capacités, compatibilité rôle-risque
  • health-monitoring.md : Protocole de pulsation, détection de blocage, récupération automatisée

Intégration avec Conjure

Agent Teams étend le modèle de délégation conjure :

Modèle ConjureÉquivalent Agent Teams
delegation-core:task-assessedagent-teams:team-created
delegation-core:handoff-plannedagent-teams:tasks-assigned
delegation-core:results-integratedagent-teams:team-shutdown
Exécution LLM externeExécution de l'agent coéquipier

Utilisez d'abord Skill(conjure:delegation-core) pour déterminer si la tâche bénéficie d'une coordination multi-agents par rapport à une délégation à service unique.

Alternative d'isolation par worktree (Claude Code 2.1.49+)

Pour les agents parallèles qui modifient des fichiers, isolation: worktree fournit une alternative légère à la coordination basée sur le système de fichiers. Chaque agent s'exécute dans son propre worktree git temporaire, éliminant le besoin de verrouillage fcntl ou d'évitement de conflit basé sur la boîte de réception pour les fichiers partagés.

  • Quand préférer les worktrees à la messagerie des équipes d'agents : Les agents travaillent sur des fichiers qui se chevauchent mais n'ont pas besoin de communication en cours d'exécution
  • Quand préférer la messagerie des équipes d'agents : Les agents doivent coordonner des découvertes ou ajuster leurs plans en fonction de la progression des autres
  • Combiner les deux : Utilisez les équipes d'agents pour la coordination avec isolation: worktree par coéquipier pour la sécurité du système de fichiers

Dépannage

Problèmes courants

tmux introuvable Installez via le gestionnaire de paquets : brew install tmux / apt install tmux

Fichiers de verrouillage obsolètes Si un agent plante en cours d'opération, les fichiers de verrouillage peuvent persister. Supprimez manuellement les fichiers .lock de ~/.claude/teams/<équipe>/inboxes/ ou ~/.claude/tasks/<équipe>/

Tâches orphelines Les tâches réclamées par un agent qui a planté restent indéfiniment in_progress. Utilisez modules/health-monitoring.md pour la détection de blocage basée sur les pulsations et la libération automatique des tâches. Le protocole de surveillance de la santé détecte les agents qui ne répondent pas dans les 60 s + 30 s de fenêtre de sonde et libère leurs tâches pour réaffectation.

Ordre des messages La résolution des horodatages du système de fichiers varie (HFS+ = granularité de 1 s). Utilisez des noms de fichiers numérotés ou triés par UUID pour éviter les collisions lors de rafales de messages rapides.

Erreurs de modèle sur Bedrock/Vertex/Foundry (avant 2.1.39) Les agents coéquipiers pouvaient utiliser des identifiants de modèle incorrects sur les fournisseurs d'entreprise, provoquant des erreurs 400. Mettez à niveau vers Claude Code 2.1.39+ pour une qualification correcte des identifiants de modèle sur tous les fournisseurs.

Protection de session imbriquée (2.1.39+) Si claude refuse de se lancer dans une session existante, assurez-vous d'utiliser le fractionnement en volets tmux (et non un appel en sous-shell). La protection est intentionnelle — voir modules/spawning-patterns.md pour les détails.

Critères de complétion

  • Équipe créée avec configuration et répertoires
  • Coéquipiers lancés et enregistrés dans la configuration
  • Tâches créées avec graphe de dépendances (aucun cycle)
  • Agents coordonnant via des messages dans la boîte de réception
  • Arrêt progressif complété

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills associés