詳しい説明
同じリポジトリにある UI ライブラリなどをアプリが import しているのに、利用側に依存が正しく宣言されていない場合に向いています。まず利用するパッケージと提供するパッケージを特定します。エディターのパス別名で参照できても、実際のインストールや実行時の解決が正しいとは限りません。
原文には npm、pnpm、Yarn、Bun の手順があります。ルートの packageManager、ロックファイル、ワークスペース設定から使う方式を選びます。pnpm の例は --filter で利用側を指定し、--workspace でローカルパッケージを要求します。変更後は依存の追加先とロックファイルも確認が必要です。
検証はインストール方式に合わせます。Yarn PnP は node_modules がなくても .pnp.cjs で解決できます。依存を接続できても、exports やビルド成果物が原因で失敗することがあるため、対象の import、型チェックやビルドまで確認します。
用意するもの
- 利用側・提供側の名前と package.json、失敗している import。
- マネージャーとバージョン、ロックファイル、ワークスペース範囲。
得られるもの
- 正しい利用側に置かれたローカル依存の宣言とインストール状態。
- 依存接続と exports・成果物の問題を区別した検証結果。
使い方
- 両方のパッケージが対象ワークスペースに含まれるか調べる。
- 実際のマネージャーとバージョンに合う構文を選ぶ。
- 利用側へ依存を追加し、マニフェストとロックファイルの差分を確認する。
- 現在の linker に合わせて解決を確認し、既存のプロジェクトチェックを実行する。
制約と確認事項
- 同名のレジストリパッケージをローカル提供元と取り違えない。
- Yarn PnP では node_modules の有無だけで判断しない。
- 接続後も失敗するなら exports と必要な成果物を確認する。
- コードと履歴の移動は nx-import、Nx 統合の追加は nx-plugins の役割。
よくある質問
Nx は必須ですか?
確認した原文はパッケージマネージャーのワークスペースを使用し、Nx や Nx MCP を前提としていません。対応するエージェントと対象リポジトリの情報は必要です。
nrwl/nx の同名 Skill は別の機能ですか?
確認した二つの固定リビジョンでは Skill ディレクトリが同一です。本ページは nx-ai-agents-config の配布元を扱います。既存設定に合う配布元を選び、別機能として重複導入しないでください。
実行による検証済みですか?
いいえ。固定版の Skill と公式資料を読んだ説明であり、利用者のリポジトリで動作確認した結果ではありません。
この Skill を導入
Skills CLI を使い、検証済みの GitHub ソースから追加します。
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packages出典情報
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/skills/link-workspace-packages/SKILL.md
- github.com/nrwl/nx-ai-agents-config/blob/13282936b5f6aa53e3d41ba589a4a2dc0d6f5786/README.md
- github.com/nrwl/nx/tree/d976a693f12e81402bcbd53d4b04f91974650c04/.agents/skills/link-workspace-packages
- pnpm.io/cli/add
- yarnpkg.com/features/pnp
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
Link Workspace Packages
Add dependencies between packages in a monorepo. All package managers support workspaces but with different syntax.
Detect Package Manager
Check whether there's a packageManager field in the root-level package.json.
Alternatively check lockfile in repo root:
pnpm-lock.yaml→ pnpmyarn.lock→ yarnbun.lock/bun.lockb→ bunpackage-lock.json→ npm
Workflow
- Identify consumer package (the one importing)
- Identify provider package(s) (being imported)
- Add dependency using package manager's workspace syntax
- Verify symlinks created in consumer's
node_modules/
pnpm
Uses workspace: protocol - symlinks only created when explicitly declared.
# From consumer directory
pnpm add @org/ui --workspace
# Or with --filter from anywhere
pnpm add @org/ui --filter @org/app --workspaceResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }yarn (v2+/berry)
Also uses workspace: protocol.
yarn workspace @org/app add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:^" } }npm
No workspace: protocol. npm auto-symlinks workspace packages.
npm install @org/ui --workspace @org/appResult in package.json:
{ "dependencies": { "@org/ui": "*" } }npm resolves to local workspace automatically during install.
bun
Supports workspace: protocol (pnpm-compatible).
cd packages/app && bun add @org/uiResult in package.json:
{ "dependencies": { "@org/ui": "workspace:*" } }Examples
Example 1: pnpm - link ui lib to app
pnpm add @org/ui --filter @org/app --workspaceExample 2: npm - link multiple packages
npm install @org/data-access @org/ui --workspace @org/dashboardExample 3: Debug "Cannot find module"
- Check if dependency is declared in consumer's
package.json - If not, add it using appropriate command above
- Run install (
pnpm install,npm install, etc.)
Notes
- Symlinks appear in
<consumer>/node_modules/@org/<package> - Hoisting differs by manager:
- npm/bun: hoist shared deps to root
node_modules - pnpm: no hoisting (strict isolation, prevents phantom deps)
- yarn berry: uses Plug'n'Play by default (no
node_modules) - Root
package.jsonshould have"private": trueto prevent accidental publish



