mastra
Construa Aplicações de IA com o Framework Mastra
Mastra é um framework TypeScript para construir agentes de IA e fluxos de trabalho. Esta skill fornece estratégias abrangentes de consulta à documentação e padrões de código para garantir que você use APIs atuais e evite erros comuns.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "mastra". Como eu configuro um novo projeto Mastra?
النتيجة المتوقعة:
Para configurar um novo projeto Mastra: 1) Execute `npm create mastra@latest` ou crie manualmente com `npm init`. 2) Configure TypeScript com módulos ES2022 (target: ES2022, module: ES2022, moduleResolution: bundler). 3) Adicione 'type: module' ao package.json. 4) Instale @mastra/core. Veja references/create-mastra.md para instruções completas de configuração.
استخدام "mastra". Qual é o padrão correto para criar um agente com ferramentas?
النتيجة المتوقعة:
O padrão correto: 1) Crie uma ferramenta com createTool(). 2) Registre-a na sua instância Mastra sob a configuração tools. 3) Passe as ferramentas para o construtor do seu Agent. Exemplo: `const agent = new Agent({ id: 'my-agent', tools: { myTool } })`. Veja references/common-errors.md para exemplos completos de código.
استخدام "mastra". Como eu consulto a documentação atual da API Mastra?
النتيجة المتوقعة:
Ordem de prioridade: 1) Verifique docs incorporados em node_modules/@mastra/*/dist/docs/ se os pacotes estiverem instalados. 2) Busque docs remotos de https://mastra.ai/llms.txt se os pacotes não estiverem instalados. 3) Use o SOURCE_MAP.json para encontrar definições exatas de tipo. Nunca confie em dados de treinamento - sempre verifique contra a documentação atual.
التدقيق الأمني
آمنThis 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.
الأنماط المكتشفة
درجة الجودة
ماذا يمكنك بناءه
Onboarding de Novos Desenvolvedores Mastra
Um desenvolvedor iniciando com Mastra usa esta skill para entender a prioridade de consulta à documentação (docs incorporados primeiro, depois remotos), configurar adequadamente o TypeScript e criar seu primeiro agente com ferramentas.
Depurando Erros de Tempo de Execução
Um desenvolvedor encontrando erros 'Property X does not exist on type Y' usa esta skill para identificar que seu conhecimento está desatualizado e aprender como consultar a API atual nos docs incorporados.
Construindo Fluxos de Trabalho de Múltiplas Etapas
Um desenvolvedor experiente usa esta skill para entender a diferença entre agentes (autônomos) e fluxos de trabalho (estruturados), e aprender o padrão correto para criar e executar fluxos de trabalho com .commit().
جرّب هذه الموجهات
Como eu configuro um novo projeto Mastra e crio meu primeiro agente com uma ferramenta simples?
Qual é a diferença entre um Agente e um Fluxo de Trabalho no Mastra, e quando devo usar cada um?
Estou recebendo erros 'Property X does not exist on type Y' no meu código Mastra. Como eu encontro a API correta?
Como eu configuro memória e armazenamento para meu agente para que ele lembre do histórico de conversas entre sessões?
أفضل الممارسات
- Sempre verifique o uso da API contra a documentação atual em vez de confiar em dados de treinamento
- Use docs incorporados (node_modules) como fonte primária quando os pacotes estiverem instalados
- Configure as configurações TypeScript ES2022 adequadas antes de escrever qualquer código Mastra
- Use threadId consistente para conversas de agentes para manter a memória entre sessões
تجنب
- Assumir que o conhecimento de dados de treinamento é atual - as APIs do Mastra mudam frequentemente
- Usar configuração de módulo CommonJS em vez de módulos ES2022
- Esquecer de chamar .commit() nos fluxos de trabalho, causando falha na execução
- Não registrar ferramentas na instância Mastra antes de atribuir aos agentes