AgentSkillsCN

laravel-development

Laravel 12开发工作流、规范与本仓库的常见陷阱。当您需要实现或审查Laravel功能（迁移、Eloquent模型/关联、控制器、路由、验证、策略、队列、服务提供者、配置），或在编写Pest测试、修复Laravel特有的问题时，可选用此方案。

SKILL.md
--- frontmatter
name: laravel-development
description: >-
  Laravel 12 development workflow, conventions, and pitfalls for this repo. Use when
  implementing or reviewing Laravel features (migrations, Eloquent models/relations,
  controllers, routing, validation, policies, queues, service providers, config),
  or when writing Pest tests and fixing Laravel-specific issues.

Laravel Development

Workflow

  1. •Follow project conventions and Laravel 12 structure.
  2. •Use Boost docs search for framework or package questions.
  3. •Prefer framework-native patterns (Eloquent, Form Requests, policies, resources).
  4. •Prevent N+1 queries with eager loading and Model::preventLazyLoading() in dev.
  5. •Add declare(strict_types=1); to all PHP files.
  6. •Write or update Pest tests for behavior changes.

Database & Models

  • •Prefer Eloquent relationships and query scopes over raw DB:: usage.
  • •Add indexes for frequently queried columns.
  • •Use the casts() method for cast definitions.
  • •Add cascade deletes where orphaned rows are invalid.
  • •Ensure migrations include full column definitions when altering columns.

HTTP, Validation, Authorization

  • •Use Form Request classes for validation; include custom messages.
  • •Use policies/gates for authorization checks.
  • •Prefer named routes and the route() helper.

Testing (Pest)

  • •Create tests with php artisan make:test --pest.
  • •Use factories for model setup and avoid hardcoded dates.
  • •Use assertSuccessful(), assertForbidden(), etc. instead of raw status codes.

Performance & UX

  • •Avoid lazy loading in non-production.
  • •Eager load nested relationships and apply query limits for dashboards.

Lessons Learned

  • •Append new lessons and do/don't guidance to references/lessons.md with a date and short context.