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
- Confermare il rapporto d’importazione e l’appartenenza dei pacchetti al workspace.
- Scegliere la sintassi del gestore e della versione effettivi.
- Aggiungere la dipendenza all’utilizzatore e controllare le differenze.
- 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-packagesInformazioni sulla fonte
- 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
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→ 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



