add について
既存のコマンドとパッケージ構成を保ちながら、リポジトリに Turborepo を追加するスキルです。リポジトリ分析、タスク設定、導入、同等性の検証を案内し、前提条件やタスクの挙動が不明な場合は停止します。
主な機能
- 01リポジトリと CI の分析
- 02挙動が明確なタスクの選定
- 03Turborepo の慎重な設定
- 04既存コマンドと turbo の比較
- 05前提条件が不明な場合の停止
活用シーン
- 01ワークスペースへのタスク実行管理の追加
- 02単一パッケージリポジトリのタスク設定
- 03turbo が既存の挙動を保つか確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vercel/ turborepo --skill addインストール後、Claude Code で/addを入力して読み込まれたか確認します。
詳細
Turborepo の追加
既存のコマンドの動作を変えずに、選択したタスク向けに既存のリポジトリへ Turborepo を追加します。ワークスペースリポジトリでは、ワークスペースのパッケージタスクを設定します。単一パッケージのリポジトリでは、ルートタスクを設定します。
ドキュメント
ファイルを変更する前に以下を読み、設定構文とツールチェーンの前提条件に関する信頼できる情報源として扱ってください。
turbo をインストールしたら、インストール済みのバージョンに合致する、同梱の docs/README.md を優先してください。ドキュメントを確認できない場合は、記憶している構文に頼らず作業を中止してください。
中止する場合
以下に該当する場合は、リポジトリを変更せず、中止する理由を説明してください。
- Git チェックアウトに未コミットの変更がある。
- リポジトリの既存のマニフェストから Turborepo がパッケージを検出できない。
- Turborepo の追加に、新しいツールチェーン、パッケージマネージャー、またはマニフェストの種類が必要となる、あるいはパッケージの移動が必要となる。
- 1 つのツールチェーンに、競合するロックファイルがある。
- 選択したタスクの実行順序、出力、必要な環境を、リポジトリと CI から判断できない。
ワークフロー
1. 分析
マニフェスト、ワークスペース定義、ロックファイル、ルートスクリプトまたはタスクランナーのターゲット、パッケージの依存関係、CI 設定を読みます。ツールチェーン、構成、候補となるタスク、確認できた依存関係、出力、環境変数、および推測できなかった事項をまとめてください。
Turborepo を追加するという直接的な依頼があれば、そのまま進めてかまいません。依頼が曖昧な場合、または以下の範囲を超える場合に限り、先に確認してください。
2. タスクの選択
動作が明確なタスクのみを設定し、リポジトリですでに実行されている lint、type-check、format-check、unit-test、build タスクを優先してください。
以下は行わないでください。
- パッケージの名前変更や移動、ツールチェーン、パッケージマネージャー、ワークスペースのメンバー構成の変更。
- パッケージレベルのタスクコマンドの書き換え。
- リモートキャッシュの追加。
- 依頼がない限り、デプロイ、エンドツーエンド、統合、または環境プロビジョニングのタスクの設定。
既存のルートエントリーポイントは維持してください。ルートオーケストレーターの turbo 版には、リポジトリの命名規則に従った個別の名前(<task>:turbo など)を付けてください。turbo コマンドが同等であると確認できた場合に限り、元のコマンドを置き換えてください。
3. Turborepo の追加
ツールチェーンのガイドに従って turbo をインストールしてください。リポジトリでツールのバージョンを固定している場合は、同じ方法で turbo も特定のバージョンに固定してください。ロックファイルは、それを管理するツールで再生成してください。ロックファイルを手作業で編集してはいけません。
不足している場合は、ワークスペース名やツールチェーンの宣言など、ツールチェーンのガイドにある前提条件を追加してください。バージョンは推測せず、ロックファイルまたはツールチェーン固有のコマンドから取得してください。
選択したタスクのみを対象とするルートの turbo.json を作成してください。
- それらのタスクに必要なツールチェーンサポートのみを有効にし、必要な
futureFlagsも設定してください。そのサポートが実験的な場合はユーザーに伝えてください。 dependsOn、inputs、outputs、環境変数は、リポジトリから必要性が確認できる場合にのみ追加してください。- カスタムの
inputsを追加する場合は、"$TURBO_DEFAULT$"を含めてください。パッケージ外にあるルートファイルは、"$TURBO_ROOT$/<path>"で参照してください。 - 副作用のあるタスクと、出力をキャプチャできないタスクでは、キャッシュを無効にしてください。
ツールチェーンサポートによって、選択していない組み込みタスクが登録されることがあります。それらは検証済みではなく、保留中として報告してください。
依存関係ディレクトリと .turbo が .gitignore に記載されていない場合は追加してください。それ以外の除外ルールは変更しないでください。
4. 検証
依存関係を固定モードまたは不変モードでインストールします。次に、各タスクについて turbo run <task> --dry の出力を確認します。
- 意図したパッケージとタスクのみが選択されており、タスクを定義するパッケージが漏れていないこと。
- タスクの順序が、現在のリポジトリの動作と一致していること。
- 共通のルート入力を持つタスクでは、1 回実行し、2 回目の実行でキャッシュヒットすることを確認します。次にルート入力を 1 つ変更してキャッシュミスすることを確認し、その後、変更を元に戻します。
その後、既存の各コマンドと対応する turbo コマンドを実行し、対象パッケージ、順序、終了ステータス、出力を比較します。turbo の実行が成功しただけでは、同等であることの証明にはなりません。動作が異なる場合は、設定の範囲を絞るか、作業を中止します。違いを隠すために古いコマンドを削除してはいけません。
5. 報告
以下をまとめます。
- 設定したタスクと対象パッケージ。
- 維持したコマンドと、置き換えたルートのエントリーポイント。
- 推定した依存関係、入力、出力、環境変数。
- 既存のコマンドと
turboコマンドを比較した検証結果。 - 保留または未対応のタスク。
ユーザーから依頼された場合に限り、コミット、プッシュ、またはプルリクエストを作成します。プルリクエストはドラフトとして作成します。
別のスキルがこのスキルを呼び出す場合
呼び出し元のブランチで作業し、プルリクエストは作成せず、差分、検証結果、保留中のタスクを呼び出し元に返します。変更に選択したタスクの範囲を超える作業が必要な場合は、範囲を広げずに作業を中止します。