Créer une couche service API

VérifiéSûr

Crée les types, contrats, adaptateur et couche de service pour une ressource conforme aux sections 4.1-4.3 de l'architecture du projet. À utiliser lors de l'ajout d'une intégration API à un module. Il demande les détails du point de terminaison et génère l'ensemble de la couche de données avec une séparation stricte entre les types API et les contrats application.

Spar Skills Guide Bot
DeveloppementIntermédiaire
7002/06/2026
Claude Code
#api-integration#data-layer#types#adapters#services

Recommandé pour

Notre avis

Crée la couche de données complète (types, contrats, adaptateur et service) pour une ressource API en suivant l'architecture du projet.

Points forts

  • Respecte la séparation des responsabilités
  • Génère un code cohérent et réutilisable
  • Valide avec TypeScript
  • Suit l'architecture définie

Limites

  • Nécessite une spécification claire de l'API
  • Peut ne pas gérer les imbrications complexes
  • Suppose un client HTTP de type Angular
Quand l'utiliser

Lors de l'ajout d'une intégration API à un module Angular respectant l'architecture du projet.

Quand l'éviter

Lorsque le projet n'utilise pas cette architecture ou pour des appels API très simples nécessitant peu de code.

Analyse de sécurité

Sûr
Score qualité85/100

The skill generates TypeScript source files based on user input and runs a non-destructive TypeScript compilation check. It does not execute external commands, download scripts, or access sensitive data. All tools used (Read, Write, Edit, Bash for tsc, Glob, Grep) are for legitimate local code generation and validation.

Aucun point d'attention détecté

Exemples

Add user API integration
Use dev-create-service for User resource. Endpoint: /api/users, response: { id: number, name: string, email: string }. Operations: GET list, GET by ID, POST.
Add product API integration
Create service for Product. Base URL: /api/products. Response: { id: number, title: string, price: number, category: string }. Operations: GET list, GET by ID, PATCH, DELETE.
Add orders API integration
Add data layer for Order resource. Endpoint: /api/orders. Response: { id: number, customer_id: number, items: { product_id: number, quantity: number }[], status: string }. Operations: GET list, POST.

name: dev-create-service description: "Use when adding API integration to a module - creates types, contracts, adapter, and service layer." user-invocable: true argument-hint: "[resource-name]" allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Create the complete data layer for a resource following docs/ARCHITECTURE.md sections 4.1-4.3.

Resource: $ARGUMENTS

Steps

  1. Read docs/ARCHITECTURE.md sections 4.1 (Services), 4.2 (Adapters), 4.3 (Types).

  2. Ask the user:

    • What is the endpoint base URL? (e.g. /api/marketplace)
    • What is the response JSON format? (ask for an example or describe the fields)
    • Which operations? (GET list, GET by ID, POST, PATCH, DELETE)
  3. Create in order:

    a. types/[resource].types.ts -- mirrors API exactly (snake_case) b. types/[resource].contracts.ts -- app contract (camelCase, correct types) c. adapters/[resource].adapter.ts -- inbound (API->App) + outbound (App->API) d. services/[resource].service.ts -- HttpClient only, inject(HttpClient), @Injectable({ providedIn: 'root' })

  4. Required rules:

    • Service: NO try/catch, NO .map()/.filter()/new Date()
    • Adapter: pure functions, no side effects
    • Types separated: .types.ts (API) != .contracts.ts (App)
  5. Validate: npx tsc --noEmit

Skills similaires