laravel-verification

laravel-verification 技能總覽

laravel-verification 的用途

laravel-verification skill 是給 Laravel 專案使用的 PR 前、部署前驗證流程。它會依正確順序執行該做的檢查——環境、Composer、lint、靜態分析、測試、安全性與發佈就緒度——讓你在問題進到 staging 或 production 之前先攔下來。

適合哪些人使用

如果你正在維護 Laravel 應用，並且需要一套可重複執行的驗證流程來應對重構、相依套件升級、CI 失敗或發佈前準備，就很適合使用 laravel-verification skill。它特別適合想要一份結構化的 laravel-verification guide，而不是臨場拼湊通用提示詞的代理程式與開發者。

為什麼它有用

它最大的價值在於流程編排。這個 skill 不只是列出檢查項目，而是以前一步的結果作為下一步的門檻，能減少白做工，也讓失敗更容易判讀。當你需要用 laravel-verification for Workflow Automation 時，這點尤其重要，因為環境損壞、autoload 問題或設定不一致，應該在流程早期就讓執行停止。

如何使用 laravel-verification skill

安裝 laravel-verification skill

先用目錄提供的安裝流程加入這個 skill，再把它載入到你希望套用驗證行為的 workspace。就這個 repo 而言，基礎安裝指令是：

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

安裝完成後，先確認這個 skill 已經存在於目前專案上下文中，再要求執行驗證流程。

先讀對應的檔案

先從 SKILL.md 讀起，因為真正的工作流程都在這裡；如果旁邊還有連結的背景資料，再去看 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 最適合有明確目標的需求，而不是一句模糊的「幫我檢查 app」。請把環境、變更類型和發佈風險一起寫進去。例如：

• “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，或你的部署管線，這樣輸出才會貼近你的技術棧。

依照工作流程順序執行

一個好的執行順序，應該先做環境檢查與 Composer 驗證，再進入 lint 與靜態分析，接著跑測試，最後處理安全性與部署就緒度。不要在基礎環境可能已經壞掉的情況下，直接要求模型給你測試結果或部署建議。這個順序正是 laravel-verification 的使用模式核心，也讓這個 skill 比鬆散的提示詞更有可操作性。

laravel-verification skill 常見問題

laravel-verification 只適用於 Laravel 應用嗎？

是。這個 skill 是圍繞 Laravel 專屬檢查設計的，例如 php artisan、Composer autoload，以及符合 Laravel 慣例的部署就緒度。如果你的專案不是 Laravel，通用驗證提示詞會更合適。

這和一般提示詞有什麼不同？

一般提示詞常常只會產生沒有結構的檢查清單。laravel-verification skill 提供的是有紀律的操作順序：先驗證環境、確認 autoload、再做 lint、分析、測試，最後檢查安全性與發佈門檻。當你需要跨分支或跨代理程式維持一致結果時，這樣的順序會更可靠。

初學者需要先完全懂每個工具嗎？

不需要，但至少要知道自己所在的環境，以及哪些地方有變更。就算你還不完全理解 PHPStan 或部署就緒度，這個 skill 依然有用，因為它會把驗證工作變成一個你能照著走、也能逐步檢視的流程。

什麼情況下不該用這個 skill？

不要把 laravel-verification 用在探索式開發、UI 發想，或功能構思上。它是驗證 skill，不是做功能的 skill。若你只需要單一項檢查，例如快速跑一次 lint，而不是完整的發佈門檻，它的價值也會比較有限。

如何改進 laravel-verification skill

給 skill 更好的起始背景

品質提升最大的一步，是先告訴 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 把重點檢查排在前面，並用部署角度解釋失敗原因。

讓檢查內容和你的技術棧對齊

如果你本機用的是 Sail，就直接說。如果你用 Pest 而不是 PHPUnit，或 PHPStan 設定在特定等級，也一起寫進去。輸入越精準，越能減少錯誤假設，讓 laravel-verification usage 的輸出貼近你的實際 repository，而不是某種想像中的 Laravel 預設值。

要求阻擋因素，不要雜訊

如果你是為了做決策，請只要求會阻止 merge 或 deploy 的問題。這個 skill 最有價值的地方，在於它能分辨硬性失敗與可選清理項目。若想得到更精準的結果，可以要求：

• 僅列出 blocking issues
• 依順序列出下一步建議檢查
• deployment readiness verdict
• 缺少的環境或設定鍵值

這能讓 laravel-verification guide 保持在行動導向，而不是變成敘述報告。

第一輪之後再迭代

如果第一次執行就找出失敗，下一輪就把實際失敗的指令、所在環境，以及分支目標一起補上。例如提供失敗的 composer validate 輸出，或是退步的具體測試套件。你的後續資訊越精確，下一次驗證流程就越能更準確地鎖定根因與下一步。