nrwl/nx-ai-agents-config

link-workspace-packages

Ustala pakiet korzystający z zależności i jej dostawcę, aby poprawić deklarację w workspace.

Zobacz źródło

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

  1. Ustalić relację importu i obecność obu pakietów w workspace.
  2. Wybrać składnię właściwego menedżera i wersji.
  3. Dodać zależność do odbiorcy i przejrzeć różnice.
  4. 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-packages

Informacje o źródle

Oryginalny dokument Skill

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 → 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

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
nrwl
Społeczność

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

Instalacje łącznie
100,6 tys.
GitHub Stars
29
Aktualizacja
20 lis
nrwl
Społeczność

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.

Instalacje / 1h
1
GitHub Stars
29
Aktualizacja
20 lis
nrwl
Społeczność

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.

Instalacje / 1h
1
GitHub Stars
29
Aktualizacja
20 lis
nrwl
Społeczność

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.

Instalacje / 1h
7
GitHub Stars
28
Aktualizacja
7 paź