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
165

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

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
create-pr
warpdotdev
Cré
developmentcode-review
implement-specs
warpdotdev
Implémenter une fonctionnalité approuvée à partir de PRODUCT.md et TECH.md, en maintenant l'alignement des spécifications et du code dans la même PR à mesure que l'implémentation évolue. Utiliser après l'approbation des spécifications produit et technique, lorsque l'étape suivante consiste à construire la fonctionnalité.
developmentcode-reviewapi
cross-critique
warpdotdev
Effectuer un second tour sur une question contestée en faisant circuler la proposition indépendante de chaque sous-agent auprès des autres auteurs et en demandant des avantages et inconvénients structurés, puis synthétiser. Utilisez cette compétence chaque fois que vous avez plusieurs propositions ou opinions indépendantes sur une décision contestée — compromis d'architecture, désaccords lors de revues de code, choix de conception, théories concurrentes sur la cause racine — et que vous souhaitez une analyse plus fine que celle que vous produiriez par une simple synthèse. Se combine naturellement avec les compétences council et research ;...
resolve-merge-conflicts
warpdotdev
Resolve Git merge conflicts by extracting only unresolved paths, conflict hunks, and compact diffs instead of loading whole files into context. Use when a merge, rebase, cherry-pick, or stash pop stops on conflicts, when `git status` shows unmerged paths, or when files contain conflict markers.
developmentcode-review
brandalf
warpdotdev
Guide la création, la révision et la relecture des assets de marque Warp ou Oz. À utiliser lors du travail sur des pages de lancement, de la documentation, des composants HTML/CSS, des maquettes UI, des prompts, des assets sociaux, des textes, des présentations ou tout autre livrable de marque qui doit ressembler et sonner indubitablement Warp ou Oz.
designcreativemarketing