Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoCódigo / SDK · Pronto p/ usoGitLab Blog→ original

GitLab conecta o Claude Code aos agentes Duo com uma única skill: 4 cenários direto do terminal

Quem programa no Claude Code não precisa trocar de interface para automatizar o trabalho. Uma skill (um conjunto pronto de instruções para o agente) configura o grupo no GitLab e o conecta via MCP, o protocolo padrão de comunicação entre agente e serviço. Depois disso, basta dizer no terminal "pegue a minha tarefa", e o agente Duo no GitLab abre o merge request por conta própria. O trabalho longo roda no lado do GitLab, e o código continua passando pelas revisões, pipelines e varreduras de sempre.

Processado por IA de GitLab Blog; editado por Hamidun News
GitLab conecta o Claude Code aos agentes Duo com uma única skill: 4 cenários direto do terminal
Fonte: GitLab Blog. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalGitLab Blog ↗
Editor-chefe
Dado-chave #1A skill primeiro mostra o plano de alterações e espera o seu "sim"
Dado-chave #2O merge request do agente é aberto em seu nome, e não em nome de uma conta de serviço
Dado-chave #3O cenário de segurança exige licença GitLab Ultimate

Muitos desenvolvedores já trabalham com um agente de IA local, como Claude Code, Codex ou Cursor, e não querem mudar de interface só para automatizar tarefas. A GitLab propõe o seguinte esquema: você continua no terminal de sempre e envia para o GitLab Duo Agent Platform as tarefas longas, que precisam do contexto de todo o repositório. Trata-se de uma plataforma da GitLab em que os agentes trabalham dentro do próprio projeto, seguindo cenários prontos (na GitLab, chamados de flows, ou "fluxos").

A ponte entre o terminal e a plataforma é feita por uma skill, isto é, uma instrução previamente escrita para o agente, e pelo MCP, um protocolo aberto pelo qual o agente se comunica com um serviço externo. Imagine uma manhã comum: uma issue foi atribuída a você e, em vez de abrir a branch por conta própria, você escreve no Claude Code "pegue a tarefa número 1 e passe para o fluxo Developer". Pouco depois, um merge request pronto aparece na sua fila.

Para quem já usa GitLab e um agente local, é uma forma de eliminar trabalho repetitivo sem abrir mão das ferramentas habituais.

Nos exemplos, a GitLab usa o Claude Code porque ele é o mais escolhido pelos clientes da empresa. O mesmo esquema funciona em outros ambientes, incluindo o Duo CLI, da própria GitLab.

Configuração com uma única skill

Em vez de uma configuração manual, a GitLab lançou a skill gitlab-duo-setup. Ela é copiada para a pasta ~/.claude/skills/ e, depois, chamada no diretório do projeto com o comando /gitlab-duo-setup. A skill também pode ficar em .claude/skills/, dentro do repositório, para que toda a equipe a tenha. Há ainda uma segunda skill, a gitlab-mr-followup: ela ajuda o agente local a acompanhar o estado do merge request e a executar etapas por você.

Antes de qualquer alteração, a skill lê o grupo de nível superior e seus projetos e apresenta um plano único: o que vai mudar e quem será afetado. As configurações do grupo chegam a todos os projetos e participantes, e o plano avisa isso de forma explícita. Qualquer linha pode ser removida. Depois da sua aprovação, a skill:

  • ativa o Duo Agent Platform e a execução de fluxos no grupo, adicionando os fluxos Code Review, Duo Developer e Fix CI/CD Pipeline;
  • ativa a revisão automática de código no grupo, que passa a valer em todos os projetos;
  • cria, em cada projeto com CI/CD, uma automação que dispara o Fix CI/CD Pipeline quando um pipeline falha (projetos que já têm essa automação são ignorados, então rodar a skill de novo é seguro);
  • adiciona o servidor MCP do GitLab ao Claude Code e conduz o login pelo navegador;
  • verifica o resultado chamando list_duo_agents_and_flows.

É preciso ter um grupo de nível superior no GitLab.com com créditos GitLab (grupos Premium e Ultimate recebem créditos promocionais mensais por usuário), um projeto com pipeline, algumas issues e alguns merge requests, além do papel de Owner no grupo. Com o papel de Maintainer, a skill configura apenas um projeto e lista o que você deve pedir ao proprietário. Também são necessários Claude Code, git e GitLab CLI (glab). Se, depois do login, aparecer o erro 403, o mais provável é que a conexão de clientes MCP esteja desativada no grupo: o proprietário deve ativar "Allow connection to GitLab" nas configurações do grupo.

Quatro cenários direto do terminal

Depois da conexão, o Claude Code pode encontrar suas issues, iniciar fluxos, ler as discussões de revisão e o status dos pipelines e responder nas discussões por meio de uma única conexão OAuth. Cada chamada gera um evento de auditoria para a equipe de plataforma.

  1. Passar a issue para o fluxo Developer. O agente mostra as tarefas atribuídas a você, você escolhe uma, e o Claude inicia uma sessão do Duo com o link dela. A partir daí, o trabalho não roda no seu computador, mas em um job de CI em um runner: o fluxo lê a issue e o repositório, escreve as alterações e abre o merge request. Ele é aberto em seu nome, e não em nome de uma conta de serviço, e cai na sua fila de revisão. Quanto mais clara a descrição da tarefa, melhor o resultado.
  2. Revisão automática de cada merge request, análise dos comentários sem sair do terminal e resolução de conflitos de merge.
  3. Correção automática de um pipeline que falhou.
  4. Análise e correção de achados de segurança; esse cenário só está disponível no GitLab Ultimate.

O que isso significa na prática

O principal argumento da GitLab é que o agente não cria um atalho. Todo merge request continua passando pelas mesmas revisões, pipelines, varreduras e políticas de aprovação. A skill também não está presa a uma única ferramenta, então pode ser usada mesmo se você trocar de agente local.

Há limitações: são necessários créditos GitLab, a parte de segurança exige Ultimate, e os projetos precisam de runners capazes de executar fluxos. As configurações de grupo afetam todos os participantes, por isso é melhor rodar a skill depois de alinhar com a equipe. Se o servidor GitLab estiver conectado, mas as ferramentas não aparecerem, verifique /mcp e reinicie o Claude Code. Se surgirem ferramentas duplicadas por causa de conexões no nível do usuário e do projeto, mantenha apenas uma.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre Configuração com uma única skill?

Em vez de uma configuração manual, a GitLab lançou a skill gitlab-duo-setup. Ela é copiada para a pasta ~/.claude/skills/ e, depois, chamada no diretório do projeto com o comando /gitlab-duo-setup. A skill também pode ficar em .claude/skills/, dentro do repositório, para que toda a equipe a tenha. Há ainda uma segunda skill, a gitlab-mr-followup: ela ajuda o agente local a acompanhar o estado do merge request e a executar etapas por você.

O que se sabe sobre Quatro cenários direto do terminal?

Depois da conexão, o Claude Code pode encontrar suas issues, iniciar fluxos, ler as discussões de revisão e o status dos pipelines e responder nas discussões por meio de uma única conexão OAuth. Cada chamada gera um evento de auditoria para a equipe de plataforma. Passar a issue para o fluxo Developer. O agente mostra as tarefas atribuídas a você, você escolhe uma, e o Claude inicia uma sessão do Duo com o link dela.

O que isso significa na prática?

O principal argumento da GitLab é que o agente não cria um atalho. Todo merge request continua passando pelas mesmas revisões, pipelines, varreduras e políticas de aprovação. A skill também não está presa a uma única ferramenta, então pode ser usada mesmo se você trocar de agente local. Há limitações: são necessários créditos GitLab, a parte de segurança exige Ultimate, e os projetos precisam de runners capazes de executar fluxos.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…