SamuelChien/mega-skills-collection

Exécutez cette compétence lorsque l'utilisateur demande « format SPAWN REQUEST », « rapports d'agent », « coordination d'agents », « agents parallèles », « format de rapport », « communication entre agents » ou a besoin de comprendre comment les agents se coordonnent dans le système de sprint.

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

Cette compétence définit le protocole de coordination multi-agents au sein du plugin Sprint. Elle permet à l'architecte du projet de lancer des agents d'implémentation et de test en utilisant un format structuré de requête (SPAWN REQUEST), de collecter des rapports standardisés contenant les travaux effectués, les fichiers modifiés et les résultats de tests, et de partitionner le travail par domaine pour éviter les conflits entre agents parallèles. En suivant ce protocole, les équipes d'agents peuvent collaborer efficacement sur des sprints complexes, en s'assurant que chaque agent reçoit uniquement les fichiers pertinents et que les retours sont intégrés de manière cohérente. La compétence inclut également une gestion des erreurs et des exemples concrets pour faciliter la mise en œuvre.

Compatible avec✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-patterns

Documentation

Modèles d'Agent

Aperçu

Agent Patterns définit le protocole de coordination pour l'exécution de sprints multi-agents au sein du plugin Sprint. Il régit la manière dont l'architecte du projet lance les agents d'implémentation et de test, comment les agents communiquent les résultats via des rapports structurés et comment les agents parallèles évitent les conflits.

Prérequis

Plugin Sprint installé et configuré (/plugin install sprint)
Répertoire Sprint initialisé dans .claude/sprint/[N]/
specs.md rédigé avec un périmètre clair et une configuration de test
Familiarité avec le cycle de vie des phases Sprint (voir la compétence sprint-workflow)

Instructions

Structurez chaque lancement d'agent en utilisant le format SPAWN REQUEST. Incluez le nom de l'agent, le fichier de spécifications qu'il doit lire et toute contrainte de périmètre :
```
SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
Scope: Authentication endpoints only
```
Assurez-vous que chaque agent lancé reçoit uniquement les fichiers pertinents pour son périmètre. Passez le api-contract.md comme interface partagée afin que les agents backend et frontend restent synchronisés.
Collectez des rapports structurés de chaque agent à la fin de son travail. Chaque rapport doit inclure : le travail accompli, les fichiers modifiés, les tests ajoutés et l'état de conformité par rapport aux spécifications.
Lorsque vous exécutez des agents en parallèle, partitionnez le travail par domaine (par exemple, backend vs frontend vs CI/CD). N'attribuez jamais de chemins de fichiers qui se chevauchent à des agents concurrents.
Transmettez les rapports d'agents à l'architecte du projet pour examen. L'architecte décide s'il faut itérer (relancer avec des spécifications réduites) ou passer à la phase suivante.
Pour les agents de test, transmettez le format de rapport de test UI indiqué dans ${CLAUDE_SKILL_DIR}/references/ui-test-report.md afin que les résultats suivent un schéma cohérent incluant le nombre de tests, la couverture, les échecs et les erreurs console.

Résultat

Blocs SPAWN REQUEST consommés par l'orchestrateur Sprint pour lancer les agents
Rapports d'agents structurés contenant : résumé, fichiers modifiés, résultats de tests et statut de conformité
Rapports de test UI avec comptes réussites/échecs, détails de couverture, descriptions des échecs et logs d'erreur console
status.md mis à jour reflétant le travail accompli et restant après chaque itération

Gestion des erreurs

Erreur	Cause	Solution
L'agent reçoit un mauvais fichier de spécifications	Chemin incorrect dans SPAWN REQUEST	Vérifiez le numéro du répertoire Sprint et le nom du fichier avant de lancer
Modifications de fichiers qui se chevauchent de la part d'agents parallèles	Limites de périmètre mal définies	Partitionnez le travail par domaine ; attribuez des répertoires distincts à chaque agent
Rapport d'agent manquant de champs obligatoires	Les instructions de l'agent manquent du format de rapport	Incluez le modèle de rapport structuré dans l'invite de l'agent
Boucle d'itération infinie	Les spécifications ne sont jamais entièrement satisfaites	Vérifiez `status.md` pour les problèmes bloquants ; l'orchestrateur fait une pause après 5 itérations
Agent introuvable	Nom d'agent mal orthographié dans SPAWN REQUEST	Vérifiez que les fichiers markdown de l'agent existent dans le répertoire `agents/`

Exemples

Lancement d'agents d'implémentation en parallèle :

SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md

SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md

Les deux agents partagent le même api-contract.md pour garantir la compatibilité de l'API.

Format de rapport d'agent structuré :

AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec

Coordination des agents de test :

SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev

SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent

Ressources

${CLAUDE_SKILL_DIR}/references/ui-test-report.md -- Format de rapport de test UI structuré avec suivi de couverture et des échecs
Compétence Sprint workflow pour le contexte du cycle de vie des phases
Compétence API contract pour la conception d'interfaces partagées
README du plugin Sprint pour une vue d'ensemble de l'architecture des agents