AgentSkillsCN

nx-operations

当您需要借助 Nx 执行任务、构建项目，或深入了解工作区的依赖关系与整体架构时，此技能将助您事半功倍。无论是构建、代码检查，还是单元测试，皆可放心使用。

SKILL.md
--- frontmatter
name: nx-operations
description: When you need to run tasks, build projects, or understand the workspace graph using Nx. Use this for all build, lint, and test operations.

Nx Operations & Workspace Management

1. General Guidelines

  • •Always use Nx: Run tasks via nx run, nx run-many, or nx affected. Do not use underlying tools (like tsc or vite directly) unless debugging a specific issue with them.
  • •Analyze First:
    • •Use nx_workspace to understand the workspace layout.
    • •Use nx_project_details to analyze specific project dependencies before making changes.
    • •Use nx_docs if you are unsure about configuration or best practices.

2. Common Commands

Building

  • •Build Core App: nx build nextblock
  • •Build All Libraries: npm run lib-builds (alias for building ui, utils, db, editor, sdk)
  • •Build Specific Lib: nx build <lib-name> (e.g., nx build ui)

Linting

  • •Lint Core App: nx lint nextblock
  • •Lint All: npm run lint

Development

  • •Serve App: nx serve nextblock (runs the Next.js dev server)

3. Troubleshooting

  • •If nx start nextblock fails with "Could not find a production build", ensure you have run nx build nextblock first.
  • •Use nx reset if you suspect cache issues.