AgentSkillsCN

nx-tools

通过统一的 Python CLI 查询 Nx 工作区的元数据、项目配置、受影响范围检测、生成器模式，以及依赖关系图。在分析单体仓库结构、检查 project.json 配置、为 CI 优化确定受影响的项目、发掘可用的生成器，或可视化工作区依赖关系时，可使用此技能。

SKILL.md
--- frontmatter
name: nx-tools
type: complex
depth: base
user-invocable: false
description: >-
  Queries Nx workspace metadata, project configurations, affected detection,
  generator schemas, and dependency graphs via unified Python CLI. Use when
  analyzing monorepo structure, inspecting project.json configurations,
  determining affected projects for CI optimization, discovering available
  generators, or visualizing workspace dependencies.

[H1][NX-TOOLS]

Dictum: Uniform interfaces eliminate invocation ambiguity.

<br>

Query Nx workspace with unified Python CLI.

[1][COMMANDS]

[CMD][ARGS][PURPOSE]
workspace—List all projects
path—Get workspace root path
generators—List available generators
project<name>View project configuration
run<target>Run target across projects
schema<generator>View generator schema
affected[base]List affected projects (default: main)
graph[output]Generate dependency graph
tokens[path]Count tokens in file/directory
docs[topic]View Nx command documentation

[2][USAGE]

bash
# Zero-arg commands
uv run .claude/skills/nx-tools/scripts/nx.py workspace
uv run .claude/skills/nx-tools/scripts/nx.py path
uv run .claude/skills/nx-tools/scripts/nx.py generators

# Required-arg commands
uv run .claude/skills/nx-tools/scripts/nx.py project @parametric-portal/types
uv run .claude/skills/nx-tools/scripts/nx.py run build
uv run .claude/skills/nx-tools/scripts/nx.py run typecheck
uv run .claude/skills/nx-tools/scripts/nx.py schema @nx/react:component

# Optional-arg commands (defaults shown)
uv run .claude/skills/nx-tools/scripts/nx.py affected            # base=main
uv run .claude/skills/nx-tools/scripts/nx.py affected HEAD~5
uv run .claude/skills/nx-tools/scripts/nx.py graph               # output=.nx/graph.json
uv run .claude/skills/nx-tools/scripts/nx.py graph custom.json
uv run .claude/skills/nx-tools/scripts/nx.py tokens              # path=.
uv run .claude/skills/nx-tools/scripts/nx.py tokens CLAUDE.md
uv run .claude/skills/nx-tools/scripts/nx.py docs                # topic=general
uv run .claude/skills/nx-tools/scripts/nx.py docs affected

[3][ARGUMENTS]

workspace: (no arguments)

  • •Returns list of all project names in workspace

path: (no arguments)

  • •Returns workspace root path from CLAUDE_PROJECT_DIR or cwd

generators: (no arguments)

  • •Returns list of available Nx generators

project: <name>

  • •name — Project name (required, e.g., @parametric-portal/types)

run: <target>

  • •target — Target to run (required, e.g., build, typecheck, test)

schema: <generator>

  • •generator — Generator name (required, e.g., @nx/react:component)

affected: [base]

  • •base — Git ref to compare against (default: main)

graph: [output]

  • •output — Output file path (default: .nx/graph.json)

tokens: [path]

  • •path — File or directory to count (default: .)

docs: [topic]

  • •topic — Nx command to get help for (default: general help)

[4][OUTPUT]

Commands return: {"status": "success|error", ...}.

[INDEX][CMD][RESPONSE]
[1]workspace{projects: string[]}
[2]path{path: string}
[3]generators{generators: string}
[4]project{name: string, project: object}
[5]run{target: string, output: string}
[6]schema{generator: string, schema: string}
[7]affected{base: string, affected: string[]}
[8]graph{file: string}
[9]tokens{path: string, output: string}
[10]docs{topic: string, docs: string}