handoff-skill

Handoff é uma habilidade de agente voltada para repositórios onde o mesmo trabalho é retomado ao longo de várias sessões de agentes de IA. Sua definição do problema: uma tarefa não verificada em uma lista não está necessariamente inacabada, pois outro agente pode tê-la implementado, um commit pode tê-la satisfeito, o requisito pode ter mudado ou outra pessoa ainda pode ser a proprietária dos arquivos afetados. A habilidade utiliza um arquivo de livro compartilhado, HANDOFF.md, juntamente com evidências do repositório, como histórico do Git, código atual, testes e propriedade, para decidir o que está realmente pendente. O fluxo de trabalho registrado possui seis estágios. O Preflight reivindica um nome de sessão e retorna, a partir de um snapshot versionado, cada entrada aberta do livro com seus passos, um resumo de entradas finalizadas recentemente, erros de estrutura e estado do Git. O Intake transforma cada solicitação em uma entrada de tarefa datada com caixas de seleção separadas para In progress e Completed, passos, verificação e uma linha de status. Uma auditoria progressiva pondera entradas posteriores do livro, commits, código-fonte atual, propriedade ativa e as caixas de seleção da entrada mais antiga, classificando então o escopo efetivo como Complete, Partially complete, Superseded, Unfinished ou Unknown, anotando em vez de excluir para que o histórico seja preservado. A resolução de propriedade questiona se o trabalho elegível deve ser finalizado primeiro ou deixado com seu proprietário atual antes que uma nova tarefa comece, a menos que o usuário já tenha dado uma ordem explícita. Safe writes roteiam atualizações através de um compare-and-swap bloqueado quando pares podem escrever na mesma árvore. Finalmente, o agente define caminhos explícitos, registra verificações e identificadores de commit, e deixa um estado do qual o próximo agente pode continuar. As entradas do livro registram um rótulo de proprietário, um campo de harness opcional (detectado automaticamente para Claude Code, Codex, Cursor e VS Code, substituível via variável de ambiente), caixas de estado, passos marcados e não marcados, uma linha de status e uma próxima ação. Tarefas concluídas mantêm ambas as caixas marcadas para que o livro seja lido como histórico. As sessões reivindicam nomes de uma lista de cem figuras mitológicas, distribuídos por ordem de chegada e nunca duplicando um proprietário já presente no livro. O projeto fornece uma CLI Python de biblioteca padrão com um dashboard curses ao vivo para agentes e tarefas, mostrando tarefas concluídas versus totais, contagens de em andamento e pendentes, progresso de passos e, onde registrado, o harness que cada proprietário usou. Ele também pode rodar em um modo de snapshot de texto simples, um modo somente leitura ou atrás de um lançador PATH que resolve a instalação fixada na versão atual. O dashboard suporta recortar uma tarefa e colá-la em outro proprietário, o que reescreve o rótulo do proprietário e registra a movimentação sob o mesmo bloqueio. Um script de barra de status imprime uma linha de progresso de uma única linha e é documentado como compatível com as linhas de status do Claude Code, Grok CLI e Kimi Code, com um wrapper tmux para Codex e outras CLIs. Um canal de agente local armazena mensagens e confirmações em um arquivo SQLite gitignored limitado a um checkout, sem daemon ou socket. Agentes podem enviar perguntas, responder, relatar disponibilidade, liberar seu bucket inacabado, declarar um prazo de renovação em um contrato e usar trocas de nonce de desafio/atestação para mostrar que outro agente está responsivo. A instalação é oferecida como um plugin do Claude Code de um marketplace, uma importação do marketplace do Cursor ou via npx skills add para outros hosts; o README afirma que Git, um agente com acesso de leitura/edição ao repositório e Python 3.9+ são necessários, sem chave de API, serviço hospedado ou pacote Python de terceiros. O único recurso que sai da máquina é uma etapa de publicação ssh opcional que permanece inativa até que um arquivo de configuração exista. Cinco comandos de barra cobrem a inicialização, visualização, status, continuação e purga do livro, e o README observa limitações do Windows para o dashboard curses e o caminho rápido da barra de status.