maven-search

このスキルを使用する場面

ユーザーが次の内容に言及した場合は、必ずこのスキルを使用してください。

• Maven の依存関係やコンポーネントを検索する
• Maven 座標（groupId、artifactId、version）を調べる
• コンポーネントのバージョンやバージョン履歴を確認する
• Maven アーティファクト（JAR、POM、ソース、Javadoc）を取得する
• Maven 依存関係の座標を検証する
• 依存関係ツリーや推移的依存関係を分析する
• Maven Central Repository を利用する
• Maven のコンポーネント、ライブラリ、依存関係に関するあらゆるリクエスト

トリガーとなる語句には、次のものがあります。

• 「查找 Maven 依赖」（Maven の依存関係を探す）、「搜索 Maven 组件」（Maven コンポーネントを検索する）
• 「Maven 坐标」（Maven 座標）、「groupId」（groupId）、「artifactId」（artifactId）
• 「Maven 版本」（Maven のバージョン）、「最新版本」（最新バージョン）、「版本历史」（バージョン履歴）
• 「Maven Central」（Maven Central）、「Maven 仓库」（Maven リポジトリ）
• 「下载 Maven 依赖」（Maven の依存関係をダウンロードする）、「获取 POM 文件」（POM ファイルを取得する）
• 「依赖树」（依存関係ツリー）、「传递依赖」（推移的依存関係）
• 「Maven」、「dependency」、「artifact」、「repository」、「coordinates」への言及全般

このスキルの使用方法

重要：ユーザーが Maven Central Repository の Maven コンポーネントを検索、取得、または操作する必要がある場合は、このスキルを必ず呼び出してください。

次の場合にこのスキルを呼び出してください：

• ユーザーが「Maven の依存関係を探して」「Maven コンポーネントを検索して」と言った場合
• ユーザーが Maven の座標（groupId、artifactId、version）を必要としている場合
• ユーザーがコンポーネントのバージョンを確認、またはアーティファクトを取得したい場合
• ユーザーが Maven Central Repository または Maven の依存関係に言及した場合
• ユーザーが依存関係の分析または座標の検証を必要としている場合

Maven コンポーネントを検索するには：

1. ユーザーのリクエストから検索の種類を特定します：

   • 名前で検索 → Maven Central Search API を使用します
   • 特定のバージョンを取得 → 直接リポジトリ URL を使用します
   • 最新バージョンを確認 → maven-metadata.xml を照会します
   • 依存関係を分析 → POM ファイルを解析します
   • アーティファクトをダウンロード → 直接ダウンロード URL を使用します

2. examples/ ディレクトリから適切なサンプルファイルを読み込みます：

   • examples/search-by-name.md - 名前またはキーワードでコンポーネントを検索
   • examples/search-by-coordinates.md - groupId と artifactId で検索
   • examples/get-version-info.md - バージョン情報と履歴を取得
   • examples/download-artifact.md - JAR、POM、ソース、または Javadoc をダウンロード
   • examples/analyze-dependencies.md - 依存関係ツリーを分析
   • examples/verify-coordinates.md - Maven 座標の有効性を検証

3. API エンドポイント、パラメーター、ベストプラクティスについて、そのサンプルファイルの具体的な指示に従います

4. Maven Central Repository API を使用します：

   Search API（https://search.maven.org/solrsearch/select）：

   • クエリパラメーター：q - 検索クエリ（例：g:com.google.guava AND a:guava）
   • Rows パラメーター：rows - 結果の件数（デフォルト：20、最大：200）
   • Start パラメーター：start - ページネーションのオフセット
   • Core パラメーター：core - 検索コア（デフォルト：gav）

   直接リポジトリアクセス（https://repo1.maven.org/maven2/）：

   • パス形式：{groupId}/{artifactId}/{version}/{artifactId}-{version}.{extension}
   • GroupId のパス：ドットをスラッシュに置き換えます（例：com.google.guava → com/google/guava）
   • メタデータ：バージョン情報には maven-metadata.xml
   • POM ファイル：{artifactId}-{version}.pom
   • JAR ファイル：{artifactId}-{version}.jar
   • ソース：{artifactId}-{version}-sources.jar
   • Javadoc：{artifactId}-{version}-javadoc.jar

5. 適切な URL を組み立てます：

   検索例：

   https://search.maven.org/solrsearch/select?q=g:com.google.guava+AND+a:guava&rows=20&wt=json
   

   直接アクセスの例：

   https://repo1.maven.org/maven2/com/google/guava/guava/maven-metadata.xml
   https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.pom
   https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.jar
   

6. 結果を解析して整形します：

   • 関連情報（groupId、artifactId、version、説明）を抽出します
   • 標準的な Maven 形式 groupId:artifactId:version で座標を整形します
   • 明確で構造化された形式で結果を提示します
   • 関連する場合はダウンロードリンクとメタデータを含めます

7. 座標を検証します：

   • groupId の形式を確認します（逆ドメイン表記である必要があります）
   • artifactId の形式を確認します（小文字で、ハイフン区切りである必要があります）
   • version の形式を検証します（セマンティックバージョニングが望ましいです）
   • ダウンロードリンクを提示する前に、アーティファクトの存在を確認します

出力形式の要件：

• Maven 座標は常に標準形式 groupId:artifactId:version で提示します
• 関連する場合は直接ダウンロード URL を含めます
• 検索結果は明確で構造化された表またはリストに整形します
• 入手可能な場合はメタデータ情報（説明、リポジトリ、最終更新日）を提示します
• バージョンを照会する場合は、バージョン情報とリリース日を含めます

Maven Central Repository の構造

リポジトリのベース URL

• プライマリ：https://repo1.maven.org/maven2/
• Search API：https://search.maven.org/solrsearch/select
• 代替ミラー：地域ごとに利用できます

パス構造

{groupId}/{artifactId}/{version}/{artifactId}-{version}.{extension}

例：

com/google/guava/guava/33.0.0/guava-33.0.0.jar

利用可能なアーティファクト

• POM: {artifactId}-{version}.pom - Project Object Model ファイル
• JAR: {artifactId}-{version}.jar - コンパイル済み Java クラス
• Sources: {artifactId}-{version}-sources.jar - ソースコード
• Javadoc: {artifactId}-{version}-javadoc.jar - API ドキュメント
• Metadata: maven-metadata.xml - バージョンおよびリリース情報

Search API のパラメータ

クエリ構文

• GroupId 検索: g:com.google.guava
• ArtifactId 検索: a:guava
• バージョン検索: v:33.0.0
• 複合検索: g:com.google.guava AND a:guava
• テキスト検索: guava (groupId、artifactId、description を検索します)

レスポンス形式

• JSON: wt=json (デフォルト)
• XML: wt=xml
• Java properties: wt=javabin

ページネーション

• rows: 1 ページあたりの結果数 (デフォルト: 20、最大: 200)
• start: ページネーションのオフセット (デフォルト: 0)

ベストプラクティス

1. 常に座標を検証する: 使用する前に groupId、artifactId、version が存在することを確認します
2. 最新の安定版を使用する: SNAPSHOT バージョンよりも RELEASE バージョンを優先します
3. バージョンメタデータを確認する: 最新バージョン情報を取得するために maven-metadata.xml をクエリします
4. ダウンロード前に検証する: ダウンロードリンクを提供する前にアーティファクトが存在することを確認します
5. チェックサムを含める: 利用可能な場合は、検証用に SHA-1 および MD5 チェックサムを提供します
6. 座標を正しくフォーマットする: 常に標準の Maven 形式 groupId:artifactId:version を使用します
7. コンテキストを提供する: 利用可能な場合は、description、リポジトリ情報、最終更新日を含めます

一般的なタスク

タスク 1: 名前で検索

テキストクエリで Search API を使用して、名前またはキーワードでコンポーネントを検索します。

例:

GET https://search.maven.org/solrsearch/select?q=guava&rows=20&wt=json

タスク 2: 座標で検索

groupId と artifactId で Search API を使用して、特定のコンポーネントを検索します。

例:

GET https://search.maven.org/solrsearch/select?q=g:com.google.guava+AND+a:guava&rows=20&wt=json

タスク 3: バージョン情報を取得

maven-metadata.xml をクエリして、利用可能なすべてのバージョンと最新バージョンを取得します。

例:

GET https://repo1.maven.org/maven2/com/google/guava/guava/maven-metadata.xml

タスク 4: アーティファクトをダウンロード

特定のアーティファクトの直接ダウンロード URL を構築します。

例:

GET https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.jar

タスク 5: 依存関係を分析

POM ファイルをダウンロードして解析し、依存関係情報を抽出します。

例:

GET https://repo1.maven.org/maven2/com/google/guava/guava/33.0.0/guava-33.0.0.pom

キーワード

英語キーワード: maven, maven central, maven repository, maven dependency, maven artifact, maven component, groupId, artifactId, version, coordinates, pom, jar, dependency, repository, search, retrieve, download, metadata, transitive dependencies, dependency tree, maven coordinates, maven search

中国語キーワード (中文关键词): Maven, Maven 中央仓库, Maven 仓库, Maven 依赖, Maven 组件, Maven 坐标, groupId, artifactId, version, 版本, 坐标, POM, JAR, 依赖, 仓库, 搜索, 检索, 下载, 元数据, 传递依赖, 依赖树, 查找依赖, 搜索组件, 获取版本, 下载依赖

リソース

• Maven Central Repository: https://repo1.maven.org/maven2/
• Maven Central Search: https://search.maven.org/
• Maven Central Search API Documentation: https://central.sonatype.com/search-api/
• Maven Coordinates Guide: https://maven.apache.org/guides/mini/guide-naming-conventions.html