AI Skill 大全

Mastra智能体应用开发与调试

接收 Mastra 业务需求或接口报错信息,依据最新嵌入文档与规范生成 TypeScript 智能体与工作流代码,并提供 CLI 链路追踪与排障方案。

功能与用途

本功能专门面向 Mastra TypeScript 全栈 AI 框架。针对该框架版本更迭快、易出现废弃 API 的特性,遵循严格的文档验证优先级(优先 node_modules 嵌入文档,次选类型定义与源码,最后拉取远程官方文档),杜绝过时代码。它能协助开发者正确创建 Agent、Workflow、Tool 与 Memory 模块,规范配置 provider/model-name 模型路由,并通过 mastra api 命令行对本地与远程实例进行状态检查、Trace 链路追踪与执行质量排查。

适用场景

  • 智能体与多步骤工作流构建:根据业务目标与输入输出要求,遵循 ES2022 规范与最新 API,编写包含工具调用、记忆持久化和步骤编排的 Mastra 代码。
  • 框架升级与类型报错修复:针对 Mastra 版本升级中出现的参数不匹配、类型丢失及模块导入异常,核对实际安装版本的类型定义并给出迁移改写方案。
  • Trace 链路追踪与健康度分析:运用 mastra api CLI 指令检索指定运行批次的 Trace、Span 与 Log,结合 Trace Intelligence 排查失败原因并优化提示词与工具定义。

适用人群

  • 使用 TypeScript 开发 LLM 应用的全栈开发者
  • 基于 Mastra 构建复杂 Agent 与 Workflow 的架构师
  • 需要对智能体执行链路与错误 Trace 进行分析定位的运维开发人员

使用步骤

  1. 检查本地项目是否已安装 `@mastra/*` 依赖并确认版本环境。
  2. 提出具体的智能体架构需求(如 Agent、Workflow、Tool、Memory)或粘贴当前编译报错与版本迁移诉求。
  3. 根据指示通过 provider-registry 脚本核验可用模型标识,获取符合最新 API 签名的 TypeScript 模块代码。
  4. 启动 npm run dev 打开 Mastra Studio 进行交互式调试,或使用 mastra api CLI 进行 Trace 链路监控与排障。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
AI工作流
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-23
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Comprehensive Mastra framework guide for building agents, workflows, tools, memory, workspaces, and storage with current APIs. Use for documentation lookup, API verification, TypeScript setup, common errors, migrations, and `mastra api` CLI tasks: inspect or call resources on local, Mastra platform, Trace Intelligence, or remote servers. For Mastra Factory operations, discover and activate the companion mastra-factory skill.

依赖与权限

  • 读取用户主动提供的内容

同类 Skill