← Todos os Skills · Automação · PR Description Writer

PR Description Writer — resultado final
Runs inClaude Code Codex Cursor Muse Dot Grok Bot Cue OpenClaw Hermes
Você precisa de:O resumo de mudanças: pr.txt (uma linha Title dizendo o que o PR faz, uma linha Change por mudança, uma linha Why por motivo, uma linha Test por verificação — o que foi executado, depois | Result: pass, fail ou not run — e uma linha Risk por risco — o que pode dar errado, depois | Level: low, medium ou high — além de linhas Note opcionais).

Similar Skills

View all skills →

O que você recebe

  • Uma descrição de PR estruturada: Summary, Why, Testing com resultados registrados e Risk com door verdict e blast radius
  • Um veredito de Readiness — Ready to paste, ou Not ready com as lacunas e os erros nomeados
  • Cada teste com seu resultado registrado — um teste sem resultado aparece como Not recorded, nunca é dado como aprovado
  • Cada risco com seu nível declarado — um risco sem nível aparece como Not stated, nunca recebe um nível atribuído
  • Cada lacuna, erro de entrada e aviso nomeados no relatório

Ideal para

  • Abrir um pull request e colocar os fatos diante do revisor desde o início
  • Tornar visíveis antes do merge as verificações não testadas ou não registradas, em vez de escondê-las
  • Sinalizar mudanças one-way-door — migrações, exclusões, breaking changes — antes de mesclá-las

Não serve para

  • Aprovar uma mudança — uma descrição a descreve, o revisor ainda lê o diff
  • Decidir o quão arriscada é uma mudança — o door verdict conta palavras irreversíveis, não o risco
  • Escrever um PR sem resumo de mudanças — o relatório lista as lacunas, não inventa a descrição

Resultado de exemplo

Um exemplo do que este Skill produz. Conteúdo de amostra, mostrado para ilustração.

Pull request — sample

Changes: 3 | Why: 2 | Tests: 3 (3 passed, 0 failed, 0 not run, 0 not recorded) | Risks: 2 | Gaps: 0 | Errors: 0 | Warnings: 0

Ready to paste — every section is present and the input had no errors.

Summary: 1. Return the cached result when content is unchanged in the save path; 2. Add a GET /sessions/:id/result endpoint that serves the cached result; 3. Show a "Cached" badge on the session page when the result comes from cache.

Testing: Run the save twice with unchanged content — Pass; Open the cached result endpoint for a finished session — Pass; Load the session page for a cached result — Pass.

Door: Two-way door — no irreversible step mentioned; cheap to roll back. Blast radius: api · ui · code.

What this description is not: a description describes the change; it does not approve it — a reviewer still reads the diff.

Sobre este Skill

You say
A mudança de salvamento em cache está pronta — escreva a descrição de PR que um revisor possa realmente usar.

Como instalar

  1. Copie o prompt de instalação no seu agente: Read https://skillu.dev/install/agent.md, then install the PR Description Writer skill (pr-description-writer).
  2. Ou baixe o pacote do Skill nesta página após o lançamento e coloque a pasta dele no diretório de skills do seu agente.
  3. Chame-o com um comando de barra, ex.: /pr-description-writer, e descreva o que você quer em palavras simples.

Perguntas frequentes

Ready to paste significa que o PR foi aprovado?

Não. Significa que todas as seções estão presentes e a entrada não tinha erros — a descrição está completa, não a mudança. O revisor ainda lê o diff, e um teste com falha na tabela Testing é um achado, não um obstáculo para a descrição.

O que acontece se um teste não tiver resultado registrado?

Ele aparece como Not recorded na tabela Testing, e os avisos o nomeiam. O relatório nunca dá um teste como aprovado — uma descrição que esconde um teste não executado é pior do que nenhuma descrição.

Obter o Premium Ver mais Skills