CLI
mbc-cqrs-serverless CLI は、新しいプロジェクトのスキャフォールディングや、モジュール、サービス、エンティティのボイラープレートコードの生成を素早く行うためのツールです。フレームワークの規約に従い、一貫性を確保します。
CLIを使用するタイミング
以下の場合にCLIを使用します：
- 新しい MBC CQRS Serverless プロジェクトを最初から作成する
- 新しいドメインモジュール（product、order、user など）を追加する
- 正しい構造でコントローラー、サービス、エンティティ、DTOファイルを生成する
- ローカル開発サーバーを起動する
CLIが解決する問題
| 問題 | 解決策 |
|---|---|
| プロジェクト構造を手動で設定するとエラーが発生しやすい | mbc new で完全なプロジェクトスケルトンを作成 |
| 正しいファイル名やインポートを覚えておく必要がある | mbc generate で一貫したボイラープレートを作成 |
| モジュールの登録を忘れやすい | 生成されたコードはNestJSの規約に従う |
インストール
CLIをグローバルにインストール：
npm install -g @mbc-cqrs-serverless/cli
利用可能なコマンド
利用可能なCLIコマンドの一覧を取得するには、次のコマンドを実行します：
mbc -h
出力は次のようになります：
Usage: mbc <command> [options]
Options:
-v, --version Output the current version.
-h, --help Output usage information.
Commands:
new|n [name] Generate a new CQRS application using the MBC CQRS serverless framework
start|s Start application with serverless framework
ui-common|ui [options] Add mbc-cqrs-ui-common components to your project.
generate|g [options] <schematic> [name] Generate a MBC-cqrs-serverless element.
Schematics available on the collection:
┌────────────┬───────┬──────────────────────┐
│ name │ alias │ description │
│ module │ mo │ Create a module. │
│ controller │ co │ Create a controller. │
│ service │ se │ Create a service. │
│ entity │ en │ Create an entity. │
│ dto │ dto │ Create a DTO. │
└────────────┴───────┴──────────────────────┘
install-skills|skills [options] Install Claude Code skills for MBC CQRS Serverless development
help [command] display help for command
newコマン ド
ユースケース: 新しいバックエンドプロジェクトを開始する
シナリオ: 新しいマイクロサービスやAPIバックエンドを開始する際に、すべての依存関係を含む完全なプロジェクト構造が必要な場合。
mbc new [projectName[@version]]
使用例
カレントディレクトリに新しいプロジェクトを作成：
mbc new
特定の名前でプロジェクトを作成：
mbc new my-cqrs-app
特定のバージョンでプロジェクトを作成：
mbc new my-cqrs-app@0.1.45
generateコマンド
ユースケース: 既存のプロジェクトに新しいドメインを追加する
シナリオ: プロジェクトに新しいOrder機 能が必要で、APIエンドポイント、ビジネスロジック、データベースエンティティを追加する場合。
解決策: モジュール、コントローラー、サービス、エンティティ、DTOを順番に生成します。
mbc generate <schematic> [name]
# or
mbc g <schematic> [name]
利用可能なSchematic
| 名前 | エイリアス | 説明 |
|---|---|---|
| module | mo | モジュールを作成 |
| controller | co | コントローラーを作成 |
| service | se | サービスを作成 |
| entity | en | エンティティを作成 |
| dto | dto | DTOを作成 |
オプション
| オプション | 説明 |
|---|---|
-d, --dry-run | 結果を書き出さずに実行されるアクションを表示 |
--mode <mode> | 操作モードを指定: sync または async（デフォルト: async） |
--schema | スキーマ生成を有効化（デフォルト: true） |
--no-schema | スキーマ生成を無効化 |
使用例
新しいモジュールを生成：
mbc generate module order
# or
mbc g mo order
コントローラーを生成：
mbc generate controller order
# or
mbc g co order
サービスを生成：
mbc generate service order
# or
mbc g se order
エンティティを生成：
mbc generate entity order
# or
mbc g en order
DTOを生成：
mbc generate dto order
# or
mbc g dto order
ドライラン（ファイルを作成せずにプレビュー）：
mbc g mo order --dry-run
startコマンド
ユースケース: ローカル開発サーバーを実行する
シナリオ: AWSにデプロイする前に、APIエンドポイントをローカルでテストしたい場合。
mbc start
# or
mbc s
ui-commonコマンド
ユースケース: フロントエンドに構築済みUIコンポーネントを追加する
シナリオ: フロントエンドを構築中で、標準のMBC CQRS UIコンポーネントライブラリを使用したい場合。
mbc ui-common [options]
# or
mbc ui [options]
このコマンドは、MBC CQRS UI Commonライブラリをプロジェクトに統合し、構築済みのUIコンポーネントとユーティリティを提供します。
オプション
| オプション | 説明 |
|---|---|
-p, --pathDir <string> | （必須）common-uiコンポーネントのインストール先パス |
-b, --branch <string> | クローンするブランチ名（デフォルト: main） |
--auth <string> | 認証方法: SSH または HTTPS - Token（デフォルト: SSH） |
--token <string> | HTTPS認証用トークン、形式: tokenId:tokenPassword |
-c, --component <string> | インストールするコンポーネント: all, appsync, または component（デフォルト: all） |
--alias | tsconfig.jsonにcommon-ui用のエイリアス設定を追加 |
使用例
SSH認証ですべてのコンポーネントをインストール：
mbc ui-common -p src/common-ui
UIコンポーネントのみをインストール（appsyncを除く）：
mbc ui -p src/common-ui -c component
特定のブランチからインストール：
mbc ui -p src/common-ui -b develop
トークン認証を使用してHTTPSでインストール：
mbc ui -p src/common-ui --auth "HTTPS - Token" --token "user:password"
install-skillsコマンド
ユースケース: Claude Codeスキルをインストールする
シナリオ: MBC CQRS Serverless開発支援のためにClaude Codeスキルを使用したい場合。
mbc install-skills [options]
# or
mbc skills [options]
このコマンドは、コード生成、コードレビュー、マイグレーション、デバッグのガイダンスを提供するClaude Codeスキルをインストールします。
オプション
| オプション | 説明 |
|---|---|
-p, --project | 個人ディレクトリ（~/.claude/skills/）ではなくプロジェクトディレクトリ（.claude/skills/）にインストール |
-f, --force | 既存のスキルを上書き |
-l, --list | インストールせずに利用可能なスキルを一覧表示 |
-c, --check | インストールせずに更新があるかどうかを 確認 |
使用例
個人スキルディレクトリにインストール（すべてのプロジェクトで利用可能）：
mbc install-skills
プロジェクトディレクトリにインストール（git経由でチームと共有）：
mbc install-skills --project
# or
mbc skills -p
利用可能なスキルを一覧表示：
mbc install-skills --list
既存のスキルを強制的に上書き：
mbc install-skills --force
更新を確認：
mbc install-skills --check
スキルのアップグレード
スキルは自動更新されません。最新バージョンにアップグレードするには：
# CLIを最新バージョンに更新
npm update -g @mbc-cqrs-serverless/cli
# 更新があるかどうかを確認
mbc install-skills --check
# 強制的に再インストールして最新バージョンを取得
mbc install-skills --force
利用可能なスキル
| スキル | 説明 |
|---|---|
/mbc-generate | ボイラープレートコードを生成（モジュール、サービス、コントローラー、DTO、ハンドラー） |
/mbc-review | ベストプラクティスとアンチパターン（20パターン）のコードレビュー |
/mbc-migrate | バージョンマイグレーションと破壊的変更のガイド |
/mbc-debug | 一般的な問題のデバッグとトラブルシューティング |
install-skillsコマンドはバージョン1.0.24で追加されました。
トラブルシューティング
バージョンが見つからない
mbc new myapp@999.999.999
# Error: Version not found
解決策: 有効なバージョン番号を使用してください。npmレジストリで利用可能なバージョンを確認してください。
ディレクトリが空ではない
mbc new my-project
# Error: Directory not empty
解決策: 新しいディレクトリを使用するか、プロジェクト作成前に既存のファイルを削除してください。
権限エラー
グローバルインストール時に権限エラーが発生した場合：
sudo npm install -g @mbc-cqrs-serverless/cli
# or use npm prefix
npm config set prefix ~/.npm-global
npm install -g @mbc-cqrs-serverless/cli