Communitygithub.com

AlizHarb/agent-skills

Une collection croissante de compétences d'agent de haute qualité pour les assistants de codage IA. Améliorez Codex, Claude Code, Cursor, Gemini CLI et les agents compatibles avec des connaissances spécialisées pour Laravel, l'architecture logicielle, le débogage, les tests, la sécurité, la qualité du code, la documentation et les bonnes pratiques d'ingénierie.

Qu'est-ce que agent-skills ?

Cette compétence d'agent, nommée AlizHarb/agent-skills, est une bibliothèque en pleine expansion de compétences spécialisées conçues pour les assistants de codage IA comme Codex, Claude Code, Cursor, Gemini CLI et d'autres agents compatibles. Elle fournit des directives et des workflows précis pour des tâches de développement courantes, telles que la création de Data Transfer Objects (DTOs) dans des projets Laravel. L'utilité principale réside dans la standardisation et l'automatisation des décisions architecturales : la compétence dicte l'utilisation du package Spatie Laravel Data, privilégie les classes immutables `final readonly`, applique des attributs de validation et de transformation, et impose des règles architecturales comme l'indépendance vis-à-vis du client et l'absence de logique métier. Elle inclut un flux de travail détaillé, une checklist de revue, des exigences de test et des exemples de code, ce qui permet aux développeurs de produire des DTOs cohérents, typés et réutilisables entre les API, Livewire, les jobs et les commandes.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add AlizHarb/agent-skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Créer un DTO ou Objet de Données

Quand l'utiliser

Utilisez cette compétence lorsque des données franchissent une frontière ou doivent être réutilisées par le web, l'API, Livewire, les jobs, les commandes ou les intégrations.

Entrées nécessaires

  • Champs, types, règles de validation, frontières de source, consommateurs de sortie, valeurs par défaut et besoins de sérialisation.

Workflow

  1. Inspectez les conventions existantes des objets de données.
  2. Utilisez Spatie Laravel Data par défaut maintenant qu'il est installé. Si un style de données différent existe déjà dans un module voisin, suivez la convention locale.
  3. Préférez final readonly class avec promotion de propriété de constructeur pour les DTOs immuables.
  4. Utilisez les attributs Spatie Data là où ils correspondent à la propriété :
    • #[MapInputName]
    • #[MapOutputName]
    • #[WithCast]
    • #[WithTransformer]
    • #[Computed]
    • #[ValidationAttribute] ou les attributs de validation du package
    • #[DataCollectionOf]
    • #[Lazy]
    • #[Hidden]
    • #[LoadRelation] et #[LoadMissing]
    • #[Inject] ou les attributs d'injection de propriété lorsque le package ou la convention du projet les utilise.
  5. Utilisez des enums pour les ensembles fermés et des constantes de classe typées pour les contrats scalaires réutilisables.
  6. Gardez les DTOs indépendants du client.
  7. Ajoutez des constructeurs nommés comme fromArray, fromRequest ou fromModel uniquement lorsque c'est utile.
  8. Placez les règles de validation près des DTOs lorsque la convention du projet le permet.
  9. Évitez la persistance, l'autorisation ou la logique de workflow.
  10. Ajoutez des tests pour la construction, les règles de validation, la sérialisation et les cas limites.

Fichiers pouvant être créés

  • app/Data/*.php, app/DTOs/*.php, ou l'équivalent local existant.
  • Tests DTO.

Fichiers pouvant être modifiés

  • Formulaires de requête, Actions, Ressources, composants Livewire, contrôleurs, jobs et tests.

Règles d'architecture

  • Les DTOs représentent des contrats d'entrée ou de sortie.
  • Les DTOs prennent en charge la réutilisation par l'API et l'interface utilisateur.
  • Les DTOs ne doivent pas dépendre de Livewire, Blade, des contrôleurs ou des réponses.
  • Les DTOs doivent utiliser le typage PHP moderne plutôt que des tableaux non structurés lorsque cela est pratique.
  • Utilisez les collections/ressources Spatie Data lorsqu'une fonctionnalité nécessite des formes de données imbriquées, transformées ou réutilisables.
  • Privilégiez les attributs de validation Spatie Data avant la validation ad hoc de tableaux dans du code réutilisable.

Exigences de test

  • Testez les champs obligatoires, la conversion de types, les valeurs par défaut, les données invalides et la sérialisation si elle est exposée.

Exigences de sécurité

  • Ne faites pas confiance à la construction de DTO comme autorisation.
  • Évitez d'inclure des champs sensibles dans les DTOs de sortie, sauf si cela est explicitement voulu.

Liste de vérification de révision

  • Le DTO est-il stable et indépendant du client ?
  • Les champs sont-ils typés ?
  • Les règles de validation sont-elles suffisamment proches pour rester synchronisées ?

Exemples

Bon exemple

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,
    ) {}
}

Mauvais exemple

// ❌ Mauvaise sécurité de typage, pas de contexte de validation, difficile à réutiliser dans les jobs d'arrière-plan.
class RegisterController extends Controller
{
    public function store(Request $request)
    {
        $this->action->handle($request->all());
    }
}

Skills associés