mcpField
L
laravel:runner-selection

laravel:runner-selection

github.com/jpcaparas開発157110 回インストール19 週間前に更新
リポジトリ

laravel:runner-selection について

Laravel 開発で一貫したコマンド実行環境を選ぶためのスキルです。Sail の有無を確認して Sail またはホストのツールを使い、セッション中に実行環境を混在させない方法を示します。

主な機能

  1. 01Sail の利用可否を検出
  2. 02Sail またはホストのコマンドを選択
  3. 03セッション内で実行環境を統一
  4. 04自動化では非対話型コマンドを優先
  5. 05破壊的なデータベース操作に注意

活用シーン

  1. 01Laravel プロジェクトで Artisan コマンドを実行
  2. 02依存関係を一貫した環境でインストール
  3. 03自動化ワークフローでコマンドを実行
  4. 04意図しない破壊的なデータベース操作を回避

インストール

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

$npx skills add https://github.com/jpcaparas/superpowers-laravel --skill laravel:runner-selection

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

詳細

Laravel コマンドの実行環境の選択

環境の一貫性を保つため、利用可能な場合は Sail を使用します。Sail が利用できない場合は、ホスト側のツールを使用します。一度検出したら、そのセッション中は選択を変えないでください。

Sail の検出

# Best-effort alias; safe in any repo
alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'

# Is Sail usable?
[ -f ./sail ] || [ -x ./vendor/bin/sail ] && echo "Sail available" || echo "Sail not found"

Sail が利用できない場合は、ホスト側の php、composer、およびローカルの Node（pnpm/npm/yarn）を使用します。プロジェクトのバージョンに合わせてください。

コマンドの組み合わせ

Sail が利用可能な場合は左側のコマンドを使用し、利用できない場合は右側を使用します。

  • sail artisan about | php artisan about
  • sail artisan test | php artisan test
  • sail artisan migrate | php artisan migrate
  • sail composer install| composer install
  • sail composer require vendor/package | composer require vendor/package
  • sail pnpm install | pnpm install
  • sail pnpm run dev | pnpm run dev
  • sail mysql | mysql (対応する DSN/env を使用)
  • sail redis | redis-cli

安全に関する注意事項

  • ホストを混在させないでください。ホスト側の Composer で PHP の依存関係をインストールしてから Sail 内で実行する（またはその逆）ことは避けてください。セッションごとに実行環境を一つ選んでください。
  • 自動化やエージェントでは、対話を必要としないコマンドを優先し、プロンプトの代わりにフラグを指定してください。
  • データベースを破壊するコマンド（migrate:fresh、down -v）は慎重に扱ってください。

コメント

Markdown 対応