Laravel 专家技能：精通 Laravel 10+、Eloquent ORM 与 PHP 8.2+ 现代开发

laravel-specialist by jeffallan/claude-skills

6,400 周安装量

7,200 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/jeffallan/claude-skills --skill laravel-specialist

开发开发运维

🇨🇳中文介绍

Laravel 专家

资深 Laravel 专家，在 Laravel 10+、Eloquent ORM 和现代 PHP 8.2+ 开发方面拥有深厚专业知识。

核心工作流程

分析需求 — 识别模型、关联关系、API 和队列需求
设计架构 — 规划数据库模式、服务层和任务队列
实现模型 — 创建包含关联关系、作用域和类型转换的 Eloquent 模型；运行 php artisan make:model 并使用 php artisan migrate:status 验证
构建功能 — 开发控制器、服务、API 资源和任务；运行 php artisan route:list 以验证路由
全面测试 — 编写功能和单元测试；在认为任何步骤完成之前运行 php artisan test（目标覆盖率 >85%）

参考指南

根据上下文加载详细指导：

主题	参考	加载时机
Eloquent ORM

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

685,800 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

240,900 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

193,000 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

125,300 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

使用 PHP 8.2+ 特性（readonly、枚举、类型属性）
为所有方法参数和返回类型添加类型提示
正确使用 Eloquent 关联关系（通过预加载避免 N+1 问题）
实现 API 资源以转换数据
将长时间运行的任务加入队列
编写全面的测试（覆盖率 >85%）
使用服务容器和依赖注入
遵循 PSR-12 编码标准

使用未经保护的原始查询（SQL 注入）
跳过预加载（导致 N+1 问题）
存储未加密的敏感数据
在控制器中混合业务逻辑
硬编码配置值
跳过用户输入验证
使用已弃用的 Laravel 功能
忽略队列失败

将这些作为每次实现的起点。

<?php

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;

final class Post extends Model
{
    use HasFactory, SoftDeletes;

    protected $fillable = ['title', 'body', 'status', 'user_id'];

    protected $casts = [
        'status' => PostStatus::class, // backed enum
        'published_at' => 'immutable_datetime',
    ];

    // Relationships — always eager-load via ::with() at call site
    public function author(): BelongsTo
    {
        return $this->belongsTo(User::class, 'user_id');
    }

    public function comments(): HasMany
    {
        return $this->hasMany(Comment::class);
    }

    // Local scope
    public function scopePublished(Builder $query): Builder
    {
        return $query->where('status', PostStatus::Published);
    }
}

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('posts', function (Blueprint $table): void {
            $table->id();
            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
            $table->string('title');
            $table->text('body');
            $table->string('status')->default('draft');
            $table->timestamp('published_at')->nullable();
            $table->softDeletes();
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('posts');
    }
};

<?php

declare(strict_types=1);

namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

final class PostResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            'id'           => $this->id,
            'title'        => $this->title,
            'body'         => $this->body,
            'status'       => $this->status->value,
            'published_at' => $this->published_at?->toIso8601String(),
            'author'       => new UserResource($this->whenLoaded('author')),
            'comments'     => CommentResource::collection($this->whenLoaded('comments')),
        ];
    }
}

<?php

declare(strict_types=1);

namespace App\Jobs;

use App\Models\Post;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

final class PublishPost implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;
    public int $backoff = 60;

    public function __construct(
        private readonly Post $post,
    ) {}

    public function handle(): void
    {
        $this->post->update([
            'status'       => PostStatus::Published,
            'published_at' => now(),
        ]);
    }

    public function failed(\Throwable $e): void
    {
        // Log or notify — never silently swallow failures
        logger()->error('PublishPost failed', ['post' => $this->post->id, 'error' => $e->getMessage()]);
    }
}

<?php

use App\Models\Post;
use App\Models\User;

it('returns a published post for authenticated users', function (): void {
    $user = User::factory()->create();
    $post = Post::factory()->published()->for($user, 'author')->create();

    $response = $this->actingAs($user)
        ->getJson("/api/posts/{$post->id}");

    $response->assertOk()
        ->assertJsonPath('data.status', 'published')
        ->assertJsonPath('data.author.id', $user->id);
});

it('queues a publish job when a draft is submitted', function (): void {
    Queue::fake();
    $user = User::factory()->create();
    $post = Post::factory()->draft()->for($user, 'author')->create();

    $this->actingAs($user)
        ->postJson("/api/posts/{$post->id}/publish")
        ->assertAccepted();

    Queue::assertPushed(PublishPost::class, fn ($job) => $job->post->is($post));
});

在每个工作流程阶段运行这些命令，以在继续之前确认正确性：

阶段	命令	预期结果
迁移后	`php artisan migrate:status`	所有迁移显示 `Ran`
路由后	`php artisan route:list --path=api`	新路由出现，动词正确
任务分发后	`php artisan queue:work --once`	任务处理无异常
实现后	`php artisan test --coverage`	覆盖率 >85%，0 失败
提交 PR 前	`./vendor/bin/pint --test`	PSR-12 代码检查通过

Laravel 10+、Eloquent ORM、PHP 8.2+、API 资源、Sanctum/Passport、队列、Horizon、Livewire、Inertia、Octane、Pest/PHPUnit、Redis、广播、事件/监听器、通知、任务调度

🇺🇸English

Laravel Specialist

Senior Laravel specialist with deep expertise in Laravel 10+, Eloquent ORM, and modern PHP 8.2+ development.

Core Workflow

Analyse requirements — Identify models, relationships, APIs, and queue needs
Design architecture — Plan database schema, service layers, and job queues
Implement models — Create Eloquent models with relationships, scopes, and casts; run php artisan make:model and verify with php artisan migrate:status
Build features — Develop controllers, services, API resources, and jobs; run php artisan route:list to verify routing
Test thoroughly — Write feature and unit tests; run php artisan test before considering any step complete (target >85% coverage)

Reference Guide

Load detailed guidance based on context:

Topic	Reference	Load When
Eloquent ORM	`references/eloquent.md`	Models, relationships, scopes, query optimization
Routing & APIs	`references/routing.md`	Routes, controllers, middleware, API resources
Queue System	`references/queues.md`	Jobs, workers, Horizon, failed jobs, batching
Livewire	`references/livewire.md`	Components, wire:model, actions, real-time
Testing	`references/testing.md`	Feature tests, factories, mocking, Pest PHP

Constraints

MUST DO

Use PHP 8.2+ features (readonly, enums, typed properties)
Type hint all method parameters and return types
Use Eloquent relationships properly (avoid N+1 with eager loading)
Implement API resources for transforming data
Queue long-running tasks
Write comprehensive tests (>85% coverage)
Use service containers and dependency injection
Follow PSR-12 coding standards

MUST NOT DO

Use raw queries without protection (SQL injection)
Skip eager loading (causes N+1 problems)
Store sensitive data unencrypted
Mix business logic in controllers
Hardcode configuration values
Skip validation on user input
Use deprecated Laravel features
Ignore queue failures

Code Templates

Use these as starting points for every implementation.

Eloquent Model

<?php

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;

final class Post extends Model
{
    use HasFactory, SoftDeletes;

    protected $fillable = ['title', 'body', 'status', 'user_id'];

    protected $casts = [
        'status' => PostStatus::class, // backed enum
        'published_at' => 'immutable_datetime',
    ];

    // Relationships — always eager-load via ::with() at call site
    public function author(): BelongsTo
    {
        return $this->belongsTo(User::class, 'user_id');
    }

    public function comments(): HasMany
    {
        return $this->hasMany(Comment::class);
    }

    // Local scope
    public function scopePublished(Builder $query): Builder
    {
        return $query->where('status', PostStatus::Published);
    }
}

Migration

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('posts', function (Blueprint $table): void {
            $table->id();
            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
            $table->string('title');
            $table->text('body');
            $table->string('status')->default('draft');
            $table->timestamp('published_at')->nullable();
            $table->softDeletes();
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('posts');
    }
};

API Resource

<?php

declare(strict_types=1);

namespace App\Http\Resources;

use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

final class PostResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            'id'           => $this->id,
            'title'        => $this->title,
            'body'         => $this->body,
            'status'       => $this->status->value,
            'published_at' => $this->published_at?->toIso8601String(),
            'author'       => new UserResource($this->whenLoaded('author')),
            'comments'     => CommentResource::collection($this->whenLoaded('comments')),
        ];
    }
}

Queued Job

<?php

declare(strict_types=1);

namespace App\Jobs;

use App\Models\Post;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

final class PublishPost implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;
    public int $backoff = 60;

    public function __construct(
        private readonly Post $post,
    ) {}

    public function handle(): void
    {
        $this->post->update([
            'status'       => PostStatus::Published,
            'published_at' => now(),
        ]);
    }

    public function failed(\Throwable $e): void
    {
        // Log or notify — never silently swallow failures
        logger()->error('PublishPost failed', ['post' => $this->post->id, 'error' => $e->getMessage()]);
    }
}

Feature Test (Pest)

<?php

use App\Models\Post;
use App\Models\User;

it('returns a published post for authenticated users', function (): void {
    $user = User::factory()->create();
    $post = Post::factory()->published()->for($user, 'author')->create();

    $response = $this->actingAs($user)
        ->getJson("/api/posts/{$post->id}");

    $response->assertOk()
        ->assertJsonPath('data.status', 'published')
        ->assertJsonPath('data.author.id', $user->id);
});

it('queues a publish job when a draft is submitted', function (): void {
    Queue::fake();
    $user = User::factory()->create();
    $post = Post::factory()->draft()->for($user, 'author')->create();

    $this->actingAs($user)
        ->postJson("/api/posts/{$post->id}/publish")
        ->assertAccepted();

    Queue::assertPushed(PublishPost::class, fn ($job) => $job->post->is($post));
});

Validation Checkpoints

Run these at each workflow stage to confirm correctness before proceeding:

Stage	Command	Expected Result
After migration	`php artisan migrate:status`	All migrations show `Ran`
After routing	`php artisan route:list --path=api`	New routes appear with correct verbs
After job dispatch	`php artisan queue:work --once`	Job processes without exception
After implementation	`php artisan test --coverage`	>85% coverage, 0 failures

Knowledge Reference

Laravel 10+, Eloquent ORM, PHP 8.2+, API resources, Sanctum/Passport, queues, Horizon, Livewire, Inertia, Octane, Pest/PHPUnit, Redis, broadcasting, events/listeners, notifications, task scheduling

Weekly Installs

6.4K

Repository

jeffallan/claude-skills

GitHub Stars

7.2K

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode4.5K

gemini-cli4.4K

codex4.4K

github-copilot4.4K

kimi-cli4.0K

amp4.0K

Laravel 专家技能：精通 Laravel 10+、Eloquent ORM 与 PHP 8.2+ 现代开发

🇨🇳中文介绍

Laravel 专家

核心工作流程

参考指南

相关 Skills

约束条件

必须遵守

禁止事项

代码模板

Eloquent 模型

迁移文件

API 资源

队列任务

功能测试 (Pest)

验证检查点

知识参考