nodejs-version-setup

nodejs-version-setup

このリポジトリで Node.js コマンドを実行する前に、正しい Node.js ランタイムを設定して確認してください。

使用するタイミング

npm、pnpm、yarn、npx、ビルドスクリプト、テスト、リンター、ローカル CLI など、Node.js ツールを実行するすべてのタスクでこのスキルを使用してください。

手順

1. 次の順序で、必要な Node.js のバージョンを検出します。
   • .nvmrc
   • .node-version
   • package.json -> engines.node
2. 次の順序で、インストール済みのバージョンマネージャーを検出します。
   • nvm
   • fnm
   • asdf
   • volta
3. 最初に利用可能なマネージャーで、必要なバージョンを選択します。
   • nvm：nvm install と nvm use
   • fnm：fnm install と fnm use
   • asdf：asdf install nodejs <version> と asdf local nodejs <version>
   • volta：volta install node@<version>
4. バージョンファイルがなく、engines.node が存在する場合は、その範囲内の具体的なバージョンを特定し、検出したマネージャーでインストールして使用します。
5. マネージャーが利用できない場合は、現在の node -v が必要なバージョンを満たしているか確認します。満たしていない場合は、バージョンマネージャーをインストールするか、手動で続行するかをユーザーに確認するまで、作業を停止します。
6. プロジェクトのコマンドを実行する前に、ランタイムを確認します。
   • node -v
   • npm -v（プロジェクトに応じて pnpm -v または yarn -v）
   • which node でアクティブなバイナリのパスを確認
7. タスクの出力では、バージョンの指定元（例：.nvmrc）、使用したマネージャー、最終的な node -v を報告します。
8. バージョンの選択と確認が完了するまで、依存関係のインストール、ビルド、テスト、CLI スクリプトの実行は行わないでください。