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
- Importbeziehung und Zugehörigkeit beider Pakete zum Workspace klären.
- Syntax anhand des tatsächlichen Paketmanagers und seiner Version auswählen.
- Abhängigkeit beim Verbraucher ergänzen und die Änderungen kontrollieren.
- 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-packagesQuellenangaben
- 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
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→ 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



