SuperAPI AI 工具集

spatie-guidelines

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:在编写或审查 PHP、Laravel、JavaScript、Vue 代码时套用 Spatie 的编码约定,核心原则是按 Laravel 本意来写,若偏离需有清晰理由。

主要能力:涵盖 PHP 风格(类型系统、可空写法、void 返回、构造器属性提升、docblock 规则)、代码风格(PSR-1/2/12、字符串插值、枚举 PascalCase、禁止单字母变量、避免 private const)、控制流(提前返回、避免 else、拆解复合 if、大括号)、注释(代码自解释,仅解释原因)、Laravel 约定(配置 kebab-case 文件名与 snake_case 键、不在 config 外用 env()、路由与 API 路由命名、控制器 CRUD 关键词与可调用控制器、Blade、数组式验证、授权与迁移、Artisan 命令输出规范)、类命名表与常见错误清单。

使用方式:按需查阅详细引用文件——包架构 references/package-architecture.md、Pest 测试 references/testing-pest.md、Git 工作流 references/version-control.md、Laravel 与 PHP 深入 references/laravel-php.md、JavaScript references/javascript.md、新项目搭建 references/new-project-setup.md。

限制:资料未提供安装命令、版本信息、许可证或适用平台等;该内容为团队内部约定,并非通用强制标准。