pnpm について
JavaScript プロジェクトの依存関係やワークスペースを管理する pnpm のリファレンススキルです。v11・v12 の基本操作に加え、セキュリティやタスク管理、リリースも扱います。
主な機能
- 01依存関係のインストールと管理
- 02コンテンツアドレス可能なストア
- 03ワークスペースとフィルタリング
- 04設定、パッチ、上書きルール
- 05タスク管理とリリース
活用シーン
- 01pnpm のコマンドや設定の確認
- 02モノレポの依存関係管理
- 03CI でのロックファイル固定インストール
- 04複数プロジェクトのタスクとリリース管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/pnpmを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdreferences/best-practices-ci.mdbest-practices-migration.mdbest-practices-performance.mdcore-cli.mdcore-config.mdcore-store.mdcore-workspaces.mdfeatures-aliases.mdfeatures-catalogs.mdfeatures-config-dependencies.mdfeatures-global-virtual-store.mdfeatures-hooks.mdfeatures-multi-ecosystem.mdfeatures-overrides.mdfeatures-patches.mdfeatures-peer-deps.mdfeatures-supply-chain-security.mdfeatures-task-orchestration.mdfeatures-versioning.md詳細
pnpm は高速でディスク容量を効率的に使うパッケージマネージャーです。コンテンツアドレス方式のストアを使用して、マシン上のすべてのプロジェクト間でパッケージを重複排除し、デフォルトで依存関係を厳格に解決することで、ファントム依存関係を防ぎます。
pnpm v12 は v11 を Rust で書き直したものです。安定しており、v11 のコマンド、フラグ、設定、ロックファイル形式を維持しているため、ここに記載されているガイダンスのほとんどは両方に適用されます。v12 では一部の動作が異なります（Git 依存関係は HTTPS 経由で解決、プロジェクトを認識するグローバル bin、その他のパッケージマネージャー、Linux では packageImportMethod: auto が最初にハードリンクを使用、--resolution-only を削除）。詳細は best-practices-migration を参照してください。
設定モデル（重要）： pnpm の設定は、pnpm-workspace.yaml（およびグローバルな config.yaml）に camelCase のキーを使用して記述します。.npmrc は認証／レジストリの認証情報に のみ 使用され、package.json の pnpm フィールドは読み込まれなくなりました。pnpm プロジェクトで作業するときは、設定／ワークスペース構造については pnpm-workspace.yaml を、認証については .npmrc のみを確認してください。CI では常に --frozen-lockfile（または pnpm ci）を使用してください。
このスキルは pnpm 12.x に基づき、2026-09-25 に生成されました。現行ドキュメントで説明されている v11 と v12 の動作（設定の分離、分離されたグローバルパッケージ、
allowBuilds、pmOnFail、グローバル仮想ストア、ネイティブリリース管理、ワークスペースのタスクオーケストレーション、実験的な Python/Cargo サポート）を扱います。
コア
| トピック | 説明 | リファレンス |
|---|---|---|
| CLI コマンド | install/add/remove/update、run、dlx/pnx、workspace、runtime、公開（version、view、sbom、stage） | core-cli |
| 設定 | pnpm-workspace.yaml の設定（camelCase）、グローバル config.yaml、packageConfigs、.npmrc の認証 | core-config |
| ワークスペース | モノレポのサポート：フィルタリング、ワークスペースプロトコル、共有ロックファイル、packageConfigs | core-workspaces |
| ストア | コンテンツアドレス方式のストア、仮想ストア、Node リンカーモード、凍結／読み取り専用ストア | core-store |
機能
| トピック | 説明 | リファレンス |
|---|---|---|
| カタログ | 依存関係のバージョンを一元管理します。catalogMode、overrides 内の catalog: | features-catalogs |
| オーバーライド | バージョンを強制指定します（推移的依存関係とピア依存関係を含む）。packageExtensions | features-overrides |
| パッチ | サードパーティパッケージを変更します。pnpm-workspace.yaml 内の patchedDependencies | features-patches |
| エイリアス | 任意の名前（npm:）やレジストリエイリアス（namedRegistries）でインストールします | features-aliases |
| フック | .pnpmfile.mjs のフック（readPackage、updateConfig、beforePacking）、ファインダー、リゾルバー／フェッチャー | features-hooks |
| ピア依存関係 | 自動インストール、厳格モード、ルール、dedupePeers、ピア依存関係のチェック | features-peer-deps |
| 設定依存関係 | configDependencies を介して、リポジトリ間でフック／設定／カタログ／パッチを共有します | features-config-dependencies |
| グローバル仮想ストアとシム | 共有 node_modules、git-worktree を使ったマルチエージェント環境、分離されたグローバルパッケージ、プロジェクト対応の実行ファイル、その他のパッケージマネージャー | features-global-virtual-store |
| サプライチェーンセキュリティ | ビルドの承認（allowBuilds）、minimumReleaseAge、trustPolicy、ロックファイルの整合性 | features-supply-chain-security |
| タスクオーケストレーション | プロジェクト横断のタスクグラフ（tasks/dependsOn）、同時実行グループ、優先度、pnpm パイプライン | features-task-orchestration |
| リリース管理 | ネイティブのバージョン管理：pnpm change/version -r/lane、レーン、エピック、固定グループ | features-versioning |
| マルチエコシステム | npm に加えて、Python（pypi:）と Cargo（crate:）の依存関係に対応（実験的） | features-multi-ecosystem |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| CI/CD の設定 | GitHub Actions、GitLab、Docker、pnpm ci、ストアのキャッシュ、ロックファイルの固定 | best-practices-ci |
| 移行 | npm／Yarn から pnpm への移行、ファントム依存関係、pnpm v10 → v11 → v12 へのアップグレードに関する注意事項 | best-practices-migration |
| パフォーマンス | インストールの最適化、allowBuilds、グローバル仮想ストア、ワークスペースの並列化 | best-practices-performance |