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