laravel-verification

laravel-verification 技能概览

laravel-verification 的作用

laravel-verification 技能是一套面向 Laravel 项目的 PR 前和部署前验证工作流。它帮助你按正确顺序执行合适的检查——环境、Composer、lint、静态分析、测试、安全性以及发布就绪度——从而在问题进入 staging 或 production 之前就把它们拦住。

适合谁使用

如果你正在开发 Laravel 应用，并且在重构、依赖升级、CI 失败排查或发布准备时需要一套可重复的验证流程，就适合使用 laravel-verification 技能。它尤其适合希望获得结构化 laravel-verification guide、而不是临时拼凑一个通用 prompt 的 agents 和开发者。

它为什么有用

它的核心价值在于顺序控制。这个技能不只是罗列检查项，而是以前置步骤作为后续步骤的门槛，这样既减少无效工作，也让失败更容易判断。尤其当你需要用于 laravel-verification for Workflow Automation 时，这一点很重要，因为环境损坏、autoload 问题或配置不一致，应该尽早中止流程。

如何使用 laravel-verification 技能

安装 laravel-verification 技能

通过目录里的安装流程把技能加进去，然后在你希望生效的工作区中加载它。对于这个仓库，基础安装命令是：

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

安装完成后，在请求验证流程之前，先确认当前项目上下文里已经可用这个技能。

先阅读正确的文件

先看 SKILL.md，因为这里包含真实的工作流；如果周围技能目录里还有关联上下文，再继续查看。在这个仓库里，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 和实际使用边界到底在哪里。

提出一个足够具体的请求

这个技能最适合处理明确目标，而不是一句模糊的“帮我检查一下应用”。要写清楚环境、变更类型和发布风险。例如：

• “在 PHP 升级后，使用 laravel-verification 技能检查这个 Laravel 应用。”
• “用 laravel-verification 验证这个分支是否具备 staging 上线条件。”
• “将 laravel-verification guide 应用于一个 production 部署候选，只返回阻塞项。”

同时补充你实际使用的工具，例如 Sail、PHPUnit/Pest、PHPStan、Pint 或你的部署流水线，这样输出才会贴合你的技术栈。

按照工作流顺序执行

一次好的验证应该从环境检查和 Composer 校验开始，再进入 linting/static analysis，然后是测试，最后才是安全性和部署就绪度。不要在基础环境可能已经损坏的情况下，直接要求模型输出测试结果或部署建议。这个顺序正是 laravel-verification 的使用模式核心，也是它比松散 prompt 更可执行的原因。

laravel-verification 技能 FAQ

laravel-verification 只适用于 Laravel 应用吗？

是。这个技能是围绕 Laravel 特有检查设计的，比如 php artisan、Composer autoloading，以及符合 Laravel 约定的部署就绪度。如果你的项目不是基于 Laravel，通用验证 prompt 会更合适。

它和普通 prompt 有什么不同？

普通 prompt 往往只会给出一份不够结构化的检查清单。laravel-verification 技能提供的是一套有纪律的操作顺序：先验证环境，确认 autoloading，再做 lint、分析、测试，最后检查安全与发布闸门。当你需要跨分支或跨 agent 保持一致结果时，这会显著提升可靠性。

初学者需要先完全搞懂每个工具吗？

不需要，但至少要知道自己处于什么环境、改动了什么。即使你还没有完全理解 PHPStan 或部署就绪度，这个技能也依然有用，因为它把验证任务变成了一套可以照着执行、并逐步检查的流程。

什么时候不该用这个技能？

不要把 laravel-verification 用在探索性编码、UI 构思或功能创意阶段。它是验证技能，不是功能构建技能。并且如果你只需要一个孤立检查，比如快速跑一次 lint，而不是完整的发布闸门，它的价值也会小很多。

如何改进 laravel-verification 技能

给技能更好的起始上下文

提升质量最明显的方法，是告诉它发生了什么变化，以及你最在意什么风险。对比一下：

• 弱：Verify my Laravel project.
• 强：Verify this Laravel app after changing queue workers, env values, and a database migration; surface anything blocking deployment.

第二种写法能帮助 laravel-verification 技能优先检查更关键的内容，并用部署语言解释失败原因。

让检查项匹配你的技术栈

如果你本地用的是 Sail，就明确说出来。如果你用 Pest 而不是 PHPUnit，或者 PHPStan 固定在某个 level，也要写明。输入越具体，误判越少，laravel-verification usage 的输出也越能贴合你的真实仓库，而不是某种假想中的 Laravel 默认配置。

要求返回阻塞项，而不是噪音

如果是为了决策，直接让它只给出会阻止合并或部署的问题。这个技能最有价值的地方，在于它能区分硬性失败和可选清理项。如果你想要更收敛的结果，可以要求：

• 只输出阻塞问题
• 按顺序给出下一步建议检查
• 输出部署就绪度结论
• 列出缺失的环境或配置键

这样能让 laravel-verification guide 聚焦于行动，而不是叙述。

在第一次结果后继续迭代

如果第一次运行发现失败，就带着精确的失败命令、当前环境和分支目标重新执行。例如，提供失败的 composer validate 输出，或者具体退化的测试套件。你的后续信息越精确，下一轮验证就越能把根因和下一步切得更清楚。