laravel-verification

laravel-verification skill の概要

laravel-verification でできること

laravel-verification skill は、Laravel プロジェクト向けの PR 前・デプロイ前の検証ワークフローです。環境、Composer、Lint、静的解析、テスト、セキュリティ、リリース準備といったチェックを、正しい順序で実行できるようにします。これにより、staging や production に到達する前に不具合を見つけられます。

どんな人に向いているか

Laravel アプリを扱っていて、リファクタリング、依存関係のアップグレード、CI 障害対応、リリース準備のたびに、再現性のある検証を行いたいなら laravel-verification skill を使うとよいでしょう。特に、場当たり的な汎用プロンプトではなく、構造化された laravel-verification guide を求めるエージェントや開発者に向いています。

何が便利なのか

この skill の主な価値は、処理の順序づけにあります。単にチェック項目を並べるだけではなく、前段の確認を通過しないと次に進まないため、無駄な作業が減り、失敗の原因も読み取りやすくなります。壊れた環境、autoload の問題、設定の不一致があるなら早い段階で止めたい、という laravel-verification for Workflow Automation の場面で特に効果的です。

laravel-verification skill の使い方

laravel-verification skill をインストールする

ディレクトリのインストール手順に従って skill を追加し、検証を適用したい workspace で読み込みます。この repo では、基本のインストールコマンドは次のとおりです。

npx skills add affaan-m/everything-claude-code --skill laravel-verification

インストール後は、検証を依頼する前に、現在の project context で skill が利用可能になっていることを確認してください。

まず正しいファイルを読む

最初に読むべきなのは SKILL.md です。実際の workflow がここに書かれています。そのあと、関連する context があれば skill フォルダ内の周辺ファイルを確認します。この repository では SKILL.md が主要ソースで、helper scripts や reference folders はないため、まず信頼すべきなのはこのファイルそのものです。

特に注目するのは以下です。

• When to Use
• How It Works
• Phase 1: Environment Checks
• Phase 1.5: Composer and Autoload

ここを見ると、laravel-verification install と利用範囲の実態が分かります。

依頼内容を具体的にする

この skill は、「アプリを確認して」といった曖昧な依頼より、具体的な対象があると最も力を発揮します。環境、変更の種類、リリース上のリスクを含めて伝えてください。たとえば次のような依頼です。

• “Run the laravel-verification skill against this Laravel app after a PHP upgrade.”
• “Use laravel-verification to verify staging readiness for this branch.”
• “Apply the laravel-verification guide to a production deploy candidate and report blockers only.”

Sail、PHPUnit/Pest、PHPStan、Pint、デプロイ pipeline など、実際に使っている tools も添えると、出力が自分の stack に合いやすくなります。

ワークフローの順序に従う

よい実行は、まず environment checks と Composer validation から始まり、その後に linting/static analysis、テスト、最後に security と deployment readiness へ進みます。基盤の environment が壊れているかもしれないのに、テスト結果や deployment advice だけを先に求めないでください。この順序こそが laravel-verification の使い方の核であり、緩いプロンプトよりも実用性が高い理由です。

laravel-verification skill の FAQ

laravel-verification は Laravel アプリ専用ですか？

はい。php artisan、Composer autoloading、Laravel の conventions に沿った deployment readiness など、Laravel 固有のチェックを前提に作られています。プロジェクトが Laravel ベースでないなら、汎用の verification prompt のほうが合っています。

通常の prompt と何が違いますか？

通常の prompt は、構造のない checklist を返しがちです。laravel-verification skill では、環境確認、autoloading の確認、lint、解析、テスト、さらに security と release gate の確認、という順序だった進め方ができます。これにより、ブランチや agent が変わっても一貫した結果を求める場面で、信頼性が高まります。

初心者はすべての tool を先に理解する必要がありますか？

いいえ。ただし、今どの environment にいるのか、何が変わったのかは把握しておくべきです。この skill は、PHPStan や deployment readiness をまだ完全に理解していなくても役立ちます。検証作業を、順番に追えて確認できる形へ変えてくれるからです。

どんなときにこの skill を使わないほうがよいですか？

探索的な coding、UI のブレスト、feature の発想段階では laravel-verification は使わないでください。これは verification skill であって、feature を作る skill ではありません。また、短い lint 実行のように単独のチェックだけで足りる場合は、フルの release gate まで含めるより価値が小さくなります。

laravel-verification skill の改善方法

もっと良い開始コンテキストを与える

品質を最も上げるのは、何が変わったかと、どんなリスクを気にしているかを伝えることです。次の比較を見てください。

• 弱い例: “Verify my Laravel project.”
• 強い例: “Verify this Laravel app after changing queue workers, env values, and a database migration; surface anything blocking deployment.”

後者のほうが、laravel-verification skill は適切なチェックを優先しやすくなり、失敗理由もデプロイの観点で説明しやすくなります。

チェック内容を stack に合わせる

ローカルで Sail を使っているなら、その点を明記してください。Pest を使っているなら PHPUnit ではなく Pest と書き、PHPStan も特定の level があるなら含めます。入力が具体的であるほど、誤った前提が減り、laravel-verification usage の出力が架空の Laravel 標準ではなく、実際の repo に合うようになります。

ノイズではなく blocker を求める

意思決定のためには、merge や deploy を止める問題だけを求めるのが有効です。この skill は、致命的な失敗と任意の cleanup を分けて扱えるときに最も役立ちます。より絞り込んだ結果がほしいなら、次のように依頼してください。

• blocking issues only
• suggested next checks in order
• deploy readiness verdict
• missing environment or config keys

こうすると、laravel-verification guide の焦点が説明ではなく実行に合います。

1 回目の結果を踏まえて再実行する

最初の実行で失敗が見つかったら、失敗したコマンドそのもの、現在の environment、ブランチの目的を添えて再実行してください。たとえば、失敗した composer validate の出力や、劣化した具体的な test suite を共有します。次の依頼が具体的であるほど、次回の verification pass は原因と次の手順をより正確に切り分けられます。