mcpField
A
add

add

github.com/vercel開発31.3k122 回インストール2 日前に更新
リポジトリ

add について

既存のコマンドとパッケージ構成を保ちながら、リポジトリに Turborepo を追加するスキルです。リポジトリ分析、タスク設定、導入、同等性の検証を案内し、前提条件やタスクの挙動が不明な場合は停止します。

主な機能

  1. 01リポジトリと CI の分析
  2. 02挙動が明確なタスクの選定
  3. 03Turborepo の慎重な設定
  4. 04既存コマンドと turbo の比較
  5. 05前提条件が不明な場合の停止

活用シーン

  1. 01ワークスペースへのタスク実行管理の追加
  2. 02単一パッケージリポジトリのタスク設定
  3. 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 コマンドを比較した検証結果。
  • 保留または未対応のタスク。

ユーザーから依頼された場合に限り、コミット、プッシュ、またはプルリクエストを作成します。プルリクエストはドラフトとして作成します。

別のスキルがこのスキルを呼び出す場合

呼び出し元のブランチで作業し、プルリクエストは作成せず、差分、検証結果、保留中のタスクを呼び出し元に返します。変更に選択したタスクの範囲を超える作業が必要な場合は、範囲を広げずに作業を中止します。

コメント