Spécifications d'abord, c'était hier. Bienvenue aux Compétences d'abord.

Il s'agit d'une série en 10 parties expliquant comment Apidog a développé Apidog CLI, un outil en ligne de commande pour le test d'API et la gestion du cycle de vie des API. Lisez-les dans l'ordre ou accédez à la publication qui vous intéresse :

Le développement d'API évolue avec les agents IA. Le Skill-First regroupe les spécifications, les tests et les scénarios en compétences exécutables et vérifiables, complétant ainsi les approches existantes pour l'ère des agents.

L'ère du Spec-First

Pendant des années, les processus de collaboration de nombreuses équipes de développement étaient Spec-First.

Ce que c'était

La valeur

Le Spec-First était la bonne approche pour le développement d'API piloté par l'humain.

Le nouveau consommateur : les agents IA

Après l'apparition du codage IA, les consommateurs d'actifs d'API ont changé.

Les agents ont également commencé à consommer ces actifs.

Ce dont les agents ont besoin

Dans ce contexte, la documentation API, les cas de test et les scénarios de test dans Apidog ne sont pas seulement des matériaux de collaboration pour les humains.

Ce sont des actifs appelables de manière déterministe pour les agents.

Transformation des actifs

Les actifs passent de "lisibles" à "appelables".

Définition du Skill-First

S'appuyant sur le Spec-First :

De plus :

Skill-First = Spec-First + couche d'exécution de l'agent.

L'architecture du système

Chaque couche a un rôle spécifique.

Comment ils fonctionnent ensemble

Utilisateur : "Générer des tests pour l'API de remboursement et exécuter la vérification"
        ↓
Agent : Comprend le type de tâche (SKILL aide)
        ↓
Agent : Appelle le CLI pour lire les points de terminaison (le CLI exécute)
        ↓
Agent : Génère les cas de test (l'agent crée)
        ↓
CLI : Valide la structure (cli-schema valide)
        ↓
Agent : Écrit les cas de test (le CLI exécute)
        ↓
CLI : Retourne les agentHints (le CLI guide)
        ↓
Agent : Relit, ajuste (l'agent suit les indices)
        ↓
Agent : Exécute les tests (le CLI exécute)
        ↓
CLI : Retourne le rapport (le CLI fournit un retour)
        ↓
Agent : Résume à l'utilisateur (l'agent complète)

Transformation du flux de travail

Flux de travail Spec-First (Piloté par l'humain)

L'humain conçoit la spécification
        ↓
L'humain documente
        ↓
L'humain crée une maquette
        ↓
L'humain débogue
        ↓
L'humain écrit les tests
        ↓
L'humain publie

Caractéristiques :

Flux de travail Skill-First (Assisté par l'agent)

L'humain spécifie l'objectif
        ↓
L'agent lit les actifs existants
        ↓
L'agent génère des changements
        ↓
Le CLI valide
        ↓
L'agent écrit
        ↓
Le CLI guide les étapes suivantes
        ↓
L'agent vérifie
        ↓
L'humain examine le résultat

Caractéristiques :

Ce que les équipes devraient faire

Étapes immédiates

Exemple de première tâche d'agent

Utilisez Apidog CLI pour m'aider à créer mon premier point de terminaison API dans Apidog.
D'abord, vérifiez ma configuration Apidog CLI et listez les projets auxquels je peux accéder.
Demandez-moi quel projet utiliser. Après ma confirmation, créez un simple point de terminaison GET /health
nommé Vérification de la Santé avec un exemple de réponse 200. Validez toute
entrée structurée avant d'écrire, puis relisez le point de terminaison et résumez
ce qui a été créé.

Cela offre :

Commandes de démarrage

# Installer Apidog CLI
npm install -g apidog-cli@latest

# Installer le SKILL complémentaire
apidog skill install

# Vérifier la version (nécessite 2.2.5+)
apidog -v

# S'authentifier
apidog auth login

# Lister les projets
apidog project list

L'avenir

L'avenir est le développement d'API assisté par l'agent.

Résumé complet de la série

Nous avons couvert l'intégralité du parcours :

Le principe final

Le Spec-First était pour la collaboration humaine. Le Skill-First est pour l'exécution de l'agent.

Les actifs deviennent appelables. Les flux de travail deviennent exécutables. La qualité devient vérifiable.

Bienvenue au Skill-First.

Points clés à retenir

• Le Spec-First était adapté au développement piloté par l'humain
• Les agents sont désormais des consommateurs d'actifs d'API
• Les actifs passent de lisibles à appelables
• Skill-First = Spec-First + exécution de l'agent
• Système : Apidog (actifs) → CLI (exécution) → SKILL (jugement) → Agents (action)
• L'humain spécifie l'objectif, l'agent exécute, le CLI valide
• Commencer petit, apprendre les modèles, étendre le périmètre

Téléchargez Apidog pour concevoir, simuler, tester et documenter les API dans un seul espace de travail. En savoir plus sur Apidog CLI pour les tests d'API en ligne de commande, l'automatisation CI et les flux de travail des agents IA.