handoff

Visão geral do skill handoff

O que o skill handoff faz

handoff transforma a conversa atual em um documento de passagem conciso para o próximo agente. Ele foi pensado para momentos em que você precisa de continuidade rápida: resumir o que importa, o que foi decidido e qual deve ser o próximo passo da sessão seguinte.

Quem deve usar

Use o skill handoff se você estiver transferindo um trabalho entre sessões, repassando uma tarefa para outro agente ou preparando um briefing pronto para IA para dar continuidade à execução. Ele é especialmente útil para trabalho em repositório, tarefas de produto em várias etapas e qualquer fluxo em que a perda de contexto gere retrabalho.

Por que ele é diferente

O valor principal do handoff não é resumir de forma genérica. Ele pede um documento acionável que evita duplicar artefatos já existentes e aponta o próximo agente para a fonte certa, por caminho ou URL. Isso o torna mais útil do que um simples prompt de “resuma esta conversa”.

Como usar o skill handoff

Instale o handoff e comece pelo arquivo do skill

Para um handoff install típico, adicione o skill do repositório e abra primeiro o SKILL.md:

npx skills add mattpocock/skills --skill handoff

Depois leia o SKILL.md para entender exatamente a estrutura e o comportamento da saída antes de aplicá-lo ao seu próprio fluxo de trabalho.

Dê ao skill um objetivo real para a próxima sessão

O padrão de uso do handoff funciona melhor quando você diz para que serve a próxima sessão. A dica de argumento do repositório espera uma frase de foco como:

• “Continue depurando a falha de build do TypeScript no pacote de pagamentos.”
• “Retome a revisão da copy da landing page e finalize as variações de CTA.”
• “Volte à implementação do fluxo de auth depois das mudanças no schema da API.”

Um pedido vago como “faça um handoff” gera um documento mais fraco. Um objetivo claro para a próxima sessão ajuda o skill a decidir o que deve entrar no handoff e o que pode ficar de fora.

Leia os arquivos certos antes de escrever

O skill foi desenhado para ser leve, então a principal fonte é o SKILL.md. Verifique também quaisquer artefatos próximos do projeto que o skill mencionar, em vez de copiá-los para o handoff:

• README.md
• AGENTS.md
• metadata.json
• pastas rules/, resources/, references/ ou scripts/, se existirem

Se o trabalho já estiver registrado em PRD, plano, ADR, issue, diff ou commit, o handoff deve apontar para isso em vez de repetir o conteúdo. Isso mantém o documento curto e acelera a próxima agente.

Escreva para o próximo agente, não para você

Um documento forte de handoff normalmente inclui:

• objetivo e status atuais
• decisões já tomadas
• dúvidas em aberto ou bloqueios
• caminhos exatos de arquivos, URLs ou artefatos para verificar em seguida
• quaisquer skills sugeridos para a sessão de acompanhamento

Esse é o princípio central de uso: deixe o próximo passo óbvio sem reexplicar toda a história do projeto.

FAQ do skill handoff

O handoff é só para conversas longas?

Não. O handoff é útil sempre que o próximo agente deve começar com menos tempo de preparação, mesmo depois de uma troca curta, mas complexa. Ele é mais valioso quando há decisões, dependências ou artefatos de origem que precisam ser preservados.

Em que isso difere de um prompt comum?

Um prompt comum muitas vezes pede um resumo e para por aí. O skill handoff é mais opinativo: ele foi feito para produzir um documento de transferência, evitar duplicação e apontar para os artefatos canônicos que a próxima sessão deve usar.

O handoff é adequado para iniciantes?

Sim, desde que você consiga nomear a próxima tarefa com clareza. Iniciantes têm os melhores resultados quando fornecem uma frase de foco simples e deixam o skill organizar a passagem em um briefing útil.

Quando eu não devo usar o handoff?

Não use handoff quando a próxima sessão não precisar de continuidade ou quando o contexto necessário já estiver totalmente capturado em um artefato existente que o próximo agente vai ler diretamente.

Como melhorar o skill handoff

Torne o objetivo da próxima sessão específico

A qualidade da saída do handoff depende de quão claramente você define a próxima sessão. Entradas melhores nomeiam a fase exata, o subsistema ou o ponto de decisão, e não apenas o projeto de forma genérica.

Aponte para os artefatos de verdade

Se o trabalho atual estiver em um documento, issue ou diff, inclua essas referências para que o handoff possa continuar compacto. Isso importa porque o skill foi projetado para não duplicar material já armazenado em outro lugar.

Inclua restrições e dúvidas em aberto

Os documentos de handoff mais úteis registram o que ainda não foi resolvido: bloqueios de implementação, trade-offs, preocupações de revisão ou suposições que ainda precisam de confirmação. Esses detalhes ajudam o próximo agente a evitar repetir caminhos sem saída anteriores.

Sugira skills de acompanhamento quando fizer sentido

O skill pede explicitamente sugestões de skill para a próxima sessão, então inclua isso quando a próxima tarefa puder se beneficiar de um fluxo diferente. Por exemplo, um handoff pode direcionar o próximo agente para skills voltados a planejamento, codificação ou revisão, dependendo do trabalho restante.