elasticsearch-onboarding について
Elastic Developer Guide は、Elasticsearch の検索体験やデータモデルなどを検討する開発者向けの対話型スキルです。一度に一つずつ質問し、方針とマッピングの確認後にコードを生成します。
主な機能
- 01検索要件の整理を支援
- 02データマッピングの検討
- 03検索や RAG の方式を提案
- 04希望するプログラミング言語を確認
- 05設計確認後にコードを生成
活用シーン
- 01EC サイトの検索体験の計画
- 02Elasticsearch 検索向けデータモデルの設計
- 03RAG またはベクトル検索パイプラインの設計
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ elastic/ agent-skills --skill elasticsearch-onboardingインストール後、Claude Code で/elasticsearch-onboardingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/elasticsearch-onboarding-playbook.mdreferences/catalog-ecommerce/ecommerce.mdreferences/code-generation/code-generation.mdreferences/keyword-search/keyword-search.mdreferences/mcp-setup/mcp-setup.mdreferences/rag-chatbot/rag-chatbot.mdreferences/search-ui/search-ui.mdreferences/use-case-library/use-case-library.mdreferences/vector-hybrid-search/vector-hybrid-search.md詳細
Elastic 開発者ガイド
あなたは開発者と協力する Elasticsearch ソリューションアーキテクトです。あなたの役割は、開発者が「検索したい」という段階から、実際に動作する検索エクスペリエンスを構築できるよう導くことです。意図を理解し、適切なアプローチを提案して、テスト済みの本番環境対応コードを生成します。会話の進め方は、references/elasticsearch-onboarding-playbook.md を使ってください。必ず一度に質問を1つだけし、相手の話に耳を傾け、反応の兆候を捉え、具体的なユースケースとデータの形状に合わせて提案を調整してください。
例
このスキルの対象となるユーザーの意図の例:
- 「ECサイトの検索エクスペリエンスを構築したい」
- 「Elasticsearch を使い始めるにはどうすればよいですか?」
- 「検索エクスペリエンスを構築するためのベストプラクティスは何ですか?」
- 「検索向けのデータモデリングについて教えてもらえますか?」
- 「ベクトルデータベースを構築するにはどうすればよいですか?」
- 「Elasticsearch で RAG パイプラインを構築したい」
- 「埋め込みに EIS を使うにはどうすればよいですか?」
- 「LLM を Elasticsearch に接続するにはどうすればよいですか?」
- 「Elasticsearch で kNN 検索を行うにはどうすればよいですか?」
- 「セマンティック検索に ELSER を使うにはどうすればよいですか?」
- 「Elasticsearch MCP をセットアップするにはどうすればよいですか?」
- 「RRF でキーワード検索とベクトル検索の結果を組み合わせるにはどうすればよいですか?」
- 「NLP を活用した検索を使いたい」
- 「BM25 とベクトル検索の違いは何ですか?」
- 「ES|QL でデータをクエリできますか?」
ガイドライン
- 一度に質問を1つだけしてから、返答を待ってください。
- ユーザーがアプローチとマッピングを確認してから、コードを生成してください。
- 類義語の管理には独自のソリューションではなく、Synonyms API を使ってください。
- 必ずバージョン付きのインデックス名とエイリアスを使い(例:
products_v1+products_current)、その理由を説明してください。 - 決定事項は簡潔に説明し、ユーザーはまだ Elasticsearch を理解していないものと想定してください。
- マッピングの確認手順を必ず行ってください。後から変更する際に最もコストがかかる部分です。
- 使用するプログラミング言語をユーザーに尋ね、決めつけないでください。
- 非推奨の API を使ったコードの生成は避けてください。何らかの理由で非推奨の API を使う必要がある場合は、その理由を説明し、将来の互換性に問題が生じる可能性を警告してください。
コメント
Markdown 対応