laravel-patterns

laravel-patterns 技能概览

laravel-patterns 是做什么的

laravel-patterns 技能帮助你用更清晰的边界来设计 Laravel 应用：让 controllers 保持精简，把业务逻辑移到 services 或 actions 中，并通过 models、scopes 和 resources 让数据访问保持可预测。它最适合做生产级 API 或 Web 应用的后端团队，尤其是那些更看重可维护性，而不是一次性快速脚手架的人。

谁应该使用它

如果你正在构建或重构 Laravel 代码库，并且希望得到一份关于 routing、Eloquent、queues、events、caching 和 API responses 的实用架构指南，那么就该用 laravel-patterns 技能。它适合已经掌握 Laravel 基础、但希望代码结构更利于扩展、方便团队交接，并减少 controller 膨胀的开发者。

为什么值得安装

和通用 prompt 不同，laravel-patterns 提供的是一套可复用的 Laravel 专属思维模型：请求从 HTTP 进入，规则与授权尽早生效，领域工作由 services/actions 协调完成，耗时任务则交给 jobs 或缓存路径处理。对于 Backend Development 场景，当你需要的是一致的实现取舍，而不是仅仅生成一些思路时，laravel-patterns 会非常有价值。

如何使用 laravel-patterns 技能

安装并加载技能

使用你管理 skills 的目录工具执行 laravel-patterns install 步骤，例如：npx skills add affaan-m/everything-claude-code --skill laravel-patterns。安装完成后，先打开 skill 的入口文件，这样你在请求代码之前，就能先把 prompt 和它的架构规则对齐。

从正确的输入形状开始

最好的 laravel-patterns usage 总是从一个具体目标开始：某个 feature、route、model 或 bug。把当前 Laravel 版本、你的分层边界，以及你想要的结果告诉 skill。高质量输入可以像这样：“设计一个 Laravel 11 的订单导出流程，分成 controller、action、job 和 resource 层；验证放在 form requests 里；缓存报表列表；不要出现 fat controllers。”

阅读会影响输出质量的文件

对于这份 laravel-patterns guide，优先看 SKILL.md 以及它链接到的示例，然后检查你应用中与目标 pattern 对应的部分：app/Http/Controllers、app/Actions、app/Services、app/Models、app/Http/Resources 和 config/*。如果你的仓库采用了不同的约定，就要顺着现有约定调整 pattern，而不是强行把整个项目都改成一种新结构。

把它放进实际工作流里使用

一个更好的工作流是：先描述 feature，再让它给出架构方案，然后再按文件拆分请求具体代码。这个 skill 最适合让它判断 validation、authorization、query logic、async work 和 API transformation 应该放在哪里。这正是它相较于普通 prompt 最可能提升输出质量的部分。

laravel-patterns 技能 FAQ

laravel-patterns 只适合新项目吗？

不适合。laravel-patterns 技能对已经长成 controller-heavy 或风格不一致的现有应用尤其有用。它也能帮助你做渐进式重构，比如把逻辑迁移到 actions，或在不重写整个应用的情况下补上 resources。

它和普通 Laravel prompt 有什么不同？

普通 prompt 可能也能生成可运行的代码，但 laravel-patterns 给你的架构默认值更强。当地希望 prompt 严格遵循 Laravel 在 routing、Eloquent、queues、events、caching 和 API resources 方面的约定，而不是每次都临场发挥时，它会更合适。

它适合初学者吗？

如果你已经理解 routes、controllers、models 和 requests 这些基础 Laravel 概念，那它是适合的。但如果你是从零开始，需要先补一堂速成课，那它就不太理想，因为这个 skill 默认你已经能判断 pattern 在真实项目中该落在哪里。

什么时候不该用它？

如果你的任务只是一个很小的临时脚本、单文件原型，或者是在非 Laravel 技术栈中工作，就可以跳过 laravel-patterns。如果你的仓库刻意避免分层架构，而且你也不想引入更多结构，那它同样不是合适选择。

如何改进 laravel-patterns 技能

先把架构约束说清楚

最能提升质量的一点，是先说明哪些部分必须保持精简、哪些部分必须异步、哪些部分必须缓存。把你的 Laravel 版本、团队约定、测试框架，以及任何限制都讲明白，比如“不能新增包”、“必须保留现有 routes”或“验证必须使用 form requests”。

要求它先划清边界，而不只是写代码

常见的失败方式，是只提一个 feature，却不说明每项职责该放在哪里。更好的 laravel-patterns usage 会分别要求它说明 controller、request、action/service、model scope、job 和 resource 的职责，这样才能为 laravel-patterns for Backend Development 生成更清晰的分工。

在第一版之后继续迭代

如果第一次回答过于笼统，就让它基于你真实的 model 名称、关系和样例 payload 再收紧一版。最好的 laravel-patterns guide 工作流，是先把架构打磨清楚，再请求文件级代码，最后再补充 authorization、pagination、idempotency 或 queue retries 之类的边界情况。