mastra
KI-Apps mit dem Mastra-Framework erstellen
Mastra ist ein TypeScript-Framework zum Erstellen von KI-Agenten und Workflows. Dieser Skill bietet umfassende Strategien zur Dokumentationsrecherche und Code-Muster, um sicherzustellen, dass Sie aktuelle APIs verwenden und häufige Fehler vermeiden.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "mastra". Wie richte ich ein neues Mastra-Projekt ein?
Résultat attendu:
Um ein neues Mastra-Projekt einzurichten: 1) Führen Sie `npm create mastra@latest` aus oder erstellen Sie es manuell mit `npm init`. 2) Konfigurieren Sie TypeScript mit ES2022-Modulen (target: ES2022, module: ES2022, moduleResolution: bundler). 3) Fügen Sie 'type: module' zur package.json hinzu. 4) Installieren Sie @mastra/core. Siehe references/create-mastra.md für vollständige Einrichtungsanweisungen.
Utilisation de "mastra". Was ist das korrekte Muster zum Erstellen eines Agenten mit Tools?
Résultat attendu:
Das korrekte Muster: 1) Erstellen Sie ein Tool mit createTool(). 2) Registrieren Sie es in Ihrer Mastra-Instanz unter der tools-Konfiguration. 3) Übergeben Sie Tools an Ihren Agent-Konstruktor. Beispiel: `const agent = new Agent({ id: 'my-agent', tools: { myTool } })`. Siehe references/common-errors.md für vollständige Code-Beispiele.
Utilisation de "mastra". Wie schlage ich die aktuelle Mastra-API-Dokumentation nach?
Résultat attendu:
Prioritätsreihenfolge: 1) Prüfen Sie eingebettete Docs in node_modules/@mastra/*/dist/docs/, wenn Pakete installiert sind. 2) Laden Sie Remote-Docs von https://mastra.ai/llms.txt, wenn Pakete nicht installiert sind. 3) Verwenden Sie die SOURCE_MAP.json, um exakte Typ-Definitionen zu finden. Verlassen Sie sich niemals auf Trainingsdaten - verifizieren Sie immer gegen aktuelle Docs.
Audit de sécurité
SûrThis is a documentation/reference skill providing guidance on the Mastra framework. All static findings are false positives: (1) Backtick patterns are markdown code block delimiters in documentation, not shell commands. (2) Hardcoded URLs are legitimate documentation links. (3) Environment variable patterns are code examples showing configuration. (4) Cryptographic references are documentation content. No actual security risks present.
Motifs détectés
Score de qualité
Ce que vous pouvez construire
Onboarding für neue Mastra-Entwickler
Ein Entwickler, der mit Mastra beginnt, nutzt diesen Skill, um die Priorität der Dokumentationssuche zu verstehen (zuerst eingebettete Docs, dann Remote), die richtige TypeScript-Konfiguration einzurichten und seinen ersten Agenten mit Tools zu erstellen.
Runtime-Fehler debuggen
Ein Entwickler, der auf Fehler wie 'Property X does not exist on type Y' stößt, nutzt diesen Skill, um zu erkennen, dass sein Wissen veraltet ist, und zu lernen, wie man die aktuelle API in eingebetteten Docs nachschlägt.
Mehrstufige Workflows erstellen
Ein erfahrener Entwickler nutzt diesen Skill, um den Unterschied zwischen Agenten (autonom) und Workflows (strukturiert) zu verstehen und das korrekte Muster zum Erstellen und Ausführen von Workflows mit .commit() zu lernen.
Essayez ces prompts
Wie richte ich ein neues Mastra-Projekt ein und erstelle meinen ersten Agenten mit einem einfachen Tool?
Was ist der Unterschied zwischen einem Agenten und einem Workflow in Mastra, und wann sollte ich welchen verwenden?
Ich erhalte Fehler wie 'Property X does not exist on type Y' in meinem Mastra-Code. Wie finde ich die korrekte API?
Wie richte ich Speicher und Storage für meinen Agenten ein, damit er sich an den Gesprächsverlauf über mehrere Sitzungen hinweg erinnert?
Bonnes pratiques
- API-Verwendung immer gegen aktuelle Dokumentation verifizieren, anstatt sich auf Trainingsdaten zu verlassen
- Eingebettete Docs (node_modules) als primäre Quelle verwenden, wenn Pakete installiert sind
- Richtige ES2022-TypeScript-Einstellungen konfigurieren, bevor Mastra-Code geschrieben wird
- Konsistente threadId für Agenten-Gespräche verwenden, um Speicher über mehrere Sitzungen hinweg zu erhalten
Éviter
- Annahme, dass Trainingsdaten-Wissen aktuell ist - Mastra-APIs ändern sich häufig
- Verwendung von CommonJS-Modulkonfiguration anstelle von ES2022-Modulen
- Vergessen, .commit() auf Workflows aufzurufen, was zu Ausführungsfehlern führt
- Tools nicht in der Mastra-Instanz registrieren, bevor sie Agenten zugewiesen werden