Facture de Compétences : Un Cadre de Gouvernance Basé sur Markdown pour les Compétences en Codage IA

Qu'est-ce que Skill Bill

Skill Bill est un cadre de gouvernance pour les compétences de codage IA entièrement construit en Markdown. Il résout les problèmes courants auxquels les développeurs sont confrontés lors de la gestion de multiples prompts IA sur différents agents : la dérive des noms, la logique dupliquée, l'intrusion de code spécifique à une plateforme dans des compétences génériques, et l'absence d'une source unique de vérité.

Comment cela a commencé

Le développeur a commencé avec des compétences individuelles pour des tâches spécifiques : un prompt de revue de code pour le travail Android/KMP, une compétence gradle check avec des conventions pour corriger les problèmes au lieu de les supprimer, une compétence feature flag, et une compétence pour implémenter des fonctionnalités à partir de documents de conception. Après avoir accumulé environ une douzaine de compétences dispersées entre les agents, il a connu la "détérioration familière" des noms incohérents et de la logique spécifique à Kotlin apparaissant dans des compétences supposément génériques.

La percée de l'orchestrateur

L'innovation clé a été la création de feature-implement, une compétence qui appelle d'autres compétences en séquence. Cet orchestrateur prend un document de conception, crée un plan, interroge sur la stratégie des feature flags, implémente le code, exécute des revues et vérifie l'exhaustivité. Une seule exécution de feature-implement enchaîne 10 à 12 invocations de compétences : un orchestrateur, un routeur de revue de code détectant la pile, 3 à 5 réviseurs spécialistes fonctionnant en parallèle, une vérification de qualité, une description de PR, et une configuration optionnelle de feature flag.

Considérations de coût

Le développeur utilise Claude Code avec un abonnement Max et n'a pas initialement pris en compte les coûts d'utilisation. Cependant, un ami utilisant un abonnement Codex Pro a rapporté qu'une seule invocation de la compétence code-review (pas la chaîne complète) consomme 40 à 50 % de la limite de taux de 5 heures du Pro. Copilot utilise un modèle de facturation différent (par tour de conversation plutôt que par volume de tokens), le rendant plus rentable pour cette approche.

Architecture technique

Le framework a évolué pour supporter plusieurs langages de programmation via du Markdown structuré qui fonctionne comme du code :

• Héritage : Compétences de base avec des surcharges par plateforme
• Logique de routage : Détection de pile et délégation aux spécialistes appropriés
• Contrats d'interface : Relations définies entre les compétences
• Validation : Applique des règles de nommage et une structure pour prévenir la détérioration du référentiel

Une fois que la couche de base est devenue correctement générique, l'ajout du support PHP a été simple, suivi par Go. Le framework inclut désormais 44 compétences pour Kotlin, Android/KMP, backend Kotlin, PHP et Go.

Fonctionnalités clés

• Compétences de base qui routent automatiquement vers le spécialiste de plateforme approprié
• Un validateur qui applique les règles de nommage et la structure
• Un référentiel unique qui se synchronise avec Claude Code, Copilot, GLM et Codex
• Des compétences d'orchestration comme feature-implement qui enchaînent tout de bout en bout
• Actuellement le plus solide pour la famille Kotlin et les backends Go/PHP, mais conçu pour s'étendre à de nouvelles plateformes

Implications pratiques

Le développeur a découvert que les référentiels de prompts ont les mêmes problèmes d'ingénierie que les logiciels classiques. En traitant les compétences comme du code—avec des contrats, de la validation et de la composabilité—le système entier est devenu considérablement plus maintenable. Le framework est disponible sur GitHub sous licence MIT à l'adresse https://github.com/Sermilion/skill-bill.