mastra

Mastra 技能旨在协助开发者使用 Mastra 框架构建 AI 应用程序，并作为权威的技术参考资源。为了降低使用过时训练数据的风险，本技能严格执行“验证优先”的方法，确保所有代码产出均基于本地环境中安装的 Mastra 版本。它专为软件工程师、AI 架构师及需要将基于 LLM 的代理、复杂工作流程、RAG 系统与记忆模块整合至 TypeScript 生态系统中的开发人员所设计。通过提供依赖项检查、内置文档导览与远程 API 同步等整合工具，此技能可作为 Mastra 项目开发的控制中心，涵盖项目架构规划、常见类型错误排除及框架版本迁移。

• 使用本地 node_modules 检索功能进行实时文档验证，确保代码与当前安装版本兼容。

• 提供构建自主代理 (Agents)、流程导向工作流程 (Workflows) 及工具整合的结构化指南。

• 针对 TypeScript 设置（ES2022/Module 要求）与运行时错误提供进阶调试支持。

• 通过标准化注册脚本，管理各提供者的 LLM 模型路由设置。

• 支持 Mastra Studio 环境安装，实现交互式测试与性能监控。

• 提供版本迁移协助，管理核心组件的重大变更与升级。

• 在生成代码前，务必执行本地搜索指令，以避免对构造子特征产生错误认知。

• 在实现模型路由字符串前，使用提供的供应商注册脚本验证可用模型。

• 请确保 TSConfig 配置符合指定的 ES2022 模块解析设置，以防止导入或模块失败。

• 对于 API 表层与类型定义，应优先参考内置文档而非外部知识库。

• 输入：使用者对于代理行为、工作流程逻辑或 RAG 架构的需求。输出：针对当前 Mastra 版本优化的验证代码片段、架构模式与故障排除步骤。