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 を使用します：

   検索 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、description）を抽出します
   • 座標を標準的な Maven 形式で整形します：groupId:artifactId:version
   • 結果を明確で構造化された形式で提示します
   • 関連する場合はダウンロードリンクとメタデータを含めます

7. 座標を検証します：

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

出力形式の要件：

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

Maven Central Repository の構造

リポジトリのベース URL

• プライマリ：https://repo1.maven.org/maven2/
• 検索 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