Nx Workspace

作者 nrwl40b723ccaa3a無授權條款收錄於 2026年10月8日更新於 2026年10月8日

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

僅含說明Software Development
AI 產生的概覽

以唯讀方式探索 Nx 工作區：列出專案、檢視設定、目標與相依關係。

功能
引導代理以唯讀方式使用 nx 命令列檢查 Nx 工作區。內容涵蓋列出與篩選專案、取得解析後的專案設定與目標、讀取工作區層級的 nx.json 設定，以及查詢專案圖以了解相依關係。也包含任務設定缺失與工作區不同步的疑難排解步驟，並附上一份關於受影響專案的參考文件。
適用情境
當需要回答 Nx 工作區中有哪些專案、目標或相依關係，或某個專案如何設定時使用。也適用於 nx 指令執行失敗，或在執行任務前需要確認可用目標的情況。
執行需求
需要一個 Nx 工作區並可使用 nx 命令列（可能需透過 npx、pnpx 或 yarn 呼叫），以及 jq 等本機工具來處理 JSON 輸出。僅為說明文件，不附帶指令碼。

Nx Workspace Exploration

This skill provides read-only exploration of Nx workspaces. Use it to understand workspace structure, project configuration, available targets, and dependencies.

Keep in mind that you might have to prefix commands with npx/pnpx/yarn if nx isn't installed globally. Check the lockfile to determine the package manager in use.

Listing Projects

Use nx show projects to list projects in the workspace.

The project filtering syntax (-p/--projects) works across many Nx commands including nx run-many, nx release, nx show projects, and more. Filters support explicit names, glob patterns, tag references (e.g. tag:name), directories, and negation (e.g. !project-name).

bash
# List all projectsnx show projects
# Filter by pattern (glob)nx show projects --projects "apps/*"nx show projects --projects "shared-*"
# Filter by tagnx show projects --projects "tag:publishable"nx show projects -p 'tag:publishable,!tag:internal'
# Filter by target (projects that have a specific target)nx show projects --withTarget build
# Combine filtersnx show projects --type lib --withTarget testnx show projects --affected --exclude="*-e2e"nx show projects -p "tag:scope:client,packages/*"
# Negate patternsnx show projects -p '!tag:private'nx show projects -p '!*-e2e'
# Output as JSONnx show projects --json

Project Configuration

Use nx show project <name> --json to get the full resolved configuration for a project.

Important: Do NOT read project.json directly - it only contains partial configuration. The nx show project --json command returns the full resolved config including inferred targets from plugins.

You can read the full project schema at node_modules/nx/schemas/project-schema.json to understand nx project configuration options.

bash
# Get full project configurationnx show project my-app --json
# Extract specific parts from the JSONnx show project my-app --json | jq '.targets'nx show project my-app --json | jq '.targets.build'nx show project my-app --json | jq '.targets | keys'
# Check project metadatanx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}'

Target Information

Targets define what tasks can be run on a project.

bash
# List all targets for a projectnx show project my-app --json | jq '.targets | keys'
# Get full target configurationnx show project my-app --json | jq '.targets.build'
# Check target executor/commandnx show project my-app --json | jq '.targets.build.executor'nx show project my-app --json | jq '.targets.build.command'
# View target optionsnx show project my-app --json | jq '.targets.build.options'
# Check target inputs/outputs (for caching)nx show project my-app --json | jq '.targets.build.inputs'nx show project my-app --json | jq '.targets.build.outputs'
# Find projects with a specific targetnx show projects --withTarget servenx show projects --withTarget e2e

Workspace Configuration

Read nx.json directly for workspace-level configuration. You can read the full project schema at node_modules/nx/schemas/nx-schema.json to understand nx project configuration options.

bash
# Read the full nx.jsoncat nx.json
# Or use jq for specific sectionscat nx.json | jq '.targetDefaults'cat nx.json | jq '.namedInputs'cat nx.json | jq '.plugins'cat nx.json | jq '.generators'

Key nx.json sections:

  • targetDefaults - Default configuration applied to all targets of a given name
  • namedInputs - Reusable input definitions for caching
  • plugins - Nx plugins and their configuration
  • ...and much more, read the schema or nx.json for details

Affected Projects

If the user is asking about affected projects, read the affected projects reference [blocked] for detailed commands and examples.

Common Exploration Patterns

"What's in this workspace?"

bash
nx show projectsnx show projects --type appnx show projects --type lib

"How do I build/test/lint project X?"

bash
nx show project X --json | jq '.targets | keys'nx show project X --json | jq '.targets.build'

"What depends on library Y?"

bash
# Use the project graph to find dependentsnx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "Y") | .key'

Programmatic Answers

When processing nx CLI results, use command-line tools to compute the answer programmatically rather than counting or parsing output manually. Always use --json flags to get structured output that can be processed with jq, grep, or other tools you have installed locally.

Listing Projects

bash
nx show projects --json

Example output:

json
["my-app", "my-app-e2e", "shared-ui", "shared-utils", "api"]

Common operations:

bash
# Count projectsnx show projects --json | jq 'length'
# Filter by patternnx show projects --json | jq '.[] | select(startswith("shared-"))'
# Get affected projects as arraynx show projects --affected --json | jq '.'

Project Details

bash
nx show project my-app --json

Example output:

json
{  "root": "apps/my-app",  "name": "my-app",  "sourceRoot": "apps/my-app/src",  "projectType": "application",  "tags": ["type:app", "scope:client"],  "targets": {    "build": {      "command": "vite build",      "options": { "cwd": "apps/my-app" }    },    "serve": {      "command": "vite",      "options": { "cwd": "apps/my-app" }    },    "test": {      "command": "vitest",      "options": { "cwd": "apps/my-app" }    }  },  "implicitDependencies": []}

Common operations:

bash
# Get target namesnx show project my-app --json | jq '.targets | keys'
# Get specific target confignx show project my-app --json | jq '.targets.build'
# Get tagsnx show project my-app --json | jq '.tags'
# Get project rootnx show project my-app --json | jq -r '.root'

Project Graph

bash
nx graph --print

Example output:

json
{  "graph": {    "nodes": {      "my-app": {        "name": "my-app",        "type": "app",        "data": { "root": "apps/my-app", "tags": ["type:app"] }      },      "shared-ui": {        "name": "shared-ui",        "type": "lib",        "data": { "root": "libs/shared-ui", "tags": ["type:ui"] }      }    },    "dependencies": {      "my-app": [        { "source": "my-app", "target": "shared-ui", "type": "static" }      ],      "shared-ui": []    }  }}

Common operations:

bash
# Get all project names from graphnx graph --print | jq '.graph.nodes | keys'
# Find dependencies of a projectnx graph --print | jq '.graph.dependencies["my-app"]'
# Find projects that depend on a librarynx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "shared-ui") | .key'

Troubleshooting

"Cannot find configuration for task X:target"

bash
# Check what targets exist on the projectnx show project X --json | jq '.targets | keys'
# Check if any projects have that targetnx show projects --withTarget target

"The workspace is out of sync"

bash
nx syncnx reset  # if sync doesn't fix stale cache

來源與署名

來源：nrwl/nx-ai-agents-config位於skills/nx-workspace提交40b723c

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 nrwl/nx-ai-agents-config 的技能

Nx Generate

nrwl

指導代理使用 Nx 產生器在單體儲存庫中建立專案、函式庫與樣板程式碼。

Software Development2026年10月8日

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Dpop Adoption

google

精選

指導為 Google OAuth 平台實作 OAuth 2.0 DPoP（RFC 9449）傳送方約束的更新權杖。

Software Development21K今天更新

Gemini Live Api

google

精選

產生 Gemini Live API WebSocket 用戶端類別、測試、文件，以及用於雙向串流的示範介面。

Software Development21K今天更新

Gemini Api

google

精選

說明如何在 Google Agent Platform 上使用 Gen AI SDK 呼叫 Gemini API，涵蓋多種語言與多項功能。

Software Development21K今天更新