mcpField
L
laravel:runner-selection

laravel:runner-selection

github.com/jpcaparas开发157110 次安装19 周前更新
代码仓库

关于 laravel:runner-selection

这项 Laravel 开发技能用于选择一致的命令执行环境。它会检测 Sail 是否可用，再选用 Sail 或主机工具，并要求会话中不混用运行环境。

主要功能

  1. 01检测 Sail 是否可用
  2. 02选择 Sail 或主机命令
  3. 03每个会话保持单一运行环境
  4. 04自动化时优先使用非交互命令
  5. 05谨慎处理破坏性数据库命令

适用场景

  1. 01运行 Laravel 项目的 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 不可用时，回退到主机工具。检测一次后，本次会话中始终使用同一选择。

检测 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 中运行（反之亦然）。每次会话选择一种运行环境。
  • 自动化任务/Agent 中优先使用非交互式命令；通过标志提供参数，而不是使用提示。
  • 谨慎使用会破坏数据库的命令（migrate:fresh、down -v）。

评论

支持 Markdown