菜单
Complete guide for Mastra development — agents, tools, workflows, vertical organization, and type safety
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Always use Turborepo commands for building, testing, and serving projects in this monorepo
Always use Turborepo commands for building, testing, and serving projects in this monorepo
Always fix issues you encounter, even if unrelated to your current task
Essential clean code practices including naming, comments, and structure
Commit message format standards using Conventional Commits specification
Use GitHub MCP tools for all repository operations instead of CLI or API calls
| name | mastra-development |
| description | Complete guide for Mastra development — agents, tools, workflows, vertical organization, and type safety |
This skill covers all conventions for building with Mastra in the Hey Jarvis project. Always use the factory patterns — never import from Mastra's core packages directly.
createAgent() factory, file structure, naming conventions, registration stepscreateTool() factory, critical naming rules, export pattern, input/output schemascreateWorkflow(), agent-as-step, tool-as-step, state managementsatisfies| What | Factory | Import from |
|---|---|---|
| Agent | createAgent() | ../../utils/agent-factory |
| Tool | createTool() | ../../utils/tool-factory |
| Workflow | createWorkflow() | ../../utils/workflow-factory |
| Step | createStep() | ../../utils/workflow-factory |
| Agent step | createAgentStep() | ../../utils/workflow-factory |
| Tool step | createToolStep() | ../../utils/workflow-factory |
mastra/verticals/[vertical-name]/
├── agent.ts # or agents.ts for multiple
├── tools.ts
├── workflows.ts
└── index.ts
as) to fix type errors after version bumps@mastra/core/* directly — always use factories