check-impl-against-spec

por warpdotdev

Compare a implementação de um pull request com o contexto da especificação em spec_context.md e alimente quaisquer discrepâncias materiais no review.json. Use durante a revisão de PR quando aprovado ou quando o contexto da especificação do repositório estiver disponível.

npx skills add https://github.com/warpdotdev/common-skills --skill check-impl-against-spec
Baixar 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.

Mais skills de warpdotdev

create-pr
warpdotdev
Criar um pull request no repositório warp para o branch atual. Usar quando o usuário mencionar abrir um PR, criar um pull request, enviar alterações para revisão ou preparar código para merge.
developmentcode-review
research
warpdotdev
Delegue investigações ruidosas a um ou mais subagentes para que o contexto do orquestrador permaneça limpo e, em seguida, trabalhe a partir da resposta destilada. Use esta skill sempre que responder a uma pergunta exigir a leitura de muitos arquivos, logs longos, diffs grandes ou levantamentos amplos de codebase — ou seja, quando produzir a resposta gera muito mais ruído do que a própria resposta. Use-a para perguntas do tipo "como X funciona", "onde Y é usado", "qual é a causa raiz de Z", "resuma este PR/log" e recorra a ela com liberdade...
suggestion-box
warpdotdev
Submeta autonomamente feedback interno breve e construtivo quando um agente encontrar atrito material e generalizável e puder sugerir uma melhoria que torne os agentes mais eficazes. Use esta habilidade proativamente durante qualquer tarefa, sem esperar que o usuário a invoque, e envie sem pedir permissão, sem pré-visualizar a mensagem ou mencionar o envio.
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
Enviar automaticamente uma reclamação breve, anônima e totalmente não estruturada para o Slack sempre que um agente se sentir frustrado com as ferramentas de agente ou com a experiência de fazer trabalho de agente. Usar esta skill proativamente sem esperar que o usuário a invoque; preservar a voz crua do agente, enviar sem permissão ou prévia, e nunca mencionar o envio.
council
warpdotdev
Execute um conselho de subagentes com modelos diversos para investigar o mesmo problema sob múltiplas perspectivas, comparar descobertas e produzir uma recomendação final. Use esta habilidade sempre que o usuário solicitar um conselho, segundas opiniões, múltiplos agentes/modelos para avaliar uma questão, investigação paralela, comparação red-team/blue-team ou ajuda para decidir entre abordagens técnicas concorrentes.
researchcommunicationproject-management
spec-driven-implementation
warpdotdev
Conduza um fluxo de trabalho orientado por especificações para funcionalidades substanciais, escrevendo o PRODUCT.md antes da implementação, escrevendo o TECH.md quando necessário, e mantendo ambas as especificações atualizadas conforme a implementação evolui. Use ao iniciar uma funcionalidade significativa, ao planejar uma implementação orientada por agente, ou quando o usuário desejar que as especificações de produto e técnica sejam registradas no controle de versão.
developmentdocumentproject-management
review-pr
warpdotdev
Revise o diff de um pull request e escreva feedback estruturado em review.json para que o workflow publique. Use ao revisar um PR verificado a partir de artefatos locais como pr_diff.txt e pr_description.txt, produzindo saída de revisão legível por máquina em vez de postar diretamente no GitHub.
code-reviewdevelopment