Szczegółowy opis
Ten Skill przydaje się, gdy aplikacja importuje sąsiedni pakiet repozytorium, ale nie deklaruje go prawidłowo jako zależności. Punktem wyjścia jest rozróżnienie odbiorcy i dostawcy pakietu. Alias działający w edytorze nie dowodzi poprawnej instalacji ani rozwiązywania importu w czasie wykonania.
Źródło podaje procedury dla npm, pnpm, Yarn i Bun. Wybór zależy od packageManager, pliku blokady i konfiguracji workspace. Przykład pnpm wskazuje odbiorcę przez --filter i wymaga lokalnego pakietu przez --workspace. Następnie należy sprawdzić zmiany manifestu oraz pliku blokady.
Weryfikacja zależy od trybu instalacji. Yarn PnP może korzystać z .pnp.cjs bez node_modules, więc brak dowiązania nie musi oznaczać błędu. Jeśli import nadal zawodzi, trzeba sprawdzić exports, wymagane artefakty oraz dotychczasowe testy typów lub budowanie projektu.
Co przygotować
- Nazwy i package.json odbiorcy i dostawcy oraz błędny import.
- Menedżer, wersja, plik blokady i zakres workspace.
Oczekiwane wyniki
- Deklaracja zależności we właściwym pakiecie i odpowiadający jej stan instalacji.
- Wynik rozróżniający problem połączenia, exports i artefaktów.
Sposób użycia
- Ustalić relację importu i obecność obu pakietów w workspace.
- Wybrać składnię właściwego menedżera i wersji.
- Dodać zależność do odbiorcy i przejrzeć różnice.
- Sprawdzić rozwiązywanie przy aktywnym linkerze oraz kontrole projektu.
Ograniczenia i kontrola
- Pakiet z rejestru o tej samej nazwie nie musi być lokalnym dostawcą.
- W Yarn PnP node_modules nie jest warunkiem powodzenia.
- Przy dalszych błędach sprawdzić exports i wyniki budowania.
- nx-import przenosi kod i historię, a nx-plugins dodaje integracje Nx.
Częste pytania
Czy wymagany jest Nx?
Przejrzane instrukcje używają workspace menedżerów pakietów i nie wymagają Nx ani serwera Nx MCP. Nadal potrzebny jest zgodny agent i kontekst repozytorium.
Czy kopia w nrwl/nx ma inne możliwości?
W dwóch sprawdzonych rewizjach katalogi Skill są identyczne. Ta strona opisuje dystrybucję nx-ai-agents-config; należy wybrać dotychczasowe źródło, zamiast oczekiwać dodatkowej funkcji.
Czy wykonano tu tę procedurę?
Nie. Opis opiera się na przypiętym Skill i oficjalnej dokumentacji, a nie na próbie w Twoim repozytorium.
Zainstaluj ten Skill
Dodaj Skill z jego zweryfikowanego źródła GitHub za pomocą Skills CLI.
npx skills add https://github.com/nrwl/nx-ai-agents-config --skill link-workspace-packagesInformacje o źródle
- 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
Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.
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



