ai-code-review
Ai Code Review — Skill especializada para ai code review
- License 许可
- MIT
- 最近更新
- 2026-08-01
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- ai-code-review
- risk
- safe
- license
- MIT
- metadata
- { "author": "Cafe Code AI", "updated": 1772323200000, "version": "1.0.0", "category": "12-ia-automacao" }
- description
- Ai Code Review — Skill especializada para ai code review
03 SKILL.md 正文
Ai Code Review
Esta skill capacita o Claude a atuar como um engenheiro de software sênior, realizando revisões de código automatizadas e contextuais com foco em qualidade, segurança e performance.
Keywords
Revisão de Código IA, Code Quality, Segurança de Código, Análise Estática, Pull Request Automation, GitHub Webhook, Claude API, Prompts de Revisão, Refatoração, Automação N8N, Make.com, CI/CD, Testes Unitários, Vulnerabilidade, Boas Práticas.
Quick Start
- Configurar Webhook no GitHub: Crie um webhook no seu repositório GitHub para eventos
pull_requestapontando para um endpoint de automação (Make/N8N). - Desenvolver Fluxo de Automação (Make/N8N): Crie um cenário/workflow que receba o payload do webhook, extraia as alterações do PR e chame a API do Claude.
- Elaborar Prompt de Revisão: Construa um prompt detalhado para o Claude, incluindo contexto do projeto, padrões de codificação e áreas de foco (segurança, performance, legibilidade).
- Processar Resposta do Claude: Configure o fluxo para formatar a resposta do Claude e postar os comentários da revisão diretamente no Pull Request do GitHub via API.
Core Workflows
Workflow 1: Revisão Automática de Pull Request com GitHub, N8N e Claude API
Este workflow automatiza a revisão inicial de Pull Requests (PRs) para identificar problemas comuns antes mesmo de um revisor humano intervir, acelerando o ciclo de desenvolvimento.
Passos Detalhados:
-
Configuração do Webhook GitHub:
- No seu repositório GitHub, vá em
Settings>Webhooks>Add webhook. - Payload URL:
https://your-n8n-instance.com/webhook/github-pr-review(substitua pelo seu endpoint N8N). - Content type:
application/json. - Secret:
SUA_CHAVE_SECRETA_WEBHOOK(opcional, mas recomendado para segurança). - Which events would you like to trigger this webhook?: Selecione
Let me select individual events.e marquePull requests. - Clique em
Add webhook.
- No seu repositório GitHub, vá em
-
Criação do Fluxo N8N (Exemplo):
- Nó 1: Webhook N8N:
- Tipo:
Webhook. - Modo:
POST. Webhook URL: Copie o URL gerado pelo N8N para usar no GitHub.Authentication: Configure conforme aSecretdo GitHub (ex:Header AuthcomX-Hub-Signature-256).
- Tipo:
- Nó 2: Extrair Detalhes do PR e Obter Diff:
- Tipo:
Code(JavaScript) para processar o payload inicial. - Objetivo: Extrair o URL do PR, o número do PR, o nome completo do repositório e, crucialmente, fazer uma chamada HTTP para obter o diff das alterações.
- Exemplo de código (assumindo que você tem um token GitHub armazenado em credenciais N8N):
const prUrl = $json.pull_request.url; const repoFullName = $json.pull_request.head.repo.full_name; const prNumber = $json.number; const prDiffUrl = $json.pull_request.diff_url; // URL para obter o diff // Retorna o URL do diff para o próximo nó HTTP Request return [{ json: { prUrl, repoFullName, prNumber, prDiffUrl } }];
- Tipo:
- Nó 3: Obter Diff do PR via GitHub API:
- Tipo:
HTTP Request. - Método:
GET. - URL:
{{ $json.prDiffUrl }} - Headers:
Authorization:token YOUR_GITHUB_TOKEN(token pessoal com permissõesrepo).Accept:application/vnd.github.v3.diff
- Salvar a resposta RAW (o diff) para o próximo nó.
- Tipo:
- Nó 4: Chamar Claude API para Revisão:
- Tipo:
HTTP Request. - Método:
POST. - URL:
https://api.anthropic.com/v1/messages - Headers:
x-api-key:{{ sua_claude_api_key }}anthropic-version:2023-06-01Content-Type:application/json
- Body (RAW JSON):
{ "model": "claude-3-opus-20240229", "max_tokens": 2000, "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Você é um revisor de código sênior para projetos JavaScript/TypeScript, focado em performance, segurança, legibilidade (ESLint/Prettier), e conformidade com boas práticas de Node.js. Analise o seguinte diff de Pull Request e forneça um feedback construtivo, listando os pontos de melhoria com exemplos de código quando aplicável. Use um tom profissional e objetivo. Priorize problemas críticos e sugestões de refatoração, especialmente em segurança e performance.\n\nDiff do PR:\n```diff\n{{ $node["Obter Diff do PR via GitHub API"].data.text }}\n```\n\nFormato esperado da resposta:\n\n### Sumário da Revisão\n[Resumo geral e impacto]\n\n### Pontos de Melhoria\n\n1. **[Título do Problema]**\n * **Severidade**: [Crítico/Alto/Médio/Baixo]\n * **Descrição**: [Explicação detalhada do problema e por que é um problema.]\n * **Localização**: [Arquivo:Linha(s)]\n * **Sugestão**: [Exemplo de como corrigir ou refatorar.]\n\n2. **[Outro Título do Problema]**\n * ...\n\n### Observações Adicionais\n[Comentários gerais ou
- Tipo:
- Nó 1: Webhook N8N:
04 同仓库更多 Skills
clarity-gate
Pre-ingestion verification for epistemic quality in RAG systems. Ensures documents are properly qualified before entering knowledge bases. Produces CGD (Clarity-Gated Documents) and validates SOT (Source of Truth) files.
skill-check
Validate Claude Code skills against the agentskills specification. Catches structural, semantic, and naming issues before users do.
peon-ping-use
Set which voice pack (character voice) plays for the current chat session. Automatically enables session_override rotation mode if not already set. Use when user wants a specific character voice like GLaDOS, Peon, or Kerrigan for this conversation.
mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate exte...
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browse...
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.