AgentSkillsCN

nx-workspace-architecture

指导在 Nx 工作区中规划新功能的结构。当用户询问如何创建库、组织代码，或应将新功能放置于何处时，可参考此指南。

SKILL.md
--- frontmatter
name: nx-workspace-architecture
description: Guide structuring new features in Nx workspaces. Use when user asks about creating libraries, organizing code, or where to place new features.
allowed-tools: Bash, Glob, Grep, Read

Nx Workspace Architecture

Core Principles

  1. •Domain over Technical - organize by business domains (products, orders, checkout), not technical types (components, services)
  2. •Thin App Shell - apps are deployment containers; business logic lives in libs
  3. •Explicit Boundaries - use Nx projects to enforce separation, not just folders

Library Types

PrefixPurposeCan Import
feat-*Smart components, pages, business logicfeat, ui, data-access, util
ui-*Presentational/dumb componentsui, util
data-accessAPI calls, state managementdata-access, util
utilPure functions, helpers, typesutil only

Folder Structure

code
packages/
├── {domain}/           # e.g. products, orders, checkout
│   ├── data-access/
│   ├── feat-{name}/
│   ├── ui-{name}/
│   └── util/
└── shared/             # cross-domain utilities

Tagging Strategy

Add to project.json:

  • •scope:{domain} - vertical boundary (products, orders, shared)
  • •type:{library-type} - horizontal layer (feature, ui, data-access, util)

Decision Flow

When user wants to add new functionality:

  1. •Identify domain - which business area does it belong to?
  2. •Determine library type:
    • •Has routing/pages? → feat-*
    • •Purely visual component? → ui-*
    • •API/state logic? → data-access
    • •Pure utilities? → util
  3. •Check existing libs - can it extend an existing library?
  4. •Create new lib only if needed for clear separation

When to Split Libraries

Split when you observe:

  • •Frequent cross-library changes for single features
  • •Circular dependencies emerging
  • •Unclear ownership between teams
  • •Single lib growing too large (>20 files is a smell)

Generator Commands

Use the nx-generators skill.