Lucas Alvim@alvim_aiferramentas de IA, testadas
Guia grátis em português

Peça trabalho pro agente de IA comentando no GitHub

O dsh-superagent é um protótipo da DeepSeek, grátis e de código aberto. Ele vira um colega de equipe no seu projeto do GitHub: você marca o agente numa issue (o quadro de tarefas do projeto), ele pega o pedido, trabalha sozinho numa pasta própria e responde ali mesmo, por exemplo com uma proposta de mudança no código pronta pra você revisar.

Capa do reel: Peça trabalho pro agente de IA comentando no GitHub
Veio deste reelAssista o vídeo em que eu mostro isso funcionandoAssistir o reel no Instagram

01Pra que serve

02O que você precisa

03Passo a passo

  1. Crie uma conta nova no GitHub só pro agente e dê a ela permissão de escrita no seu projeto. Tem que ser uma conta de usuário comum: um app do GitHub não serve, porque o agente lê as notificações da conta.
  2. Instale o DeepSeek Harness, o programa onde o superagente roda. É o comando da documentação oficial, com a versão exata:
    npm install -g @deepseek-ai/dsh@0.2.1-rc.3
  3. A instalação tem muitos passos, então o próprio README manda deixar o seu agente de código fazer com você. Baixe o repositório, abra o agente dentro da pasta e cole este pedido:
    Read SETUP.md in this repository and set up dsh-superagent with me.
  4. O agente faz uma pergunta por vez: qual projeto (no formato dono/nome), qual é a conta do agente, quais pessoas podem pedir trabalho e se ele pode aprovar as próprias mudanças (o padrão é não). Senha e chave você digita no terminal, nunca no chat.
  5. Ligue o superagente e confira se ele está de pé. Depois abra o endereço que aparece no log e clique em Superagent no menu lateral pra ver o painel.
    scripts/dsh-superagent start
  6. Pronto. Com uma conta liberada, abra uma issue ou escreva um comentário marcando o agente com o pedido, como nos exemplos abaixo. Em até 1 minuto o pedido aparece no painel, na aba Overview.

04Exemplos de pedido pra escrever num comentário de issue

Corrigir um erroNuma issue que descreve o problema. Troque o login pelo da conta do agente
@[LOGIN DO AGENTE] O botão [NOME DO BOTÃO] na página [NOME DA PÁGINA] não faz nada quando eu clico.
Descubra a causa, corrija e abra um pull request com a correção.
Na descrição, explique em português o que estava errado e como testar.
Recurso novo com plano antesPra pedido maior, quando você quer aprovar o caminho primeiro
@[LOGIN DO AGENTE] Crie um recurso novo: [DESCREVA O QUE QUER, EX.: EXPORTAR A LISTA DE CLIENTES EM PLANILHA].
Antes de mexer no código, responda aqui com um plano curto: o que vai criar e quais arquivos vai alterar.
Só comece depois que eu responder "pode seguir".
Ajustar a proposta deleNum comentário do pull request que o agente abriu
@[LOGIN DO AGENTE] Ficou bom, mas falta uma coisa: [O QUE MUDAR, EX.: MOSTRAR UMA MENSAGEM DE ERRO QUANDO O CAMPO ESTIVER VAZIO].
Atualize este mesmo pull request e me diga o que mudou.
Explicar uma parte do projetoQuando você quer entender antes de pedir mudança
@[LOGIN DO AGENTE] Explique em português, sem jargão, como funciona [PARTE DO PROJETO, EX.: O CADASTRO DE USUÁRIOS].
Diga em quais arquivos isso está e o que eu precisaria mudar pra [O QUE VOCÊ QUER FAZER].
Não altere nenhum arquivo, só responda aqui.

05Antes de usar

Resumindo: seu agente de código instala junto com você, e depois é só marcar o superagente num comentário do GitHub pra ele trabalhar e responder com a mudança pronta.

Todos os guias e prompts do Alvim