pnpm について
pnpm プロジェクトを扱うコーディングエージェント向けの pnpm 10.x ガイドです。コマンド、設定、ワークスペース、ストア、運用上の指針を扱います。
主な機能
- 01インストールとパッケージ操作コマンド
- 02ワークスペースと設定のガイダンス
- 03コンテンツアドレス指定型ストア
- 04カタログ、上書き、パッチ
- 05依存関係と CI のベストプラクティス
活用シーン
- 01変更前にワークスペース設定を確認
- 02パッケージ作業に使う pnpm コマンドを選択
- 03モノレポの依存関係を設定
- 04ロックファイル固定の CI インストールを設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ christopher-buss/ skills --skill pnpmインストール後、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-hooks.mdfeatures-overrides.mdfeatures-patches.mdfeatures-peer-deps.md詳細
pnpm は高速で、ディスク容量を効率的に使うパッケージマネージャーです。コンテンツアドレス可能なストアを使って、マシン上のすべてのプロジェクト間でパッケージを重複排除し、ディスク容量を大幅に節約します。pnpm はデフォルトで依存関係の解決を厳格に行い、ファントム依存関係を防ぎます。pnpm 固有の設定は、できるだけ pnpm-workspace.yaml に記述してください。
重要: pnpm プロジェクトを扱う際、エージェントは pnpm-workspace.yaml ファイルと .npmrc ファイルを確認して、ワークスペース構成と設定を把握してください。CI 環境では、必ず --frozen-lockfile を使用してください。
このスキルは pnpm 10.x を基にしており、2026-01-28 に生成されました。
基本
| トピック | 説明 | 参照 |
|---|---|---|
| CLI コマンド | インストール、追加、削除、更新、実行、exec、dlx、ワークスペースの各コマンド | core-cli |
| 設定 | pnpm-workspace.yaml、.npmrc の設定、package.json のフィールド | core-config |
| ワークスペース | フィルタリング、ワークスペースプロトコル、共有ロックファイルによるモノレポのサポート | core-workspaces |
| ストア | コンテンツアドレス可能なストレージ、ハードリンク、ディスク効率 | core-store |
機能
| トピック | 説明 | 参照 |
|---|---|---|
| カタログ | ワークスペースの依存関係バージョンを一元管理 | features-catalogs |
| オーバーライド | 推移的な依存関係を含む、特定の依存関係のバージョンを強制 | features-overrides |
| パッチ | 独自の修正を加えてサードパーティパッケージを変更 | features-patches |
| エイリアス | npm: プロトコルを使って任意の名前でパッケージをインストール | features-aliases |
| フック | .pnpmfile.cjs フックで解決方法をカスタマイズ | features-hooks |
| ピア依存関係 | 自動インストール、厳格モード、依存関係のルール | features-peer-deps |
ベストプラクティス
| トピック | 説明 | 参照 |
|---|---|---|
| CI/CD の設定 | GitHub Actions、GitLab CI、Docker、キャッシュ戦略 | best-practices-ci |
| 移行 | npm/Yarn からの移行、ファントム依存関係への対処、モノレポの移行 | best-practices-migration |
| パフォーマンス | インストールの最適化、ストアのキャッシュ、ワークスペースの並列化 | best-practices-performance |
コメント
Markdown 対応