warpdotdev/check-impl-against-spec

Que fait check-impl-against-spec ?

Compare l'implémentation d'une pull request par rapport au contexte de spécification dans spec_context.md et alimente review.json avec les divergences matérielles. À utiliser pendant la revue de PR lorsque celle-ci est approuvée ou que le contexte de spécification du dépôt est disponible.

Utilisation

Cette compétence doit être invoquée par un agent IA pendant le processus de revue d'une pull request. Elle nécessite la présence d'un fichier spec_context.md à la racine du dépôt, contenant le contexte de la spécification à respecter.

Prérequis

• Un fichier spec_context.md dans le dépôt avec le contexte de spécification.
• Une pull request ouverte à analyser.
• L'approbation de la PR ou le contexte de spécification du dépôt disponible.

Fonctionnement

1. L'agent lit spec_context.md pour comprendre les exigences.
2. Il analyse les diffs de la pull request par rapport à ces exigences.
3. Il identifie les divergences matérielles (écarts significatifs).
4. Il écrit un résumé structuré de ces divergences dans review.json.

Exemple de sortie dans review.json

{
  "mismatches": [
    {
      "severity": "high",
      "description": "Le champ `status` n'implémente pas les valeurs attendues: 'active', 'inactive' manquants.",
      "file": "src/status.js",
      "specification": "Le champ status doit accepter les valeurs 'active' et 'inactive'."
    }
  ]
}

Plateformes supportées

• Claude Code
• Cursor
• Codex
• Autres agents IA compatibles avec le protocole de skill.

Notes importantes

• Les divergences matérielles sont celles qui affectent la fonctionnalité ou la logique métier.
• review.json est mis à jour à chaque exécution de la compétence.
• Ne pas modifier manuellement review.json ; la compétence gère son contenu.

Dépendances

• Présence de spec_context.md dans le dépôt.
• Accès en lecture aux diffs de la pull request.
• Accès en écriture au fichier review.json.