Communitygithub.com

AlizHarb/agent-skills

Eine wachsende Sammlung hochwertiger Agenten-Fähigkeiten für KI-gestützte Codierungsassistenten. Verbessere Codex, Claude Code, Cursor, Gemini CLI und kompatible Agenten mit spezialisiertem Wissen für Laravel, Softwarearchitektur, Debugging, Tests, Sicherheit, Codequalität, Dokumentation und bewährte Methoden im Ingenieurwesen.

Was ist agent-skills?

Diese Fähigkeit (Skill) namens "Create DTO Or Data Object" ist Teil der "AlizHarb/agent-skills"-Sammlung und befähigt KI-Codierungsassistenten wie Claude Code, Cursor, Codex, Gemini CLI und andere, Datenübertragungsobjekte (DTOs) oder Data-Objekte in Laravel-Projekten zu erstellen. Sie ist besonders nützlich, wenn Daten eine Grenze überschreiten – etwa zwischen Web, API, Livewire, Jobs, Commands oder Integrationen. Der Skill nutzt standardmäßig das Spatie Laravel Data-Paket, passt sich aber lokalen Konventionen an, falls ein anderes DTO-Stil bereits im Projekt existiert. Er priorisiert unveränderliche (`final readonly class`) DTOs mit Constructor Property Promotion und empfiehlt eine Reihe von Spatie-Data-Attributen für Mapping, Casting, Validierung und Serialisierung. Die erstellten DTOs sollten client-unabhängig sein, keine Persistenz, Autorisierung oder Workflow-Logik enthalten und mit Tests für Konstruktion, Validierungsregeln, Serialisierung und Randfälle abgesichert werden. Der Skill verbessert die Codequalität, Typensicherheit und Wiederverwendbarkeit in Laravel-Anwendungen, indem er strukturierte, typsichere Datenverträge fördert und die Integration zwischen verschiedenen Schichten der Anwendung vereinfacht.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add AlizHarb/agent-skills

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

DTO oder Datenobjekt erstellen

Wann verwenden

Verwende diesen Skill, wenn Daten eine Grenze überschreiten oder von Web, API, Livewire, Jobs, Commands oder Integrationen wiederverwendet werden müssen.

Benötigte Eingaben

  • Felder, Typen, Validierungsregeln, Quellgrenzen, Ausgabekonsumenten, Standardwerte und Serialisierungsanforderungen.

Arbeitsablauf

  1. Untersuche bestehende Datenobjekt-Konventionen.
  2. Verwende standardmäßig Spatie Laravel Data, da es jetzt installiert ist. Falls in einem nahegelegenen Modul bereits ein anderer Datenstil existiert, folge der lokalen Konvention.
  3. Bevorzuge final readonly class mit Constructor Property Promotion für unveränderliche DTOs.
  4. Verwende Spatie-Data-Attribute, wo sie zur Eigenschaft passen:
    • #[MapInputName]
    • #[MapOutputName]
    • #[WithCast]
    • #[WithTransformer]
    • #[Computed]
    • #[ValidationAttribute] oder Paket-Validierungsattribute
    • #[DataCollectionOf]
    • #[Lazy]
    • #[Hidden]
    • #[LoadRelation] und #[LoadMissing]
    • #[Inject] oder Property-Injection-Attribute, wenn das Paket oder die Projektkonvention sie verwendet
  5. Verwende Enums für geschlossene Mengen und typisierte Klassenkonstanten für wiederverwendbare skalare Verträge.
  6. Halte DTOs client-unabhängig.
  7. Füge benannte Konstruktoren wie fromArray, fromRequest oder fromModel nur hinzu, wenn sie nützlich sind.
  8. Platziere Validierungsregeln in der Nähe von DTOs, wenn die Projektkonvention dies unterstützt.
  9. Vermeide Persistenz-, Autorisierungs- oder Workflow-Logik.
  10. Füge Tests für Konstruktion, Validierungsregeln, Serialisierung und Randfälle hinzu.

Dateien, die erstellt werden können

  • app/Data/*.php, app/DTOs/*.php oder das vorhandene lokale Äquivalent.
  • DTO-Tests.

Dateien, die geändert werden können

  • Form Requests, Actions, Resources, Livewire-Komponenten, Controller, Jobs und Tests.

Architekturregeln

  • DTOs repräsentieren Eingabe- oder Ausgabeverträge.
  • DTOs unterstützen die Wiederverwendung in API und UI.
  • DTOs dürfen nicht von Livewire, Blade, Controllern oder Responses abhängen.
  • DTOs sollten wann immer möglich moderne PHP-Typisierung anstelle von unstrukturierten Arrays verwenden.
  • Verwende Spatie Data Collections/Resources, wenn ein Feature verschachtelte, transformierte oder wiederverwendbare Datenstrukturen benötigt.
  • Bevorzuge Spatie Data-Validierungsattribute vor ad hoc Array-Validierung in wiederverwendbarem Code.

Testanforderungen

  • Teste erforderliche Felder, Typkonvertierung, Standardwerte, ungültige Daten und Serialisierung, falls diese offengelegt wird.

Sicherheitsanforderungen

  • Vertraue der DTO-Konstruktion nicht als Autorisierung.
  • Vermeide sensible Felder in Ausgabe-DTOs, es sei denn, sie sind ausdrücklich beabsichtigt.

Überprüfungs-Checkliste

  • Ist das DTO stabil und client-unabhängig?
  • Sind die Felder typisiert?
  • Sind die Validierungsregeln nah genug, um synchron zu bleiben?

Beispiele

Gutes Beispiel

namespace App\Data;

use Spatie\LaravelData\Data;
use Spatie\LaravelData\Attributes\Validation\Email;
use Spatie\LaravelData\Attributes\Validation\Required;
use Spatie\LaravelData\Attributes\Validation\Max;

final readonly class RegisterUserData extends Data
{
    public function __construct(
        #[Required, Max(255)]
        public string $name,

        #[Required, Email]
        public string $email,
    ) {}
}

Schlechtes Beispiel

// ❌ Schlechte Typsicherheit, kein Validierungskontext, schwer in Hintergrund-Jobs wiederverwendbar.
class RegisterController extends Controller
{
    public function store(Request $request)
    {
        $this->action->handle($request->all());
    }
}

Verwandte Skills