mcpField
M
mastra

mastra

github.com/pedronauckエージェントワークフロー647239 回インストール2 週間前に更新
リポジトリ

mastra について

Mastra の AI アプリ開発を支援するスキルです。エージェントやワークフローを書く前に、インストール済みの版または最新のドキュメントで API を確認する手順を示します。

主な機能

  1. 01版に合った埋め込みドキュメントの検索
  2. 02リモートドキュメントの参照
  3. 03ソースコードと型定義の確認
  4. 04一般的なエラーと移行の案内
  5. 05エージェントとワークフローの開発手順

活用シーン

  1. 01インストール済み Mastra の API 確認
  2. 02Mastra パッケージがない場合の最新情報の検索
  3. 03型やコンストラクターのエラー調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pedronauck/skills --skill mastra

インストール後、Claude Code で/mastraを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
common-errors.md
create-mastra.md
embedded-docs.md
migration-guide.md
remote-docs.md

詳細

Mastra フレームワークガイド

Mastra で AI アプリケーションを構築します。このスキルでは、最新のドキュメントを見つけて、エージェントとワークフローを構築する方法を説明します。

⚠️ 重要：内部知識を信用しないでください

Mastra について知っていることは、古くなっているか、誤っている可能性が高いです。記憶に頼らず、必ず最新のドキュメントで確認してください。

学習データには、古い API、非推奨のパターン、誤った使用方法が含まれています。Mastra は急速に進化しており、バージョン間で API が変更されたり、コンストラクターのシグネチャが変わったり、パターンがリファクタリングされたりします。

前提条件

Mastra のコードを書く前に、パッケージがインストールされているか確認してください。

ls node_modules/@mastra/
  • パッケージがある場合： まず埋め込みドキュメントを使用します（最も信頼性が高い方法です）
  • パッケージがない場合： 先にインストールするか、リモートドキュメントを使用します

ドキュメント参照ガイド

クイックリファレンス
ユーザーの質問最初に確認するもの方法
「Mastra プロジェクトを作成／インストールする」references/create-mastra.mdCLI と手動の手順を含むセットアップガイド
「Agent／Workflow／Tool の使い方は？」references/embedded-docs.mdnode_modules/@mastra/*/dist/docs/ で確認する
「X の使い方は？」（パッケージなし）references/remote-docs.mdhttps://mastra.ai/llms.txt から取得する
「エラーが発生します…」references/common-errors.mdよくあるエラーと解決策
「v0.x から v1.x にアップグレードする」references/migration-guide.mdバージョンアップグレードのワークフロー
コードを書く際の優先順位

⚠️ 最新のドキュメントを確認せずにコードを書かないでください。

  1. まず埋め込みドキュメントを確認（パッケージがインストールされている場合）

    パッケージの最新ドキュメントを node_modules で確認します。@mastra/core の「Agent」ドキュメントを確認する例：

    grep -r "Agent" node_modules/@mastra/core/dist/docs/references
    • 理由： インストールされているバージョンに完全に一致します
    • 最も信頼できる情報源
    • 参照先： references/embedded-docs.md

  2. 次にソースコードを確認（パッケージがインストールされている場合）

    埋め込みドキュメントで必要な情報が見つからない場合は、ソースコードを直接確認してください。時間はかかりますが、実装の詳細を把握できます。

    # Check what's available
cat node_modules/@mastra/core/dist/docs/assets/SOURCE_MAP.json | grep '"Agent"'

# Read the actual type definition
cat node_modules/@mastra/core/dist/[path-from-source-map]
    • 理由： ドキュメントが見つからない場合や不明瞭な場合の、最終的な情報源です
    • 利用する場面： 埋め込みドキュメントに質問への答えがない場合
    • 参照先： references/embedded-docs.md

  3. 最後にリモートドキュメントを確認（パッケージがインストールされていない場合）

    Mastra のウェブサイトから最新のドキュメントを取得できます。

    https://mastra.ai/llms.txt
    • 理由： 公開済みの最新ドキュメントです（インストール済みのバージョンより新しい可能性があります）
    • 利用する場面： パッケージがインストールされていない場合や、新機能を調べる場合
    • 参照先： references/remote-docs.md

主な概念

エージェントとワークフローの違い

エージェント：自律的に判断し、ツールを使用します
用途：自由度の高いタスク（サポート、調査、分析）

ワークフロー：構造化された一連のステップです
用途：定義済みのプロセス（パイプライン、承認、ETL）

主なコンポーネント
  • ツール： エージェントの機能を拡張します（API、データベース、外部サービス）
  • メモリ： コンテキストを維持します（メッセージ履歴、作業メモリ、セマンティック想起）
  • RAG： 外部の知識を検索します（ベクトルストア、グラフの関係性）
  • ストレージ： データを永続化します（Postgres、LibSQL、MongoDB）

重要な要件

TypeScript の設定

Mastra には ES2022 モジュールが必要です。CommonJS では動作しません。

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ES2022",
    "moduleResolution": "bundler"
  }
}
モデルの形式

必ず "provider/model-name" を使用してください。

  • "openai/gpt-5.2"
  • "anthropic/claude-sonnet-4-5"
  • "google/gemini-2.5-pro"

エラーが発生した場合

型エラーは、知識が古くなっていることを示す場合がよくあります。

知識が古くなっている場合によく見られる兆候：

  • Property X does not exist on type Y
  • Cannot find module
  • Type mismatch エラー
  • コンストラクターのパラメーターエラー

対処方法：

  1. references/common-errors.mdを確認します
  2. 埋め込みドキュメントで最新の API を確認します
  3. エラーをユーザーの間違いだと決めつけないでください。知識が古くなっている可能性があります

開発ワークフロー

コードを書く前に、必ず確認してください：

  1. インストール済みのパッケージを確認します

    ls node_modules/@mastra/

  2. 最新の API を調べます

  3. 最新のドキュメントに基づいてコードを書きます

  4. Studio でテストします

    npm run dev  # http://localhost:4111

リソース

コメント

Markdown 対応