mcpField
N
nx-workspace-patterns

nx-workspace-patterns

github.com/wshobson開発41.9k11.0k 回インストール2 週間前に更新
リポジトリ

nx-workspace-patterns について

Nx のモノレポを構築・管理するチーム向けのスキルです。ワークスペース構成、プロジェクト境界、依存関係、キャッシュ、CI 最適化のパターンを扱います。

主な機能

  1. 01Nx ワークスペースの構成
  2. 02プロジェクト境界とタグ
  3. 03ライブラリ種別の整理
  4. 04affected コマンドによる CI 最適化
  5. 05キャッシュと移行のパターン

活用シーン

  1. 01Nx ワークスペースのセットアップ
  2. 02変更の影響を受けるプロジェクトだけのテスト
  3. 03モノレポ内プロジェクト間の依存関係管理
  4. 04コードベースの Nx への移行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/wshobson/agents --skill nx-workspace-patterns

インストール後、Claude Code で/nx-workspace-patternsを入力して読み込まれたか確認します。

同梱ファイルreferences/details.md

詳細

Nx ワークスペースパターン

Nx モノレポ管理のための本番環境向けパターン。

このスキルを使うべき場面

  • 新しい Nx ワークスペースをセットアップするとき
  • プロジェクトの境界を設定するとき
  • affected コマンドで CI を最適化するとき
  • リモートキャッシュを実装するとき
  • プロジェクト間の依存関係を管理するとき
  • Nx へ移行するとき

中核となる概念

1. Nx のアーキテクチャ
workspace/
├── apps/              # Deployable applications
│   ├── web/
│   └── api/
├── libs/              # Shared libraries
│   ├── shared/
│   │   ├── ui/
│   │   └── utils/
│   └── feature/
│       ├── auth/
│       └── dashboard/
├── tools/             # Custom executors/generators
├── nx.json            # Nx configuration
└── workspace.json     # Project configuration
2. ライブラリの種類
種類目的例
featureスマートコンポーネント、ビジネスロジックfeature-auth
uiプレゼンテーショナルコンポーネントui-buttons
data-accessAPI 呼び出し、状態管理data-access-users
util純粋関数、ヘルパーutil-formatting
shellアプリのブートストラップshell-web

テンプレートと詳細な実例

完全なテンプレートライブラリと詳細な実例は references/details.md にあります。具体的なテンプレートが必要なときはそのファイルを読んでください。

ベストプラクティス

やるべきこと
  • タグを一貫して使う - モジュール境界で強制する
  • 早い段階でキャッシュを有効にする - CI の大幅な節約になる
  • ライブラリを焦点を絞った状態に保つ - 単一責任
  • ジェネレーターを使う - 一貫性を確保する
  • 境界を文書化する - 新しい開発者の助けになる
やってはいけないこと
  • 循環依存を作らない - グラフは非巡回であるべき
  • affected を省略しない - 変更されたものだけをテストする
  • 境界を無視しない - 技術的負債が蓄積する
  • 細かく分けすぎない - ライブラリの数のバランスを取る

コメント

Markdown 対応