Dokumentation

MCP Fusion/Operate and integrate/Skills

Skills

Frag die KI über Vinkius

SKILL.md ist ein ausführbarer Architekturvertrag, dem Ihr KI-Coding-Agent folgt: Sie sind der Architekt, der Agent schreibt MVA-Code und @mcpfusion/skills verteilt die Anweisungen progressiv.

MCP Fusion liefert einen maschinenlesbaren Architekturvertrag namens SKILL.md mit. Er sagt KI-Coding-Agenten, wie korrekter MCP Fusion Code aussieht: jedes Tool braucht einen Presenter mit .returns(), sensible Felder brauchen .redactPII(), Tools stammen aus f.query, f.mutation und f.action. Sie sind der Architekt. Die KI schreibt den Code, und der Vertrag hält ihn im Muster.

Was das Scaffold tut

npx @mcpfusion/core create schreibt die SKILL.md in Ihr Projekt und injiziert sie in die Regeldateien, die Ihre Agenten bereits lesen:

  • .cursorrules für Cursor
  • .windsurfrules für Windsurf
  • .clinerules für Cline

Von da an erzeugt die Bitte an Ihren Agenten um "ein Tool, das unbezahlte Rechnungen auflistet" MVA-Code: einen Builder, einen Presenter, Redaction wo nötig, kein rohes JSON.stringify. Der Vertrag ist beim Scheitern explizit: jedes Tool ohne Presenter mit .returns() ist falsche Ausgabe, und der Agent korrigiert sich selbst.

Bitten Sie Ihren Agenten, den Vertrag zu lesen, bevor er irgendetwas schreibt: es ist eine einzige Datei, und sie kodiert jede Konvention aus diesem Abschnitt der Dokumentation. Aktualisieren Sie sie, wenn sich die Konventionen Ihres Teams weiterentwickeln.

Progressive Offenlegung mit @mcpfusion/skills

Eine ganze Architektur in einen Systemprompt zu stopfen verschwendet Kontext und begräbt die Regeln, die für die jeweilige Aufgabe zählen. @mcpfusion/skills verteilt die Anweisungen auf drei Ebenen:

  1. Die Vertragsebene. Eine kurze, immer geladene Zusammenfassung der MVA-Regeln.
  2. Die Rezeptebene. Anweisungen pro Aufgabe, geladen wenn die Aufgabe passt: ein Tool hinzufügen, Presenter kombinieren, Tests schreiben.
  3. Die Referenzebene. Die vollständige API-Oberfläche, bei Bedarf geladen.

Der Agent lädt Ebene zwei nur, wenn er diese Aufgabe anfasst, und Ebene drei nur, wenn er eine exakte Signatur braucht. Lange Coding-Sessions reservieren ihr Kontextbudget für den Code selbst.

bash
npm install @mcpfusion/skills

Was der Vertrag durchsetzt

RegelWarum es sie gibt
Jedes Tool hängt einen Presenter mit .returns() anDie Perzeptionsschicht ist die Egress-Firewall
Sensible Felder laufen durch .redactPII()PII erreicht das Modell nie
Tools stammen aus f.query, f.mutation, f.actionMCP-Annotationen bleiben wahrheitsgemäß
Keine rohen JSON.stringify-AntwortenUngeformte Daten sind ungeprüfte Daten
Handler geben Result für erwartete Fehler zurückFehler, auf die der Agent reagieren kann

Nächste Schritte