MMCPMarkets
SL

streeboga/laravel-api-skill

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

22 stars Качество 67 Тренд 30MIT
Repository Install

Laravel API Production-Ready Architecture — JSON:API v1.1

Обзор

Открытая платформа EQ - PUBEC Навык для агентов кодирования ИИ (Claude Code, Cursor, Copilot и т. Д.), Который обеспечивает архитектурную дисциплину в проектах API Laravel: JSON:API v1.1, многоуровневая архитектура, строгие типы, полный охват тестов. При первом использовании навык автоматически проверяет CLAUDE.md вашего проекта: - - Создает один из шаблонов / CLAUDE.md с правилами архитектуры Laravel - - Добавляет раздел Laravel - - Обычно работает Шаблон CLAUDE.md действует как — он обнаруживает, что вы делаете (создаете объект, просматриваете код, пишете тесты) и заставляет агента читать правильные справочные файлы перед написанием любого кода. При активации навык обеспечивает строгую многоуровневую архитектуру для каждого проекта Laravel API: Попросите агента создать новый объект, и он будет генерировать следующее: 1. Migration 2. Model (с открытыми ключами ULID) 3. Enum(s) 4. Create DTO + Update DTO (Spatie Data) 5. Store Request + Update Request (с toDto()) 6. QueryBuilder 7.

Обзор (машинный перевод)

Открытая платформа EQ - PUBEQ

Читать дальше .RU (README.ru.md)

Навык для агентов кодирования ИИ (Claude Code, Cursor, Copilot и т. Д.), Который обеспечивает архитектурную дисциплину в проектах API Laravel: JSON:API v1.1, многоуровневая архитектура, строгие типы, полный охват тестов.

##Установка

Шаг 1: Установите навык

Шаг 2: Настройка CLAUDE.md (автоматический)

При первом использовании навык автоматически проверяет ваш проект: ** No CLAUDE.md?** - Создает из templates/CLAUDE.md с правилами архитектуры Laravel CLAUDE.md существует, но нет раздела Laravel? Добавить раздел Laravel -Уже настроены? Как правило, идет

Шаблон CLAUDE.md действует как фазовый диспетчер — он обнаруживает, что вы делаете (создаете объект, просматриваете код, пишете тесты) и заставляет агента читать правильные справочные файлы перед написанием любого кода.

Ручная настройка (альтернативная)

Если вы предпочитаете устанавливать его вручную:

Или добавить к существующему CLAUDE.md:

Что это делает

При активации навык обеспечивает строгую многоуровневую архитектуру для каждого проекта Laravel API:

Границы слоев

Слой, который не делает [скрыто] [скрыто] [скрыто] [скрыто] [скрыто]

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Laravel API Production-Ready Architecture Skill

Открытый проект EQ Platform — страница проекта

Читать на русском (README.ru.md)

A skill for AI coding agents (Claude Code, Cursor, Copilot, etc.) that enforces architectural discipline in Laravel API projects: JSON:API v1.1, layered architecture, strict types, full test coverage.

Installation

Step 1: Install the skill

npx skills add streeboga/laravel-api-skill

Step 2: Setup CLAUDE.md (automatic)

On first use, the skill automatically checks your project’s CLAUDE.md:

  • No CLAUDE.md? — Creates one from templates/CLAUDE.md with Laravel architecture rules
  • CLAUDE.md exists but no Laravel section? — Appends the Laravel section
  • Already configured? — Proceeds normally

The CLAUDE.md template acts as a phase dispatcher — it detects what you’re doing (creating an entity, reviewing code, writing tests) and forces the agent to read the correct reference files before writing any code.

Manual setup (alternative)

If you prefer to set it up manually:

# Copy the template to your project root
cp ~/.claude/skills/laravel-api/templates/CLAUDE.md ./CLAUDE.md

Or append to an existing CLAUDE.md:

cat ~/.claude/skills/laravel-api/templates/CLAUDE.md >> ./CLAUDE.md

What It Does

When activated, the skill enforces a strict layered architecture for every Laravel API project:

HTTP Request → Route → Middleware → Controller → Service → Repository → QueryBuilder → Model → DB
Response    ← JsonApiResource      ← Service   ← Repository ← QueryBuilder

Layer Boundaries

Layer Does Does NOT
Controller Accept request, call Service, return JsonApiResource Access DB, inject Repository/Model, contain logic
Service Business logic, transactions, events, caching Query DB directly, grow into God Class
Repository CRUD operations, delegates queries to QueryBuilder Contain business logic
QueryBuilder Scopes, filters, sorts, eager loading, pagination Contain CRUD or business logic
Model Relations, casts, accessors. NO scopes Contain scopeXxx() methods
DTO Type-safe data transfer between layers –
JsonApiResource Transform model to JSON:API format –
Enum All constants, statuses, cache keys –

New Entity Generation

Ask the agent to create a new entity and it generates 14 files following the architecture:

  1. Migration
  2. Model (with ULID public keys)
  3. Enum(s)
  4. Create DTO + Update DTO (readonly classes)
  5. Store Request + Update Request (with toDto())
  6. QueryBuilder
  7. Repository (interface only with a second implementation)
  8. Service
  9. Controller (thin, JSON:API compliant)
  10. JsonApiResource
  11. Routes (versioned, PATCH for updates)
  12. Feature Tests

Code Review

Открыть полный README на GitHub

Рекомендуемые инструменты

Попробуйте другой запрос или уберите фильтр.

Установка

npx skillfish add streeboga/laravel-api-skill
Новичок в MCP? Начните с руководства на mcpskill.org →