Documentation

MCP Fusion/Operate and integrate/Skills

Skills

Demandez à l’IA à propos de Vinkius

SKILL.md est un contrat d’architecture exécutable que votre agent de codage IA suit : vous êtes l’architecte, l’agent écrit du code MVA et @mcpfusion/skills distribue les instructions progressivement.

MCP Fusion est livré avec un contrat d’architecture lisible par machine appelé SKILL.md. Il indique aux agents de codage IA à quoi ressemble un code MCP Fusion correct : chaque outil a besoin d’un Presenter avec .returns(), les champs sensibles ont besoin de .redactPII(), les outils proviennent de f.query, f.mutation et f.action. Vous êtes l’architecte. L’IA écrit le code, et le contrat le maintient dans le motif.

Ce que fait le scaffold

npx @mcpfusion/core create écrit le SKILL.md dans votre projet et l’injecte dans les fichiers de règles que vos agents lisent déjà :

  • .cursorrules pour Cursor
  • .windsurfrules pour Windsurf
  • .clinerules pour Cline

Ensuite, demander à votre agent "un outil qui liste les factures impayées" produit du code MVA : un builder, un Presenter, de la rédaction là où il faut, pas de JSON.stringify brut. Le contrat est explicite sur l’échec : tout outil dépourvu d’un Presenter avec .returns() est une sortie incorrecte, et l’agent se corrige.

Demandez à votre agent de lire le contrat avant d’écrire quoi que ce soit : ce n’est qu’un fichier, et il encode chaque convention de cette section de la documentation. Mettez-le à jour à mesure que les conventions de votre équipe évoluent.

Divulgation progressive avec @mcpfusion/skills

Entasser toute une architecture dans un prompt système gaspille du contexte et enterre les règles qui comptent pour la tâche en cours. @mcpfusion/skills distribue les instructions en trois couches :

  1. La couche contrat. Un résumé court, toujours chargé, des règles MVA.
  2. La couche recettes. Des instructions par tâche, chargées quand la tâche correspond : ajouter un outil, composer des Presenters, écrire des tests.
  3. La couche référence. La surface complète de l’API, chargée à la demande.

L’agent charge la couche deux uniquement quand il aborde cette tâche, et la couche trois uniquement quand il a besoin d’une signature exacte. Les longues sessions de codage gardent leur budget de contexte pour le code lui-même.

bash
npm install @mcpfusion/skills

Ce que le contrat impose

RèglePourquoi elle existe
Chaque outil attache un Presenter avec .returns()La couche de perception est le pare-feu de sortie
Les champs sensibles passent par .redactPII()La PII n’atteint jamais le modèle
Les outils proviennent de f.query, f.mutation, f.actionLes annotations MCP restent véridiques
Pas de réponses JSON.stringify brutesUne donnée non mise en forme est une donnée non relue
Les handlers renvoient Result pour les échecs attendusDes erreurs sur lesquelles l’agent peut agir

Prochaines étapes