ジェネレーターCLIテスト
作成2026年3月22日Takeshi Takatsudo
Claude Codeスキルを使ったcreate-zudo-docジェネレーターCLIのテスト方法。
ジェネレーターCLIテスト
create-zudo-docジェネレーターCLIは、さまざまな機能の組み合わせで新しいzudo-docプロジェクトを生成します。テストでは、各組み合わせがビルド・実行でき、正しいファイルと設定が生成されることを検証します。
2つのClaude Codeスキルでこのワークフローを自動化しています：
| スキル | 目的 |
|---|---|
/l-generator-cli-tester <pattern> | 単一の生成パターンをテスト |
/l-run-generator-cli-whole-test | 全9パターンを実行し、バグを修正して検証 |
テストパターン
各パターンは異なる機能の組み合わせを有効にします：
| パターン | 説明 |
|---|---|
barebone | すべてOFF — 最小構成 |
search | 検索のみ有効 |
i18n | i18nのみ有効 |
sidebar-filter | サイドバーフィルターのみ有効 |
claude-resources | Claude Resourcesのみ有効 |
color-tweak-panel | カラー調整パネルのみ有効（API使用） |
light-dark | ライト・ダークカラースキームモード |
lang-ja | デフォルト言語を日本語に設定 |
all-features | すべてON |
テストの実行
全テストスイート
全9パターンをエンドツーエンドで実行し、失敗を自動修正して検証します：
/l-run-generator-cli-whole-testヘッドレスブラウザによるレンダリングチェック付き：
/l-run-generator-cli-whole-test --headless単一パターン
1つのパターンを個別にテストします：
/l-generator-cli-tester barebone
/l-generator-cli-tester all-features --headless各テストのチェック内容
各パターンは以下のステップを実行します：
- スキャフォールド — パターン固有のフラグでジェネレーターCLI（またはプログラマティックAPI）を実行
- インストール — 生成されたプロジェクトで
pnpm install - ビルド —
pnpm buildで静的エクスポートの成功を検証 - 開発サーバー —
pnpm devを起動し、8秒待ってプロセスがまだ実行中か確認 - ファイル検証 — 有効な機能に基づいて、期待されるファイルの存在/不在を確認
- 設定検証 — 生成された
settings.tsを読み、正しい値を確認 - ショーケース比較 — 生成されたコードをメインのzudo-docショーケースと比較
- ヘッドレスブラウザ（
--headless使用時） — 実際のブラウザでページをレンダリングし、JSエラーを確認、視覚要素（検索アイコン、言語切り替え、テーマトグルなど）を検証
バグ修正ワークフロー
/l-run-generator-cli-whole-testスキルには構造化されたバグ修正フェーズがあります：
- フェーズ1 — 全9パターンを実行し、結果を収集
- フェーズ2 — 各失敗について：失敗ステップの診断、関連ソースファイルの確認、最小限の修正適用、CLIの再ビルドと再テスト、個別コミット
- フェーズ3 — 全9パターンを最初から再実行し、リグレッションがないことを確認
- フェーズ4 — サマリーレポートを出力
よくある失敗パターン
| 失敗内容 | 原因 | 修正対象 |
|---|---|---|
| ビルド時にモジュールが見つからない | 生成されたpackage.jsonに依存関係がない | scaffold.ts — generatePackageJson() |
| インポートが見つからない | 無効化された機能のインポートが除去されていない | strip.ts |
| settings.tsの型エラー | 設定フィールドが不足または不正 | settings-gen.ts |
| コンポーネントが除去済みコンポーネントを参照 | テンプレートの使用箇所が除去されていない | strip.tsのパッチパターン |
| 不要な機能ファイルが残っている | ストリップ時にファイルが削除されていない | strip.ts |
主要なジェネレーターファイル
| ファイル | 役割 |
|---|---|
packages/create-zudo-doc/src/scaffold.ts | テンプレートのコピー、package.jsonの生成 |
packages/create-zudo-doc/src/strip.ts | オプションに基づく機能/インポートの除去 |
packages/create-zudo-doc/src/settings-gen.ts | settings.tsの生成 |
packages/create-zudo-doc/src/constants.ts | 機能定義、カラースキームリスト |
packages/create-zudo-doc/src/cli.ts | CLI引数のパース |
packages/create-zudo-doc/src/api.ts | プログラマティックAPI |
注意事項
- テストディレクトリは
__inbox/（gitignored）に作成され、リポジトリを汚染しません bareboneパターンがベースライン — 失敗した場合、他のテストの前に修正してくださいcolorTweakPanelにはCLIフラグがありません — 使用するパターン（color-tweak-panel、all-features）はプログラマティックAPIを使用します--headlessフラグはプロセスレベルのチェックに加えて、ブラウザレベルのレンダリングチェックを追加します- テスト前と各修正後には必ずCLIを再ビルド（
packages/create-zudo-docでpnpm build）してください