nrwl/nx-ai-agents-config

link-workspace-packages

Der Skill ermittelt Verbraucher und Anbieter und deklariert deren Workspace-Abhängigkeit.

Quelltext ansehen

Einordnung

Dieser Skill passt, wenn eine Anwendung ein Nachbarpaket im Repository importiert, dessen Abhängigkeit aber nicht korrekt deklariert ist. Zuerst werden das konsumierende und das bereitstellende Paket bestimmt. Ein Pfadalias im Editor beweist noch nicht, dass Installation und Laufzeit das Paket richtig auflösen.

Die Quelle enthält Vorgehensweisen für npm, pnpm, Yarn und Bun. packageManager, Lockdatei und Workspace-Konfiguration bestimmen die passende Variante. Das pnpm-Beispiel wählt den Verbraucher mit --filter und fordert mit --workspace ein lokales Paket an. Anschließend sind Manifest- und Lockdateiänderungen zu prüfen.

Die Prüfung muss zum Installationsmodus passen: Yarn PnP kann über .pnp.cjs ohne node_modules auflösen. Ein fehlender Symlink ist dann kein Fehlerbeweis. Scheitert der Import trotz korrekter Abhängigkeit, bleiben exports und Build-Artefakte mögliche Ursachen. Entscheidend sind die vorhandenen Typ- oder Build-Prüfungen des betroffenen Projekts.

Benötigte Eingaben

  • Namen und package.json von Verbraucher und Anbieter sowie der fehlerhafte Import.
  • Paketmanager, Version, Lockdatei und Workspace-Grenzen.

Erwartete Ergebnisse

  • Eine Abhängigkeitsdeklaration im richtigen Verbraucher samt Installationszustand.
  • Ein Ergebnis, das Verknüpfungsfehler von Export- und Artefaktproblemen unterscheidet.

Vorgehensweise

  1. Importbeziehung und Zugehörigkeit beider Pakete zum Workspace klären.
  2. Syntax anhand des tatsächlichen Paketmanagers und seiner Version auswählen.
  3. Abhängigkeit beim Verbraucher ergänzen und die Änderungen kontrollieren.
  4. Auflösung mit dem aktiven Linker und anschließend Projektprüfungen ausführen.

Grenzen und Prüfungen

  • Ein gleichnamiges Registry-Paket ist nicht automatisch der lokale Anbieter.
  • Unter Yarn PnP ist node_modules kein Pflichtkriterium.
  • Bei verbleibenden Fehlern exports und Build-Ergebnisse prüfen.
  • nx-import verschiebt Code und Historie; nx-plugins ergänzt Nx-Integrationen.

Häufige Fragen

Ist Nx erforderlich?

Die geprüfte Anleitung nutzt Paketmanager-Workspaces und nennt weder Nx noch einen Nx-MCP-Server als Voraussetzung. Ein kompatibler Agent und Repository-Kontext werden dennoch benötigt.

Ist die Kopie in nrwl/nx eine andere Fähigkeit?

An den zwei geprüften Revisionen sind die Skill-Verzeichnisse identisch. Diese Seite behandelt die Verteilung über nx-ai-agents-config. Wählen Sie die bereits genutzte Quelle statt eine zusätzliche Fähigkeit anzunehmen.

Wurde der Ablauf hier ausgeführt?

Nein. Die Erklärung beruht auf dem festgelegten Skill und offiziellen Paketmanager-Dokumenten, nicht auf einem Test Ihres Repositorys.

Diesen Skill installieren

Füge diesen Skill mit der Skills CLI aus seiner verifizierten GitHub-Quelle hinzu.

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

Quellenangaben

Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

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

Verwandte Aufgaben

aus demselben Repository

Weitere Skills

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

Installationen gesamt
100.639
GitHub Stars
29
Aktualisiert
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.

Installationen / 1h
1
GitHub Stars
29
Aktualisiert
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.

Installationen / 1h
1
GitHub Stars
29
Aktualisiert
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.

Installationen / 1h
7
GitHub Stars
28
Aktualisiert
7. Okt.