agency-agents-zh : 277 rôles d'experts IA à brancher dans votre outil de codage

Un catalogue de rôles, pas un framework

Le problème que ce dépôt attaque est précis : écrire un bon system prompt métier prend du temps, et le refaire pour chaque outil est fastidieux. agency-agents-zh propose 277 définitions d'agents prêtes à l'emploi, réparties sur 20 départements : direction (CEO, CTO, CMO, COO, CPO, CFO), ingénierie, design, marketing, produit, jeu vidéo, sécurité, GIS, finance. Le README insiste sur un point : ce ne sont pas des modèles de prompts génériques, chaque agent possède selon la documentation une personnalité, un processus métier et des livrables propres. Le public visé est double. D'un côté des équipes chinoises qui veulent des rôles adaptés à leurs plateformes. De l'autre des développeurs qui utilisent Claude Code, Cursor ou Copilot et préfèrent piocher un persona existant plutôt que d'en rédiger un. Le dépôt est une traduction communautaire du projet upstream agency-agents, enrichie de 64 agents originaux. Ce chiffre de 64 est celui du README ; les notes de version montrent une correction de comptage en v1.2.4, ce qui indique que la numérotation a déjà bougé et qu'il faut se fier au dépôt plutôt qu'à un chiffre figé.

Ce que contiennent les 64 agents chinois

C'est la partie qui distingue cette version de l'original anglophone. Le README cite les domaines couverts : opérations sur 小红书, 抖音, 微信, B站, 飞书 et 钉钉, commerce transfrontalier, secteur public ToG, conformité médicale, interfaces industrielles Qt 上位机, conception mécanique, et même vérification de registres d'élevage. Cette liste est hétérogène, et c'est justement l'intérêt : un agent 小红书 n'a pas la même valeur qu'un agent de revue de code générique, parce que les conventions de plateforme et le vocabulaire local sont difficiles à improviser. À l'inverse, certains domaines très verticaux posent une question de maintenance : qui mettra à jour l'agent de conformité médicale quand la réglementation change ? Le README ne décrit pas de processus de revue par domaine. Un lecteur qui a besoin d'un agent sur un sujet réglementé doit donc considérer la définition comme un point de départ, pas comme une source de vérité.

Comment les définitions arrivent dans votre outil

Le dépôt est écrit principalement en Shell et publié sur npm sous le nom agency-agents-zh, d'après le badge du README. Le dépôt ne détaille pas dans l'extrait fourni la commande exacte d'installation ni la structure des fichiers ; il faut donc se référer au dépôt lui-même pour la procédure précise. Ce que le README établit, c'est la compatibilité : 20 outils de codage IA sont pris en charge, dont Claude Code, Cursor et Copilot. Le modèle d'intégration repose sur les formats que ces outils consomment déjà (règles pour Cursor, agents pour Copilot, définitions pour Claude Code), ce que suggèrent les topics du dépôt : cursor-rules, copilot-agent, agent-definitions. Autrement dit, l'adoption ne passe pas par un runtime propriétaire : on copie ou on installe des fichiers que l'outil lit nativement. Pour l'orchestration multi-agents, le README renvoie à un projet distinct, agency-orchestrator, avec un client de bureau natif pour macOS, Windows et Linux, présenté comme ne nécessitant pas Node. Une démonstration en ligne existe à l'adresse ao.aiolaola.com/experts.

Le DAG et ce qu'il implique

L'argument de vente du README tient en une phrase : avec l'orchestrateur, une seule instruction suffit pour que plusieurs experts collaborent automatiquement selon un DAG. Le principe est cohérent avec le format du dépôt. Si chaque agent est un fichier autonome avec un rôle et des livrables, un orchestrateur peut les traiter comme des nœuds et enchaîner les sorties. Mais cette architecture a une conséquence pratique que le README n'aborde pas : la qualité du résultat dépend alors de la qualité des sorties intermédiaires, et un agent mal calibré contamine tout ce qui se trouve en aval dans le graphe. Rien dans le matériel fourni ne décrit de mécanisme de validation entre les nœuds, ni de gestion d'échec partiel. Le client de bureau est distribué via les releases de agency-orchestrator, séparément de ce dépôt, ce qui signifie deux cycles de version à suivre. Le dépôt agency-agents-zh est en v1.2.6, datée du 16 juin 2026 selon les releases fournies ; les deux projets peuvent diverger.

Les limites visibles dans le dépôt lui-même

La première limite est la langue. Les 277 agents sont en chinois, et les 64 agents originaux portent sur des plateformes et des réglementations chinoises. Pour une équipe francophone, l'intérêt se concentre sur les 213 agents traduits de l'anglais, dont la version originale est disponible en amont. Autant utiliser la source dans ce cas. La deuxième limite est la nature du dépôt : un catalogue vieillit. Les conventions de 小红书 ou 抖音 changent, et rien dans le matériel fourni n'indique un mécanisme de revue ou de dépréciation des agents obsolètes. La troisième concerne le contenu du README lui-même : une part importante de l'extrait est occupée par des sponsors et des liens d'affiliation, avec des codes de réduction. Cela ne dit rien de la qualité des agents, mais cela indique que le projet est aussi un canal de distribution commercial. Enfin, le dépôt n'est pas archivé et la dernière poussée date du 9 septembre 2026, ce qui suggère une activité récente, sans garantir la fréquence des mises à jour futures.

Comparer avec un simple fichier de règles maison

L'alternative la plus directe n'est pas un autre catalogue, c'est votre propre fichier de règles. Une équipe qui écrit un fichier de règles Cursor ou un agent Copilot sur mesure contrôle exactement le vocabulaire, les contraintes et les exemples, et ce fichier évolue avec le code. agency-agents-zh apporte l'inverse : une base large et immédiate, mais générique par construction, puisque le même agent doit servir des contextes différents. La différence d'approche est nette. Un fichier maison encode vos conventions, vos noms de fichiers, vos commandes de build. Un agent du catalogue encode un métier. Sur une tâche de revue de code, le fichier maison sera plus précis ; sur une tâche de rédaction marketing pour 小红书, l'agent du catalogue vous fera gagner le temps de recherche des codes de la plateforme. La bonne lecture est donc de traiter le dépôt comme une source d'inspiration et de point de départ, pas comme une couche de configuration définitive.

Licence MIT et coût de maintenance

Le dépôt est sous licence MIT, ce qui autorise la réutilisation, la modification et la redistribution, y compris dans un contexte commercial, à condition de conserver la notice de copyright et le texte de la licence. Le README ne signale pas de restriction supplémentaire sur les définitions d'agents elles-mêmes. Attention toutefois à un point : le dépôt dérive d'un projet amont, agency-agents, et la licence de l'amont doit être vérifiée séparément si vous redistribuez les 213 agents traduits. Sur la maintenance, le coût réel n'est pas l'installation mais le suivi. Vous héritez de deux projets (le catalogue et l'orchestrateur), d'une numérotation qui a déjà été corrigée en cours de route, et de définitions dont la pertinence dépend de plateformes qui évoluent vite. Prévoir une revue périodique des agents que vous utilisez réellement est plus utile que de suivre les 277. Ce texte ne constitue pas un avis juridique.

Conclusion éditoriale

agency-agents-zh convient aux équipes qui travaillent en chinois et veulent des personas d'agents déjà rédigés, avec une couverture sérieuse des plateformes locales (小红书, 抖音, 飞书, 钉钉) et de quelques niches industrielles (Qt 上位机, 机械设计). Il ne convient pas à qui cherche un framework d'orchestration générique : le dépôt reste un catalogue de définitions, et la logique de graphe vit dans un projet séparé, agency-orchestrator, dont la documentation n'apparaît pas ici. Avant d'adopter, vérifiez deux choses concrètement : le contenu réel d'un fichier d'agent de votre domaine dans le dépôt, et si le paquet npm agency-agents-zh correspond bien à la version du dépôt que vous lisez.

Sources officielles

1. jnMetaCode/agency-agents-zh on GitHub
2. License: MIT
3. Project website
4. README
5. Releases