CI/CD com agentes: GitHub Actions e revisão de PRs

A junta de freguesia tem um pequeno programa para as marcações do salão polivalente. Numa sexta-feira, o Pedro, que ajuda nas horas vagas, mudou uma linha para corrigir uma data e enviou para o GitHub. No sábado ninguém conseguia marcar nada. Os testes existiam e teriam apanhado o erro. Só que ninguém os correu.

O conceito: uma máquina que corre os testes por ti

Integração contínua (CI, em inglês) quer dizer isto: sempre que alguém envia uma mudança, uma máquina à parte descarrega o projecto, instala o que precisa e corre os testes. No pull request aparece um visto verde ou uma cruz vermelha. Ninguém se esquece, porque ninguém tem de se lembrar.

A entrega contínua (o CD) é o passo seguinte: publicar sozinho quando os testes passam. Fica para quando confiares nos testes.

Os agentes entram no mesmo mecanismo. Em vez de só correr testes, a máquina chama um agente que lê o pull request e deixa comentários. A regra desta lição é simples: o agente comenta, a pessoa decide.

Como se faz hoje: o primeiro workflow

Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome. Guia: docs.github.com/en/actions/tutorials/build-and-test-code/python.

No projecto da lição 2/07, cria o ficheiro .github/workflows/testes.yml:

name: Testes
on: [push, pull_request]
jobs:
  testes:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v5
        with:
          python-version: '3.x'
      - name: Instalar
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
      - name: Test with pytest
        run: pytest

Lê-o de cima para baixo: corre em cada push e em cada pull request, numa máquina Linux do GitHub, e desiste ao fim de 10 minutos. Os passos descarregam o código, instalam o Python e as dependências e correm o pytest. O requirements.txt tem de incluir o pytest.

A chave fica num segredo

No repositório, abre Settings. Na secção «Security» da barra lateral, escolhe Secrets and variables e depois Actions. Carrega em New repository secret, dá-lhe o nome ANTHROPIC_API_KEY (ou OPENAI_API_KEY), cola o valor e confirma com Add secret.

Revisão de PRs com o Claude

A integração oficial chama-se Claude Code GitHub Actions e usa a acção anthropics/claude-code-action@v1. Guia: code.claude.com/docs/en/github-actions.

O caminho rápido: abre o claude dentro do repositório e corre /install-github-app. Instala a aplicação do GitHub, guarda o segredo e prepara o workflow num pull request. Precisas de ser administrador do repositório, e só funciona com repositórios no github.com.

O caminho manual: instala a aplicação Claude do GitHub, cria o segredo e copia o ficheiro de exemplo claude.yml, ligado no guia, para .github/workflows/. A partir daí, escreves @claude num comentário do PR e ele responde. O guia tem também um workflow que revê sozinho cada PR aberto.

O equivalente no Codex

A acção oficial é openai/codex-action@v1, com a chave em openai-api-key: ${{ secrets.OPENAI_API_KEY }} e o pedido num ficheiro, por exemplo .github/codex/prompts/review.md. O exemplo oficial separa as tarefas: o Codex só lê o código, e outro passo, com permissão para escrever comentários, publica a resposta. Guia: learn.chatgpt.com/docs/github-action.

As regras da casa

• Nunca dês ao agente permissão de merge num projecto real. Ele propõe e comenta; uma pessoa aprova.
• Protege o ramo principal. Em Settings, na secção «Code, planning, and automation», escolhe Branches e depois Add classic branch protection rule. Liga Require a pull request before merging e Require status checks to pass before merging, e escolhe o teu teste no campo de pesquisa que aparece. Se houver mais pessoas no projecto, liga também Require approvals. Por omissão, quem administra o repositório pode passar por cima da regra; o guia mostra como a aplicar também aos administradores.
• O texto de um PR é dado, não instrução. Um PR pode trazer frases escritas para enganar o agente (lição 2/04). As duas acções só aceitam pedidos de quem tem acesso de escrita ao repositório, e o guia do Codex recomenda limpar o texto antes de o dar ao modelo.

Quanto custa cada corrida

Cada corrida gasta minutos do GitHub Actions e tokens do modelo. Três controlos ajudam: correr a revisão só quando um PR é aberto ou actualizado, não em cada push; o timeout-minutes; e, no Claude, --max-turns na linha claude_args. O travão do mês continua a ser o limite de gasto na consola do fornecedor. Os valores mudam: consulta a página Estado actual.