nrwl/nx-ai-agents-config

link-workspace-packages

Identifier le paquet consommateur et son fournisseur pour déclarer la bonne dépendance de workspace.

Voir la source

Présentation détaillée

Ce Skill convient lorsqu’une application importe un paquet voisin du dépôt sans le déclarer correctement dans ses dépendances. Il commence par identifier le consommateur et le fournisseur. Un alias compris par l’éditeur ne prouve pas que l’installation ou l’exécution résoudra correctement le paquet.

La source propose des démarches pour npm, pnpm, Yarn et Bun. Le champ packageManager, le fichier de verrouillage et la configuration du workspace permettent de choisir. Dans l’exemple pnpm, --filter désigne le consommateur et --workspace impose un paquet local. Il faut ensuite examiner les modifications du manifeste et du verrouillage.

La vérification dépend du mode d’installation. Yarn PnP peut résoudre les dépendances avec .pnp.cjs sans node_modules : l’absence de lien symbolique n’indique donc pas nécessairement un échec. Si l’import échoue encore, vérifier exports, les artefacts attendus et les contrôles de types ou de compilation du projet.

Éléments à préparer

  • Noms et package.json du consommateur et du fournisseur, import en échec.
  • Gestionnaire, version, verrouillage et périmètre du workspace.

Résultats attendus

  • Dépendance déclarée dans le bon consommateur et état d’installation correspondant.
  • Résultat distinguant un problème de liaison d’un problème d’exports ou d’artefacts.

Marche à suivre

  1. Confirmer la relation d’import et la présence des deux paquets dans le workspace.
  2. Choisir la syntaxe du gestionnaire et de sa version réels.
  3. Ajouter la dépendance au consommateur et examiner les différences.
  4. Vérifier la résolution avec le linker actif puis les contrôles du projet.

Limites et vérifications

  • Un paquet homonyme du registre n’est pas forcément le fournisseur local.
  • Avec Yarn PnP, node_modules n’est pas un critère obligatoire.
  • Vérifier exports et les artefacts si la liaison ne suffit pas.
  • nx-import déplace le code et son historique ; nx-plugins ajoute une intégration Nx.

Questions fréquentes

Nx est-il nécessaire ?

La source examinée utilise les workspaces des gestionnaires et ne déclare pas Nx ou un serveur Nx MCP comme prérequis. Un agent compatible et le contexte du dépôt restent nécessaires.

La copie dans nrwl/nx apporte-t-elle une autre capacité ?

Aux deux révisions figées examinées, les répertoires du Skill sont identiques. Cette page décrit la distribution nx-ai-agents-config : choisir la source déjà utilisée plutôt qu’attendre une seconde capacité.

La procédure a-t-elle été exécutée ici ?

Non. Cette explication repose sur le Skill figé et les documentations officielles, sans test dans votre dépôt.

Installer ce Skill

Ajoutez ce Skill depuis sa source GitHub vérifiée avec la Skills CLI.

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

Informations sur la source

Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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

Tâches connexes

du même dépôt

Autres Skills

Tous les Skills
nrwl
Communauté

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

Installations totales
100,6 k
GitHub Stars
29
Mis à jour
20 nov.
nrwl
Communauté

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.

Installations / 1h
1
GitHub Stars
29
Mis à jour
20 nov.
nrwl
Communauté

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.

Installations / 1h
1
GitHub Stars
29
Mis à jour
20 nov.
nrwl
Communauté

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.

Installations / 1h
7
GitHub Stars
28
Mis à jour
7 oct.