majiayu000 ライブラリ API 検索スキル
Context7 API を利用し、プロジェクトで使用しているバージョンに対応したドキュメントとコードスニペットを検索・取得します。
ワークフロー
進捗に合わせてチェックを入れてください： ステップ1、2は並列で実行します。 ステップ1、2がどちらも成功したらステップ3、4を並列で実行します。
ライブラリAPI検索の進捗:
- [ ] ステップ1: 対象のライブラリのバージョンを取得する
- [ ] ステップ2: ドキュメントを利用可能なライブラリを検索
- [ ] ステップ3: 対象のライブラリのスニペットを取得する
- [ ] ステップ4: 対象のライブラリのドキュメントを取得する
ステップ1: 対象のライブラリのバージョンを取得する
プロンプトとしてバージョンが指定されている場合
バージョンが明示されていればそのバージョンを採用する
プロンプトとしてバージョンが指定されていない場合
パッケージマネージャーの設定ファイルからバージョンを取得する
eg: 16.1.0
- package.json
- pnpm-workspace.yaml
バージョンが取得できなかった場合
「バージョンが取得できなかったため、ドキュメントの取得ができませんでした」と出力し処理を終了する
ステップ2: ドキュメントを利用可能なライブラリを検索する
ライブラリの検索 API を使用し、ライブラリを検索します。 レスポンスからマッチするライブラリの id（/owner/repo）と versions を取得します。
curl "https://context7.com/api/v2/search?query=ライブラリ名" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
eg: curl "https://context7.com/api/v2/search?query=next.js" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
エラーハンドリング
- ライブラリが見つからない場合: 「指定されたライブラリ '{ライブラリ名}' は Context7 に登録されていません」と出力し処理を終了する
- API エラーの場合: エラー内容を出力し、1回リトライする。リトライも失敗した場合は処理を終了する
ステップ3: 対象のライブラリのスニペットを取得する
スニペットの取得 API を用いてスニペットを取得します。 ステップ2で取得した id と versions をもとリクエストを行います。 versions は以下の優先順位でマッチングする：
- 完全一致（例: v16.1.0 = v16.1.0）
- 同一 major.minor で最新 patch（例: v16.1.x）
- 同一 major で最新 minor（例: v16.x.x）
- 利用可能な最新版（フォールバック）
調べたいトピックの数だけリクエストを行います
curl "https://context7.com/api/v2/docs/code/owner/repo/version?topic=keyword" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
eg: curl "https://context7.com/api/v2/docs/code/vercel/next.js/v16.1.0?topic=Link" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
エラーハンドリング
- スニペットが見つからない場合: ステップ4のドキュメント取得結果のみを返す（スニペットなしで続行）
- API エラーの場合: エラー内容を出力し、1回リトライする。リトライも失敗した場合はスニペットなしで続行
ステップ4: 対象のライブラリのドキュメントを取得する
ドキュメントの取得 API を用いて調べたいトピックのドキュメントを取得します。 ステップ2で取得した id と、ステップ3と同じバージョンを使用してリクエストを行います。 調べたいトピックの数だけリクエストを行います
curl "https://context7.com/api/v2/docs/info/owner/repo/version?topic=keyword" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
eg: curl "https://context7.com/api/v2/docs/info/vercel/next.js/v16.1.0?topic=Link" -H "Authorization: Bearer ${CONTEXT7_API_KEY}"
エラーハンドリング
- ドキュメントが見つからない場合: ステップ3のスニペット取得結果のみを返す（ドキュメントなしで続行）
- API エラーの場合: エラー内容を出力し、1回リトライする。リトライも失敗した場合はドキュメントなしで続行
- ステップ3,4両方失敗した場合: 「ライブラリ '{ライブラリ名}' の情報を取得できませんでした」と出力し処理を終了する