Recommended Skills for Laravel Projects
本文包含AI辅助创作内容
Laravel 项目推荐 Skills
codex开放时最佳,已经再laravel的项目中使用codex开发实践。
1. 新项目初始化
对应 skill:
laravel-new-project-init
新项目最容易漏的,往往不是代码,而是默认配置。
中文项目里常见的几项可以提前处理掉:
APP_TIMEZONE=Asia/Shanghai
APP_LOCALE=zh_CN
APP_FAKER_LOCALE=zh_CN
再顺手检查 PHP、Composer、Laravel Installer、Node / NPM 或 Bun。项目多了以后,这种统一会省掉不少零碎沟通。
2. Artisan 命令安全
对应 skill:
laravel-ai-coding-safety
Laravel 有些命令不能随手跑,尤其是项目连着真实数据库时。
php artisan db:wipe
php artisan migrate:fresh
php artisan migrate:rollback
php artisan db:seed
这个 skill 的思路很简单:高危命令默认拦住,真要执行再显式放行。
ALLOW_DB_DESTRUCTIVE_COMMANDS=true php artisan migrate:fresh
这类保护不显眼,但真出过一次事故,就会知道它值。
3. 数据库 Schema 同步
对应 skill:
laravel-sync-database-schema
老项目里,表结构经常比代码更接近真相。
把 MySQL 结构同步到项目里的 .schema/,排查和改代码时会方便很多:
.schema/
├── README.md
├── users.md
└── orders.md
以后遇到字段、索引、关联关系的问题,先看 .schema/,少猜一点。
它不是 migration 的替代品,只是数据库现状的一份镜像。
4. 统一 API 响应
对应 skill:
laravel-unified-api-response
接口项目写久了,返回格式很容易散。
可以收成一套固定结构:
{
"status": 0,
"message": "success",
"notice": "",
"values": {}
}
重点不只是成功返回。校验失败、登录失效、权限不足、业务异常这些入口,也要一起看。不然前端还是要到处做兼容。
5. 定时任务耗时统计
对应 skill:
laravel-scheduler-timing-metrics
定时任务平时安静,出问题时很难补现场。
与其在每个 Command 里手写计时,不如在调度入口统一挂回调:
before
after
onSuccess
onFailure
先把任务名、表达式、开始时间、耗时、成功失败记下来。没有监控系统也没关系,先落日志就够用。
6. Laravel Boost
对应工具:
composer require laravel/boost --dev
php artisan boost:install
Boost 适合做基础层。它能提供 Laravel 版本、数据库结构、日志、模型、官方文档等项目上下文。
我的习惯是这样分:
Boost:补 Laravel 和项目现场信息
自定义 skills:补团队自己的工程约定
一个管上下文,一个管规矩,刚好互补。
7. 质量检查
可以围绕这几个工具整理:
Pint
Larastan
Pest
Pint 管格式,Larastan 管静态分析,Pest 管测试。
可以做一个简单的 laravel-quality-gate:
改完代码后:
1. 看项目有没有 Pint、Larastan、Pest
2. 优先检查本次改动相关范围
3. 涉及接口时补 feature test
4. 测试不方便跑时说清楚原因
这里不需要设计得很复杂。关键是改完别直接收工。
8. 我会怎么排
老项目可以先放这几项:
1. Artisan 命令安全
2. 数据库 Schema 同步
3. 统一 API 响应
4. 定时任务耗时统计
5. Laravel Boost
6. Pint / Larastan / Pest
新项目就把“新项目初始化”放到最前面。
官方文档位置:
- Laravel Boost:
https://laravel.com/docs/13.x/boost - Laravel Pint:
https://laravel.com/docs/13.x/pint - Larastan:
https://github.com/larastan/larastan - Pest Laravel 插件:
https://pestphp.com/docs/plugins#laravel

请先 登录后发表评论 ~