mcpField
M
mastra-embedded-docs-look-up

mastra-embedded-docs-look-up

github.com/mastra-ai開発9965 回インストール1 日前に更新
リポジトリ

mastra-embedded-docs-look-up について

Mastraパッケージを使う開発者向けのドキュメント検索スキルです。インストール済み依存パッケージに含まれるエクスポート対応表、型定義、各機能の文書からAPI情報を調べ、導入済みバージョンに沿った確認を支援します。

主な機能

  1. 01インストール済みMastra文書の検索
  2. 02エクスポートから型定義ファイルへの対応付け
  3. 03APIシグネチャとJSDocの確認
  4. 04機能別ドキュメントの参照
  5. 05Shellコマンドによる検索

活用シーン

  1. 01導入済みMastra APIのシグネチャ確認
  2. 02パッケージのエクスポート元の定義調査
  3. 03エージェントやワークフローの文書検索
  4. 04導入済みパッケージ版に基づく説明の確認

インストール

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

$npx skills add https://github.com/mastra-ai/skills --skill mastra-embedded-docs-look-up

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

詳細

Mastra 埋め込みドキュメントの検索

node_modules/@mastra/*/dist/docs/ にある埋め込みドキュメントから API シグネチャを検索します。これらはインストール済みバージョンに一致します。

ドキュメントの構成

node_modules/@mastra/core/dist/docs/
├── SKILL.md           # Package overview, exports
├── SOURCE_MAP.json    # Export→file mappings
└── [topics]/          # Feature docs (agents/, workflows/, etc.)

検索手順

1. エクスポートを探します：

cat node_modules/@mastra/core/dist/docs/SOURCE_MAP.json | grep '"Agent"'

戻り値：{ "Agent": { "types": "dist/agent/agent.d.ts", ... } }

2. 型定義を読みます：

cat node_modules/@mastra/core/dist/agent/agent.d.ts

3. トピック別のドキュメントを確認します：

cat node_modules/@mastra/core/dist/docs/agents/01-overview.md

よく使うパッケージ

パッケージパス内容
@mastra/corenode_modules/@mastra/core/dist/docs/エージェント、ワークフロー、ツール
@mastra/memorynode_modules/@mastra/memory/dist/docs/メモリーシステム
@mastra/ragnode_modules/@mastra/rag/dist/docs/RAG 機能

クイックコマンド

# List installed packages
ls node_modules/@mastra/

# Find export in SOURCE_MAP
cat node_modules/@mastra/core/dist/docs/SOURCE_MAP.json | grep '"ExportName"'

# Read type definition
cat node_modules/@mastra/core/dist/[path-from-source-map]

# List available topics
ls node_modules/@mastra/core/dist/docs/

これを使用する理由

  • 埋め込みドキュメントはインストール済みバージョンに正確に一致します
  • Mastra は急速に進化しますが、インストール済みのドキュメントは常に同期されています
  • トレーニングデータは古くなっている可能性があります
  • 型定義には JSDoc と使用例が含まれています

コメント

Markdown 対応