Agente de Outbox

ship-pr

Invocar este skill autoriza a criação de branch, staging, commits, pushes, criação ou atualização de PR e respostas a comentários elegíveis necessários para preparar um PR para merge. Ele não autoriza o merge em si.

Se references/repo-specific-pr-policy.md existir, leia-o antes de iniciar o fluxo de trabalho e trate-o como autoritativo.

Entradas

Exija um destino de despacho pr_worker e use /dispatch-agent para cada despacho. Repasse qualquer entrada adicional do solicitante em cada prompt pr_worker.

A menos que o usuário restrinja o escopo, inclua toda a árvore de trabalho atual.

Fluxo de Trabalho

1. Crie um branch quando as normas do repositório exigirem um. Faça commit das alterações pretendidas, faça push e crie ou reutilize o PR. Derive seu título das alterações e preencha assets/pr-body-template.md, removendo seções não utilizadas e placeholders.

2. Inicie um watcher em uma sessão gerenciada em background. Mantenha-o em execução até que o PR seja mesclado ou o fluxo de trabalho pare, então pare-o. Se ele sair após uma falha de transporte transitória, reobtenha o estado autoritativo e reinicie-o com o mesmo log append-only.

   bash <skill_dir>/scripts/watch-pr-events.sh \
     --repo <owner/name> \
     --pr <pr-number> \
     --log-file .agent-layer/tmp/ship-pr-events-<pr-number>.jsonl \
     --interval-seconds 300
   

3. Obtenha o head atual, checks e mergeability com gh. Leia comentários com este comando stateless; nunca infira o estado atual a partir do log do watcher:

   bash <skill_dir>/scripts/read-pr-comments.sh \
     --repo <owner/name> \
     --pr <pr-number>
   

   Despache pr_worker para feedback não resolvido com o PR exato, head e references/address-pr-comments.md; para uma verificação obrigatória falha, forneça também sua evidência e references/fix-ci.md. O worker edita a árvore local, mas não faz commit, push ou posta respostas. Resolva conflitos mecânicos automaticamente.

   O PR está pronto para merge somente quando:

   • O PR está mergeável no seu head mais recente.
   • Pelo menos um revisor agente ou humano postou feedback como uma revisão formal ou comentário.
   • Toda verificação obrigatória e gate de repositório estão verdes.
   • Todo comentário elegível tem uma resposta validada.
   • Se a política opcional do repositório existir, todo critério de merge que ela define é atendido.

   Se nenhum revisor agente ou humano postar feedback dentro de 10 minutos após a criação do PR, pare e reporte que nenhum feedback foi recebido. Se pronto, continue para o passo 5. Caso contrário, resolva a rodada acionável completa antes de commitar.

4. Faça commit e push das correções aceitas. Poste cada resposta proposta pelo trabalhador uma de cada vez: responda nativamente a comentários inline; para comentários de conversa ou resumos de revisão, poste um comentário de issue vinculando a fonte. Reexecute o comando de comentário e corrija qualquer resposta ausente ou não suportada. Retorne ao passo 3 até estar pronto. Se apenas verificações ou revisões estiverem pendentes, aguarde o watcher.

5. Solicite autorização de merge de uso único para o PR e head exatos. Reporte quaisquer descobertas substanciais, um resumo conciso da disposição dos comentários e evidências de prontidão.

6. Após a autorização, reobtenha o head, checks, mergeability e comentários. Confirme que a árvore local está completa e que todo comentário elegível tem uma resposta publicada suportada. Se algo mudou, retorne ao passo 3 e obtenha nova autorização para o head do PR resultante; caso contrário, faça o merge.

7. Confirme que o checkout está limpo, mude para o branch padrão, faça fast-forward e delete branches ou worktrees criados por este fluxo de trabalho. Preserve o estado e reporte qualquer limpeza que seja insegura de realizar.