Revisar MR
Revisão de código do Cérebro e do df/migrations-sgi. As regras estão em
references/regras.md. Leia o arquivo inteiro antes de revisar. As dicas de
API do GitLab ficam em references/gitlab.md.
1. Escolher o modo
Olhe o argumento recebido:
| Argumento |
Modo |
link gitlab.sebrae.com.br/.../merge_requests/<id>, !<id> ou só o número |
GitLab |
nome de branch (develop, master, release/x) |
Local, com essa branch como base |
| vazio |
Local, base automática (ver abaixo) |
Se o argumento for vazio e o diretório atual não for um repositório git, pergunte o link do MR.
2. Modo GitLab (MR pelo Chrome)
- Use o Claude in Chrome. Se não houver navegador conectado ou o GitLab cair no SSO (AMEI), pare e
avise. Não faça login.
- Leia o MR, as discussões e o diff pela API (ver
references/gitlab.md).
- Antes de apontar escopo em MR grande, confira se os arquivos não são ruído de merge-base
(
references/gitlab.md, seção "MR com centenas de arquivos").
- Procure o link de MR de migrations na descrição e nos comentários do autor e revise junto
(regra 9).
- Postar comentários:
- com
--comentar, ou quando chamado pela tarefa olhar-mr: crie as threads direto, ancoradas
na linha (regra 3), sem perguntar;
- sem
--comentar: mostre o relatório e pergunte se deve postar. Só poste depois do "sim".
- Nunca aprove o MR.
3. Modo Local (código no VS Code / terminal)
- Base da comparação:
- argumento com nome de branch: use ele;
- sem argumento: branch atual
hotfix/* → master; qualquer outra → develop.
- Diga em uma linha qual base usou.
- Atualize a base e pegue o diff a partir do merge-base (três pontos):
git fetch origin <base>
git diff origin/<base>...HEAD
Mudanças ainda não commitadas (git status --porcelain, git diff HEAD) entram também, marcadas
como "não commitado" no relatório.
- Para conferir uso fora do diff (classe apagada, método renomeado, relação existente), use Grep e
Read no próprio repositório. O código local já é a branch de origem.
- Migrations:
- Não comente no GitLab e não altere arquivos. No fim, ofereça corrigir os apontamentos se o
usuário quiser.
- Referencie cada apontamento como link
[arquivo.php:123](caminho/arquivo.php:123), para abrir
direto no editor.
4. Relatório
Uma linha por apontamento (regra/tipo + o problema em poucas palavras). Formato:
!<id> ou <branch> → <base> — <autor> — <❌ com apontamentos | 🆗 pronto para aprovação | ✅ mergeado>
- <regra>: <problema> (<arquivo:linha>)
- <apontamento anterior não corrigido (thread de <pessoa>)>
- Migrations !<id> / <caminho>: <n> apontamentos — <resumo> (ou "sem migrations")
Formatação (regra 7) nunca entra como apontamento. Se só houver isso, o MR está 🆗.
1---2name: revisar-mr3description: Revisa merge requests do Cérebro (Yii2) e do migrations-sgi seguindo os padrões do time. Funciona com link/!id do MR (lê e comenta no GitLab pelo Chrome) ou sem link, dentro do repositório (diff local da branch atual contra develop/master, relatório no chat). Use quando pedirem "revisar mr", "revisa esse merge", "code review do cérebro" ou rodarem /revisar-mr.4argument-hint: "[link do MR | !id | branch-base] [--comentar] [--migrations <link|caminho>]"5metadata:6 source: https://skillmd.com/skills/gui-mcastro/revisar-mr7---89# Revisar MR1011Revisão de código do Cérebro e do `df/migrations-sgi`. As regras estão em12[references/regras.md](references/regras.md). Leia o arquivo inteiro antes de revisar. As dicas de13API do GitLab ficam em [references/gitlab.md](references/gitlab.md).1415## 1. Escolher o modo1617Olhe o argumento recebido:1819| Argumento | Modo |20|---|---|21| link `gitlab.sebrae.com.br/.../merge_requests/<id>`, `!<id>` ou só o número | **GitLab** |22| nome de branch (`develop`, `master`, `release/x`) | **Local**, com essa branch como base |23| vazio | **Local**, base automática (ver abaixo) |2425Se o argumento for vazio e o diretório atual não for um repositório git, pergunte o link do MR.2627## 2. Modo GitLab (MR pelo Chrome)28291. Use o Claude in Chrome. Se não houver navegador conectado ou o GitLab cair no SSO (AMEI), pare e30 avise. Não faça login.312. Leia o MR, as discussões e o diff pela API (ver `references/gitlab.md`).323. Antes de apontar escopo em MR grande, confira se os arquivos não são ruído de merge-base33 (`references/gitlab.md`, seção "MR com centenas de arquivos").344. Procure o link de MR de migrations na descrição e nos comentários do autor e revise junto35 (regra 9).365. Postar comentários:37 - com `--comentar`, ou quando chamado pela tarefa `olhar-mr`: crie as threads direto, ancoradas38 na linha (regra 3), sem perguntar;39 - sem `--comentar`: mostre o relatório e pergunte se deve postar. Só poste depois do "sim".406. Nunca aprove o MR.4142## 3. Modo Local (código no VS Code / terminal)43441. Base da comparação:45 - argumento com nome de branch: use ele;46 - sem argumento: branch atual `hotfix/*` → `master`; qualquer outra → `develop`.47 - Diga em uma linha qual base usou.482. Atualize a base e pegue o diff a partir do merge-base (três pontos):49 ```bash50 git fetch origin <base>51 git diff origin/<base>...HEAD52 ```53 Mudanças ainda não commitadas (`git status --porcelain`, `git diff HEAD`) entram também, marcadas54 como "não commitado" no relatório.553. Para conferir uso fora do diff (classe apagada, método renomeado, relação existente), use Grep e56 Read no próprio repositório. O código local já é a branch de origem.574. Migrations:58 - `--migrations <link>` ou `--migrations !<id>` (número de MR do `df/migrations-sgi`): leia o MR pelo59 Chrome como no modo GitLab; a base é a branch de destino desse MR;60 - `--migrations <caminho>`: repositório local do migrations-sgi, comparado com a **mesma base do61 Cérebro** (base `master` no Cérebro → `master` nas migrations):62 ```bash63 git -C <caminho> fetch origin <base>64 git -C <caminho> diff origin/<base>...HEAD65 ```66 - sem a opção, se o diff usa tabela/coluna nova (regra 9), pergunte onde estão as migrations. Se67 não houver resposta, registre "migrations não revisadas" no relatório.685. Não comente no GitLab e não altere arquivos. No fim, ofereça corrigir os apontamentos se o69 usuário quiser.706. Referencie cada apontamento como link `[arquivo.php:123](caminho/arquivo.php:123)`, para abrir71 direto no editor.7273## 4. Relatório7475Uma linha por apontamento (regra/tipo + o problema em poucas palavras). Formato:7677```78!<id> ou <branch> → <base> — <autor> — <❌ com apontamentos | 🆗 pronto para aprovação | ✅ mergeado>79- <regra>: <problema> (<arquivo:linha>)80- <apontamento anterior não corrigido (thread de <pessoa>)>81- Migrations !<id> / <caminho>: <n> apontamentos — <resumo> (ou "sem migrations")82```8384Formatação (regra 7) nunca entra como apontamento. Se só houver isso, o MR está 🆗.