deps-dev について
deps-dev は deps.dev API でパッケージ情報を調べるスキルです。バージョンの選択と解析を案内し、推測による決定を避けます。
主な機能
- 01パッケージのバージョン情報取得
- 02デフォルト指定のバージョン選択
- 03非推奨フィールドの確認
- 04エコシステム別パッケージ名の正規化
- 05大きな JSON レスポンスの処理
活用シーン
- 01API が指定するパッケージバージョンの確認
- 02選択したバージョンの非推奨状態の確認
- 03長いバージョン一覧の安全な解析
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ itechmeat/ llm-code --skill deps-devインストール後、Claude Code で/deps-devを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api.mdlarge-responses.mdlatest-version.mdnaming-and-encoding.mdsources.md詳細
deps.dev(スキルルーター)
このファイルは意図的に入門用として作成されています。
必要な内容に応じて、references/ の適切なノートを開いてください。
まずはこちら(簡単に)
- 既知のパッケージの最新/デフォルトバージョンが必要ですか?こちらをお読みください:
references/latest-version.md。 - 大量のバージョン一覧や、途中で切り詰められたレスポンスを扱っていますか?こちらをお読みください:
references/large-responses.md。 - エコシステムごとのパッケージ名の形式や正規化方法が不明ですか?こちらをお読みください:
references/naming-and-encoding.md。 - 非推奨フラグ(
isDeprecated/deprecatedReason)、PyPI のprojectStatus、または解決済みの NuGet/Maven 要件など、解析するエンドポイントの形式やフィールドが必要ですか?こちらをお読みください:references/api.md。
基本手順(1 リクエスト)
目的:{system, packageName} が与えられた場合に、デフォルト/最新バージョンを返します。
- GetPackage を呼び出します:
GET https://api.deps.dev/v3/systems/{SYSTEM}/packages/{PACKAGE} versions[]を解析し、isDefault=trueの項目を選択します。
すべてのバージョンで isDefault が指定されていない場合は、推測せずに処理を停止し、明示的な選択ルール(例:プレリリースを含めるかどうか)を尋ねてください。
isDefault があるからといって、そのバージョンを安全に推奨できるとは限りません。推奨する前に、そのバージョンの isDeprecated/deprecatedReason も確認してください(references/api.md を参照)。
重要な禁止事項
- 文字列の並べ替えで「最新」バージョンを推測しないでください。
- プレースホルダーや「概算」のバージョンを出力しないでください。必ず API のデータを待ってください。
- 大きな JSON を
grepや手作業での切り詰めによって解析しないでください。JSON パーサー(jq/Python/Node)を使用してください。 isDefaultがない場合に、黙って別の方法に切り替えないでください。希望するルールを尋ねてください。- ドキュメントの長い文章をそのまま貼り付けないでください。要約してください。
- 認証やレート制限があると決めつけないでください。根拠がない限り、指定されていないものとして扱ってください。
リンク
コメント
Markdown 対応