mcpField
L
laravel:using-laravel-superpowers

laravel:using-laravel-superpowers

github.com/jpcaparasAgent 工作流157121 次安装17 周前更新
代码仓库

关于 laravel:using-laravel-superpowers

面向 Laravel 项目的平台无关技能,为使用或不使用 Sail 的项目提供框架相关指导,并围绕测试、数据库变更、质量检查、队列和架构组织工作流。

主要功能

  1. 01选择 Sail 或主机命令
  2. 02TDD 与数据库工作流指导
  3. 03质量检查流程参考
  4. 04队列与 Horizon 指导
  5. 05架构与复杂度约束

适用场景

  1. 01选择 Laravel 命令的运行方式
  2. 02在 Laravel 变更中采用 TDD
  3. 03为迁移或队列选择相关指导
  4. 04完成前检查代码质量

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jpcaparas/superpowers-laravel --skill laravel:using-laravel-superpowers

安装后在 Claude Code 中输入/laravel:using-laravel-superpowers确认已加载。

详细介绍

在 Laravel 项目中使用 Superpowers

此插件会提供适用于 Laravel 的指导,同时保持平台无关。它适用于任何 Laravel 应用,无论是否使用 Sail。

运行器选择(Sail 或非 Sail)

运行命令时,使用以下最简包装器:

# Prefer Sail if available, else fall back to host
alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'

# Example (both work depending on environment)
sail artisan test           # with Sail
php artisan test            # without Sail
sail composer require x/y   # with Sail
composer require x/y        # without Sail

参阅 laravel:runner-selection 技能,了解检测技巧、成对命令和安全说明。

核心工作流

  • 优先采用测试驱动开发:使用 laravel:tdd-with-pest
  • 数据库变更:使用 laravel:migrations-and-factories
  • 质量检查:使用 laravel:quality-checks(Pint、Insights/PHPStan)
  • 队列和 Horizon:使用 laravel:queues-and-horizon
  • 架构模式:laravel:ports-and-adapters、laravel:template-method-and-plugins
  • 控制复杂度:laravel:complexity-guardrails

理念

  • 优先采用小型、可测试的服务;避免臃肿的控制器、命令和作业
  • 在有助于明确意图时使用 DTO、类型化 Collection 和 Enum
  • 测试中优先使用模型工厂,复杂查询优先使用模型作用域
  • 完成前先验证——确保测试和代码检查均通过

按需使用斜杠命令:

/superpowers-laravel:brainstorm
/superpowers-laravel:write-plan
/superpowers-laravel:execute-plan

如果存在适用于你当前任务的 Laravel 技能,请严格按照其说明操作。

评论

支持 Markdown