nrwl/nx-ai-agents-config

link-workspace-packages

利用側と提供側を特定し、パッケージマネージャーに合った依存宣言を行う Skill。

ソースを見る

詳しい説明

同じリポジトリにある UI ライブラリなどをアプリが import しているのに、利用側に依存が正しく宣言されていない場合に向いています。まず利用するパッケージと提供するパッケージを特定します。エディターのパス別名で参照できても、実際のインストールや実行時の解決が正しいとは限りません。

原文には npm、pnpm、Yarn、Bun の手順があります。ルートの packageManager、ロックファイル、ワークスペース設定から使う方式を選びます。pnpm の例は --filter で利用側を指定し、--workspace でローカルパッケージを要求します。変更後は依存の追加先とロックファイルも確認が必要です。

検証はインストール方式に合わせます。Yarn PnP は node_modules がなくても .pnp.cjs で解決できます。依存を接続できても、exports やビルド成果物が原因で失敗することがあるため、対象の import、型チェックやビルドまで確認します。

用意するもの

  • 利用側・提供側の名前と package.json、失敗している import。
  • マネージャーとバージョン、ロックファイル、ワークスペース範囲。

得られるもの

  • 正しい利用側に置かれたローカル依存の宣言とインストール状態。
  • 依存接続と exports・成果物の問題を区別した検証結果。

使い方

  1. 両方のパッケージが対象ワークスペースに含まれるか調べる。
  2. 実際のマネージャーとバージョンに合う構文を選ぶ。
  3. 利用側へ依存を追加し、マニフェストとロックファイルの差分を確認する。
  4. 現在の 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

出典情報

リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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 → pnpm
  • yarn.lock → yarn
  • bun.lock / bun.lockb → bun
  • package-lock.json → npm

Workflow

  1. Identify consumer package (the one importing)
  2. Identify provider package(s) (being imported)
  3. Add dependency using package manager's workspace syntax
  4. Verify symlinks created in consumer's node_modules/

pnpm

Uses workspace: protocol - symlinks only created when explicitly declared.

bash
# From consumer directory
pnpm add @org/ui --workspace

# Or with --filter from anywhere
pnpm add @org/ui --filter @org/app --workspace

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:*" } }

yarn (v2+/berry)

Also uses workspace: protocol.

bash
yarn workspace @org/app add @org/ui

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:^" } }

npm

No workspace: protocol. npm auto-symlinks workspace packages.

bash
npm install @org/ui --workspace @org/app

Result in package.json:

json
{ "dependencies": { "@org/ui": "*" } }

npm resolves to local workspace automatically during install.


bun

Supports workspace: protocol (pnpm-compatible).

bash
cd packages/app && bun add @org/ui

Result in package.json:

json
{ "dependencies": { "@org/ui": "workspace:*" } }

Examples

Example 1: pnpm - link ui lib to app

bash
pnpm add @org/ui --filter @org/app --workspace

Example 2: npm - link multiple packages

bash
npm install @org/data-access @org/ui --workspace @org/dashboard

Example 3: Debug "Cannot find module"

  1. Check if dependency is declared in consumer's package.json
  2. If not, add it using appropriate command above
  3. 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.json should have "private": true to prevent accidental publish

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills
nrwl
コミュニティ

nx-workspace

Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'.

累計インストール
10.1万
GitHub Stars
29
更新日
11月20日
nrwl
コミュニティ

nx-import

Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository.

1時間の導入数
1
GitHub Stars
29
更新日
11月20日
nrwl
コミュニティ

nx-plugins

Find and add Nx plugins. USE WHEN user wants to discover available plugins, install a new plugin, or add support for a specific framework or technology to the workspace.

1時間の導入数
1
GitHub Stars
29
更新日
11月20日
nrwl
コミュニティ

nx-generate

Generate code using nx generators. INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure. Trigger words - scaffold, setup, create a new app, create a new lib, project structure, generate, add a new project. ALWAYS use this BEFORE calling nxdocs or exploring - this skill handles discovery internally.

1時間の導入数
7
GitHub Stars
28
更新日
10月7日