nrwl/nx-ai-agents-config

link-workspace-packages

Individua pacchetto utilizzatore e fornitore per dichiarare la dipendenza nel workspace.

Vedi sorgente

Descrizione dettagliata

Questa skill è adatta quando un’applicazione importa un pacchetto vicino nel repository senza dichiararne correttamente la dipendenza. Parte dal rapporto tra utilizzatore e fornitore. Un alias riconosciuto dall’editor non dimostra che installazione ed esecuzione risolvano correttamente il pacchetto.

La fonte propone procedure per npm, pnpm, Yarn e Bun. packageManager, file di lock e configurazione del workspace guidano la scelta. L’esempio pnpm seleziona l’utilizzatore con --filter e richiede un pacchetto locale con --workspace. Vanno poi controllate le modifiche al manifesto e al lock.

La verifica dipende dalla modalità d’installazione. Yarn PnP può usare .pnp.cjs senza node_modules: l’assenza di un collegamento simbolico non prova un errore. Se l’import continua a fallire, controllare exports, artefatti necessari e verifiche di tipi o build del progetto.

Cosa preparare

  • Nomi e package.json di utilizzatore e fornitore, import non risolto.
  • Gestore, versione, lock e ambito del workspace.

Risultati attesi

  • Dipendenza dichiarata nell’utilizzatore corretto e relativo stato d’installazione.
  • Verifica che distingua collegamento, exports e artefatti.

Procedura

  1. Confermare il rapporto d’importazione e l’appartenenza dei pacchetti al workspace.
  2. Scegliere la sintassi del gestore e della versione effettivi.
  3. Aggiungere la dipendenza all’utilizzatore e controllare le differenze.
  4. Verificare la risoluzione con il linker attivo e i controlli esistenti del progetto.

Limiti e verifiche

  • Un omonimo nel registro non è necessariamente il fornitore locale.
  • Con Yarn PnP, node_modules non è un requisito di riuscita.
  • Controllare exports e artefatti se il collegamento non basta.
  • nx-import sposta codice e cronologia; nx-plugins aggiunge integrazioni Nx.

Domande frequenti

Serve Nx?

Le istruzioni esaminate usano i workspace dei gestori e non richiedono Nx né un server Nx MCP. Servono comunque un agente compatibile e il contesto del repository.

La copia in nrwl/nx offre un’altra capacità?

Alle due revisioni fissate, le directory della skill sono identiche. Questa pagina tratta nx-ai-agents-config: scegliere la distribuzione già usata senza aspettarsi una capacità aggiuntiva.

La procedura è stata eseguita qui?

No. La spiegazione deriva dalla skill fissata e dalla documentazione ufficiale, non da una prova nel tuo repository.

Installa questo Skill

Aggiungi lo Skill dalla fonte GitHub verificata con la Skills CLI.

npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packages

Informazioni sulla fonte

Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

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

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
nrwl
Community

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'.

Installazioni totali
100,6K
GitHub Stars
29
Aggiornato
20 nov
nrwl
Community

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.

Installazioni / 1h
1
GitHub Stars
29
Aggiornato
20 nov
nrwl
Community

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.

Installazioni / 1h
1
GitHub Stars
29
Aggiornato
20 nov
nrwl
Community

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.

Installazioni / 1h
7
GitHub Stars
28
Aggiornato
7 ott