check-impl-against-spec

par warpdotdev

Comparez l'implémentation d'une pull request avec le contexte de spécification dans spec_context.md et alimentez toute divergence matérielle dans review.json. À utiliser lors de la revue de PR lorsque celle-ci est approuvée ou que le contexte de spécification du dépôt est disponible.

npx skills add https://github.com/warpdotdev/common-skills --skill check-impl-against-spec
Télécharger ZIPGitHub
597

Check implementation against spec

Use this skill only when spec_context.md exists during PR review.

Goal

Determine whether the implementation in the checked-out PR materially matches the approved spec context. This is a supplement to the normal code review, not a separate output.

Inputs

  • spec_context.md contains the spec context to compare against. It may include both product spec content (intended behavior, acceptance criteria) and tech spec content (implementation details, file changes).
  • pr_diff.txt contains the annotated diff for the PR.
  • pr_description.md may contain additional scope or rationale.
  • The working tree contains the PR branch contents.

Process

  1. Read spec_context.md and extract the concrete commitments it makes:
    • required behaviors (from the product spec)
    • required files or subsystems to change (from the tech spec)
    • stated constraints
    • required follow-up steps, validation, or migrations
  2. Compare those commitments against the actual implementation in pr_diff.txt and the checked-out files.
  3. Treat small implementation-level adjustments as acceptable when they preserve the spec's intent. Do not flag harmless differences in naming, structure, or low-level technique.
  4. Flag a mismatch only when it is material, such as:
    • required behavior in the product spec is missing
    • the implementation contradicts a spec decision
    • the change introduces significant unplanned scope
    • a required validation, migration, or compatibility step from the tech spec is absent

Outputs

  • Do not create a separate report file.
  • Fold spec-alignment findings into review.json.
  • Put broad spec-drift concerns in the review summary.
  • Add inline comments only when the mismatch can be tied to changed lines in the diff.
  • Treat material spec drift as at least an important concern.
  • If the implementation matches the spec closely enough, do not add comments just to mention alignment.

Boundaries

  • Do not require literal one-to-one implementation of the spec when the PR achieves the same outcome safely.
  • Do not speculate about spec details that are not actually present in spec_context.md.
  • Do not post to GitHub directly.

Plus de skills de warpdotdev

create-pr
warpdotdev
Cré
developmentcode-review
research
warpdotdev
Déléguer les investigations bruyantes à un ou plusieurs sous-agents afin de garder le contexte de l'orchestrateur propre, puis travailler à partir de la réponse distillée. Utilisez cette compétence chaque fois que répondre à une question nécessiterait de lire de nombreux fichiers, de longs journaux, de grands diffs ou de vastes études du codebase — c'est-à-dire lorsque la production de la réponse génère beaucoup plus de bruit que la réponse elle-même. Utilisez-la pour les questions du type « comment fonctionne X », « où Y est-il utilisé », « quelle est la cause profonde de Z », « résumez ce PR/journal », et utilisez-la sans modération...
suggestion-box
warpdotdev
Soumettre automatiquement une rétroaction interne brève et constructive lorsqu'un agent rencontre une friction matérielle et généralisable et peut suggérer une amélioration qui rendrait les agents plus efficaces. Utiliser cette compétence de manière proactive pendant toute tâche sans attendre que l'utilisateur l'invoque, et soumettre sans demander la permission, sans prévisualiser le message ni mentionner la soumission.
respond-to-pr-comments-in-blocklist
warpdotdev
Interactively walk a user through PR review comments one at a time, collect a per-comment decision, then post agent-authored replies on GitHub and resolve the review threads once the user approves a preview. Use only when the user wants to reply to or resolve review threads on GitHub. Skip when the user only wants comments fetched or displayed (use `pr-comments`), or only wants the code changes made without posting anything back to GitHub.
complain
warpdotdev
Balancer de manière autonome une brève plainte, anonyme et totalement non structurée, dans Slack chaque fois qu'un agent se sent frustré par les outils d'agent ou par l'expérience de faire du travail d'agent. Utiliser cette compétence de manière proactive sans attendre que l'utilisateur l'invoque ; préserver la voix brute de l'agent, soumettre sans permission ni aperçu, et ne jamais mentionner la soumission.
council
warpdotdev
Exécutez un conseil de sous-agents diversifiés en modèles pour examiner le même problème sous plusieurs angles, comparer les résultats et produire une recommandation finale. Utilisez cette compétence chaque fois que l'utilisateur demande un conseil, des seconds avis, plusieurs agents/modèles pour évaluer une question, une enquête parallèle, une comparaison équipe rouge/équipe bleue, ou de l'aide pour choisir entre des approches techniques concurrentes.
researchcommunicationproject-management
spec-driven-implementation
warpdotdev
Piloter un workflow orienté spécifications pour des fonctionnalités substantielles en rédigeant PRODUCT.md avant l'implémentation, en écrivant TECH.md lorsque cela est justifié, et en maintenant les deux spécifications à jour à mesure que l'implémentation évolue. À utiliser lors du démarrage d'une fonctionnalité importante, de la planification d'une implémentation pilotée par agent, ou lorsque l'utilisateur souhaite que les spécifications produit et techniques soient intégrées au contrôle de source.
developmentdocumentproject-management
review-pr
warpdotdev
Examiner le diff d'une pull request et rédiger un retour structuré dans review.json pour que le workflow le publie. À utiliser lors de la révision d'une PR extraite localement à partir d'artefacts comme pr_diff.txt et pr_description.txt, en produisant une sortie de révision lisible par machine plutôt qu'en publiant directement sur GitHub.
code-reviewdevelopment