NuGet Manager

概要

このスキルは、.NETプロジェクト全体で NuGet パッケージを一貫して安全に管理します。dotnet CLI の使用を優先してプロジェクトの整合性を維持し、バージョン更新時の厳密な検証と復元ワークフローを強制します。

前提条件

• .NET SDK がインストールされていること（通常は .NET 8.0 SDK 以降、またはターゲットソリューションと互換性のあるバージョン）
• dotnet CLI が PATH に登録されていること
• jq（JSON プロセッサ）または PowerShell（dotnet package search を使用したバージョン検証用）

コア ルール

1. パッケージを追加または削除するために、.csproj、.props、Directory.Packages.props ファイルを直接編集することは絶対禁止です。必ず dotnet add package と dotnet remove package コマンドを使用してください。
2. 直接編集は、既存パッケージのバージョン変更時のみ許可されます。
3. バージョン更新は必須のワークフローに従う必要があります：
   • ターゲットバージョンが NuGet に存在することを確認します。
   • バージョンがプロジェクトごと（.csproj）に管理されているか、中央集約（Directory.Packages.props）で管理されているかを判断します。
   • 該当ファイル内のバージョン文字列を更新します。
   • 互換性を検証するために直ちに dotnet restore を実行します。

ワークフロー

パッケージの追加

dotnet add [<PROJECT>] package <PACKAGE_NAME> [--version <VERSION>] を使用します。 例：dotnet add src/MyProject/MyProject.csproj package Newtonsoft.Json

パッケージの削除

dotnet remove [<PROJECT>] package <PACKAGE_NAME> を使用します。 例：dotnet remove src/MyProject/MyProject.csproj package Newtonsoft.Json

パッケージ バージョンの更新

バージョンを更新する場合は、以下の手順に従います：

1. バージョンの存在確認: 正確一致と JSON フォーマットを使用して dotnet package search コマンドでバージョンが存在するか確認します。 jq を使用する場合: dotnet package search <PACKAGE_NAME> --exact-match --format json | jq -e '.searchResult[].packages[] | select(.version == "<VERSION>")' PowerShell を使用する場合: (dotnet package search <PACKAGE_NAME> --exact-match --format json | ConvertFrom-Json).searchResult.packages | Where-Object { $_.version -eq "<VERSION>" }

2. バージョン管理方式の判定:

   • ソリューション ルート内の Directory.Packages.props を検索します。存在する場合は、<PackageVersion Include="Package.Name" Version="1.2.3" /> 経由でそこでバージョンを管理すべきです。
   • 存在しない場合は、個別の .csproj ファイルで <PackageReference Include="Package.Name" Version="1.2.3" /> を確認します。

3. 変更の適用: 特定されたファイルを新しいバージョン文字列で修正します。

4. 安定性の検証: プロジェクトまたはソリューションで dotnet restore を実行します。エラーが発生した場合は、変更を戻して調査します。

例

ユーザー：「WebApi プロジェクトに Serilog を追加してください」

実行内容: dotnet add src/WebApi/WebApi.csproj package Serilog を実行します。

ユーザー：「ソリューション全体で Newtonsoft.Json を 13.0.3 に更新してください」

実行内容:

1. 13.0.3 が存在するか確認：dotnet package search Newtonsoft.Json --exact-match --format json（出力をパースして「13.0.3」が存在することを確認）
2. 定義されている場所を検索（例：Directory.Packages.props）
3. ファイルを編集してバージョンを更新
4. dotnet restore を実行