HeJia58/verification-faisabilite-technique

Que fait verification-faisabilite-technique ?

Compétence d'agent IA : vérifier les plans techniques par rapport aux registres en direct (HuggingFace/Ollama/GitHub/PyPI/npm) avec des requêtes par lots parallèles et une liste d'écueils durement acquise.

Description

Cette compétence permet à un agent IA de valider la faisabilité technique d'un plan en interrogeant plusieurs registres de packages et dépôts en parallèle. Elle prend en charge les registres suivants :

• HuggingFace : modèles, datasets, espaces
• Ollama : modèles disponibles localement
• GitHub : dépôts, releases, tags
• PyPI : packages Python, versions
• npm : packages JavaScript, versions

Pourquoi c'est utile

Lors de la planification d'un projet, il est essentiel de vérifier que les dépendances et ressources externes existent et sont accessibles. Cette compétence évite les intégrations impossibles ou obsolètes en détectant par exemple :

• Un modèle HuggingFace qui n'existe pas
• Un package PyPI en version incompatible
• Un dépôt GitHub qui a été supprimé ou renommé
• Un package npm qui a été déprécié

Fonctionnement

La compétence exécute des requêtes par lots en parallèle pour gagner du temps. Voici comment l'utiliser :

1. Fournir un plan technique avec les dépendances à vérifier
2. L'agent interroge chaque registre en parallèle
3. Un rapport structuré est généré avec les résultats

Exemple de requête

{
  "plan": "Utiliser le modèle 'bert-base-uncased' de HuggingFace avec le package 'transformers' version 4.30.0 de PyPI"
}

Exemple de réponse

{
  "results": {
    "huggingface": {
      "status": "ok",
      "model": "bert-base-uncased",
      "exists": true
    },
    "pypi": {
      "status": "ok",
      "package": "transformers",
      "version": "4.30.0",
      "exists": true
    }
  },
  "pitfalls_checklist": [
    "Vérifier les dépréciations",
    "Vérifier les changements de namespace",
    "Vérifier les versions masquées"
  ]
}

Liste d'écueils

Voici une checklist des écueils courants à vérifier :

1. Dépréciations : Certains packages ou modèles peuvent être dépréciés. Vérifier les flags de dépréciation dans chaque registre.
2. Changements de namespace : Les noms de packages ou d'organisations peuvent changer. Vérifier les redirections.
3. Versions masquées : Certaines versions peuvent être marquées comme masquées ou instables. Vérifier les flags de version.
4. Permissions : Certains dépôts ou packages peuvent être privés ou restreints. Vérifier l'accès.
5. Compatibilité : Vérifier la compatibilité entre les versions des dépendances.

Plateformes supportées

• Claude Code
• Cursor
• Codex
• Autres agents IA compatibles

Contribution

Les contributions sont les bienvenues ! Veuillez ouvrir une issue ou une pull request sur le dépôt GitHub.

Licence

Ce projet est sous licence MIT.