nrwl/nx-ai-agents-config

link-workspace-packages

Identifica o pacote consumidor e o fornecedor para declarar a dependência do workspace.

Ver código-fonte

Explicação detalhada

Este Skill é útil quando uma aplicação importa um pacote vizinho do repositório sem declarar corretamente a dependência. Primeiro identifica quem consome e quem fornece o pacote. Um alias reconhecido pelo editor não comprova que a instalação ou a execução resolva o pacote corretamente.

A fonte apresenta procedimentos para npm, pnpm, Yarn e Bun. packageManager, arquivo de lock e configuração do workspace orientam a escolha. No exemplo de pnpm, --filter seleciona o consumidor e --workspace exige um pacote local. As alterações no manifesto e no lock precisam ser revisadas depois.

A verificação depende do modo de instalação. Yarn PnP pode resolver dependências com .pnp.cjs sem node_modules; a ausência de um link simbólico não comprova falha. Se o import continuar quebrado, confira exports, artefatos necessários e as verificações de tipos ou build do projeto.

O que preparar

  • Nomes e package.json do consumidor e do fornecedor, além do import com falha.
  • Gerenciador, versão, lock e limites do workspace.

Resultados esperados

  • Dependência declarada no consumidor correto e estado correspondente da instalação.
  • Resultado que separa problemas de conexão, exports e artefatos.

Como usar

  1. Confirmar a relação de importação e a presença dos dois pacotes no workspace.
  2. Escolher a sintaxe do gerenciador e da versão em uso.
  3. Adicionar a dependência ao consumidor e revisar as diferenças.
  4. Verificar a resolução com o linker ativo e executar os controles existentes do projeto.

Limites e verificações

  • Um pacote homônimo no registro não é necessariamente o fornecedor local.
  • Com Yarn PnP, node_modules não é requisito de sucesso.
  • Confira exports e resultados de build se a conexão não resolver tudo.
  • nx-import move código e histórico; nx-plugins adiciona integrações do Nx.

Perguntas frequentes

Nx é obrigatório?

As instruções revisadas usam workspaces de gerenciadores e não exigem Nx nem servidor Nx MCP. Ainda são necessários um agente compatível e o contexto do repositório.

A cópia em nrwl/nx oferece outra capacidade?

Nas duas revisões fixadas, os diretórios do Skill são idênticos. Esta página trata da distribuição nx-ai-agents-config; escolha a fonte já usada sem esperar uma segunda capacidade.

O procedimento foi executado aqui?

Não. A explicação se baseia no Skill fixado e na documentação oficial, não em um teste no seu repositório.

Instalar este Skill

Adicione o Skill de sua fonte verificada no GitHub usando a Skills CLI.

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

Informações da fonte

Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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

Relacionados por tarefa

do mesmo repositório

Mais Skills

Todos os Skills
nrwl
Comunidade

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

Instalações totais
100,6 mil
GitHub Stars
29
Atualizado
20 de nov.
nrwl
Comunidade

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.

Instalações / 1h
1
GitHub Stars
29
Atualizado
20 de nov.
nrwl
Comunidade

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.

Instalações / 1h
1
GitHub Stars
29
Atualizado
20 de nov.
nrwl
Comunidade

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.

Instalações / 1h
7
GitHub Stars
28
Atualizado
7 de out.