用途：该技能用于 Mastra 框架的使用与更新指南，聚焦 API 验证、文档检索和版本迁移。设计原则类内容归属 mastra-ai-architecture-rules（编辑禁止），本指南只回答“如何跟随最新规格使用”。核心警示：不要信任内部知识，训练数据中的 Mastra API 可能已过期或错误，写代码前必须对照当前文档。
前置检查：先确认是否已安装包，命令为 ls node_modules/@mastra/。已安装则优先使用内嵌文档（node_modules/@mastra/*/dist/docs/），最可靠且与已安装版本一致；先定位 SOURCE_MAP.json（版本间位置可能变化），例如 cat node_modules/@mastra/core/dist/docs/assets/SOURCE_MAP.json | grep '"Agent"'，再读取对应类型定义。未安装则使用远程文档 https://mastra.ai/llms.txt，或先安装。
主要能力：按用户问题分派参考文档，包括创建/安装项目（references/create-mastra.md）、Agent/Workflow/Tool 用法（references/embedded-docs.md）、无包时查远程文档（references/remote-docs.md）、报错排查（references/common-errors.md）、v0.x 升级 v1.x（references/migration-guide.md）。
核心概念：Agent 自主决策、使用工具，适合开放式任务；Workflow 是结构化步骤序列，适合固定流程如管道、审批、ETL。组件包括 Tools（扩展能力）、Memory（上下文）、RAG（外部知识）、Storage（持久化）。
必要要求：TypeScript 需 ES2022 模块，CommonJS 会失败（target/module 设为 ES2022，moduleResolution 为 bundler）。模型格式始终为 "provider/model-name"，示例 ID 会过时，须以现行文档为准。
使用方式：检查已装包→查找当前 API→依据当前文档写代码→在 Studio 测试（pnpm dev，http://localhost:4111）。出现类型错误常说明知识过时，应查 common-errors 并核对内嵌文档。其他事实暂未提供。