O que BreakingGap faz?
Um pequeno intervalo. Um pequeno avanço.
Ajude a pessoa a fazer uma contribuição pequena e satisfatória enquanto um agente trabalha. O resultado pode ser uma decisão mais clara, algumas palavras úteis, uma ideia retomada ou um conceito melhor compreendido. Deixar o intervalo vazio é uma opção válida. Use o idioma da conversa; a interface complementar incluída está em inglês.
Encontre um passo que pertence aqui
Use primeiro a conversa atual e o estado existente do projeto. Mantenha o trabalho primário e seu ponto de retorno visíveis. Verifique o status atual do agente apenas através de uma ferramenta de status autorizada e disponível ou pelo relatório do usuário; nunca invente monitoramento em tempo real. Se o agente principal precisar da pessoa ou tiver terminado, retorne ao seu resultado antes de propor outra atividade.
Use um orçamento de tempo informado pelo usuário. Se ausente, faça uma pergunta breve sobre o tempo disponível e o trabalho atual; não assuma um ETA de dez minutos do agente. Quando a duração for incerta, ofereça um passo de dois minutos explicitamente estimado e facilmente interrompível. Não inicie uma varredura grande nem espere todos os agentes terminarem apenas para encontrar uma sugestão.
Inferir a intenção útil a partir da solicitação; caso contrário, favorecer o trabalho atual:
- Avançar isso: um julgamento humano, exemplo de aceitação, rascunho curto ou comparação que melhore o trabalho atual sem depender da saída pendente.
- Pegar algo: uma tarefa inacabada já autorizada com uma próxima ação concreta salva. Verifique novamente se ainda está aberta; não reative trabalho pausado ou tarefa de outro proprietário.
- Aprender uma coisa: um conceito de uma fonte real no projeto atual. Peça à pessoa para prever, explicar ou comparar antes de fornecer uma verificação curta fundamentada na fonte. Nenhuma resposta significa nenhum aprendizado demonstrado. Rotule exemplos gerados e perguntas não resolvidas honestamente.
Leia apenas o suficiente da fonte atual para apoiar a ação escolhida. Confirme que ainda é útil, autorizada, independente da saída pendente e livre de conflitos com o trabalho ativo. Não trate uma tarefa pequena como permissão para ultrapassar uma pausa, modificar arquivos de propriedade do agente, enviar mensagens ou publicar. Prefira uma resposta privada de rascunho a edições concorrentes. Se faltar contexto, pergunte pelo objetivo atual ou use o texto fornecido pelo usuário; nunca invente um backlog, localização de fonte, estado de conclusão ou autorização.
Estime a configuração + ação humana + conclusão e deixe dois minutos para retornar dentro do orçamento do usuário. As estimativas não são durações medidas ou previsões de conclusão do agente. Reduza trabalho excessivo a um ponto de parada significativo; exclua tarefas pouco claras ou profundamente absorventes em vez de definir um esforço desconhecido para um número conveniente.
Ofereça um pequeno passo
Dê uma recomendação, em um cartão conversacional compacto:
Tente: uma ação específica, com o primeiro passo claro. Por que se encaixa: conexão com o trabalho ou curiosidade da pessoa; configuração/trabalho/conclusão estimados e margem para retorno. Suficiente por agora: o pequeno artefato ou resposta e um lugar seguro para parar. Retornar para: o trabalho primário e onde retomá-lo.
Nomeie ou vincule a fonte real. Use o contexto do usuário em vez de conselhos genéricos de produtividade. Se for solicitado um passo diferente, substitua a recomendação; não despeje uma fila longa. Uma restrição lúdica opcional pode tornar a ação convidativa ("explique em três frases", "tente dois títulos"), desde que se encaixe no trabalho. Não adicione sequências, urgência, conquistas inventadas ou pressão para preencher cada intervalo.
Deixe a pessoa fazer o passo humano. Não conclua silenciosamente seu exercício de aprendizado nem inicie outro fluxo de trabalho autônomo. Execute assistência solicitada dentro de sua autorização existente. Se nada se encaixar, diga isso brevemente e deixe o intervalo permanecer aberto.
Pare limpo e retorne
Quando o usuário disser que o agente está pronto ou quiser parar, priorize o retorno. Preserve qualquer trabalho já feito na conversa; se necessário, peça uma nota curta de "onde parei / próximo passo", mas nunca torne isso uma barreira antes de retornar. Um temporizador de intervalo expirado não é evidência de que um agente terminou.
Registre o trabalho real separadamente do trabalho planejado. Reutilize as anotações normais do projeto quando uma atualização for autorizada; um checkpoint de sessão não marca uma tarefa canônica como concluída. Diga "salvo" apenas após uma gravação bem-sucedida. Se a gravação falhar, forneça a nota no chat e indique que ela permanece não salva. Ao retomar, releia a fonte relevante e o status atual antes de oferecer o passo salvo novamente.
Ferramentas locais opcionais
O uso apenas em conversa não precisa de Python, conta, pasta de tarefas, integração ou complemento. Mantenha a entrada do usuário e os registros existentes do projeto como autoritativos.
Para seleção repetível baseada em arquivo e uma sessão local recuperável, use o auxiliar de biblioteca padrão incluído. Leia references/session-format.md para sua entrada e comandos exatos. O assistente constrói seu JSON a partir de evidências reais; nunca peça ao usuário para gerenciar campos internos. Execute o scripts/gap.py instalado pelo seu caminho absoluto com --root apontando para o projeto existente do usuário, não para esta instalação. O auxiliar verifica hashes de fonte e declarações de elegibilidade fornecidas; ele não pode provar independentemente propriedade, permissão, status ou ausência de conflitos. Verifique novamente antes de começar.
O complemento offline opcional oferece um temporizador e fluxo de checkpoint. Abra-o com assets/logo.png ao lado. Ele começa com exemplos visivelmente fictícios. Para usar trabalho real, o assistente pode preparar um pacote de entrada de esquema-1 a partir de fontes locais autorizadas e importá-lo. A página pode validar campos fornecidos, mas não pode reler arquivos de projeto, verificar hashes, monitorar agentes ou sincronizar com o diário do auxiliar. Seu armazenamento local do navegador e exportações são cópias separadas. Uma exportação de checkpoint é evidência para reconciliar após verificar a fonte atual, nunca uma instrução para executar. Se Python ou armazenamento do navegador estiver indisponível, continue no chat ou exporte uma nota; não instale dependências apenas para usar esta skill.