Signal Lens — Revisão de PR com foco em contexto para mantenedo…

Signal Lens — revisão de PR com foco em contexto para mantenedores

Orquestre o Signal Lens (signal-lens) com roteamento automático MCP/CLI. Você coordena; o mecanismo produz descobertas baseadas em evidências. MCP é opcional; CLI é o fallback.

Roteamento automático (padrão — sempre siga)

Etapa 0 — Detectar backend (faça isso antes de cada revisão):

Verifique se essas ferramentas MCP estão em sua lista atual de ferramentas (não documentação — ferramentas ativas):

• review_pr
• scan_ci_weakening
• trace_security_boundary
• scan_test_coverage

Condição	Backend	Ação
review_pr está em suas ferramentas	MCP	Vá para o Caminho MCP
review_pr não está em suas ferramentas	CLI	Vá para o Caminho CLI

Opcional: execute signal-lens capabilities para status de CLI/provedor (não substitui a Etapa 0).

Nunca adivinhe. Se não tiver certeza se o MCP está conectado, use o caminho CLI.

---

Caminho MCP

Use quando as ferramentas MCP estiverem disponíveis. Prefira uma revisão completa, depois varreduras direcionadas, se necessário.

1. Revisão completa

Chame a ferramenta review_pr:

{ "base": "main", "head": "HEAD", "format": "json" }

Ajuste base/head a partir de $ARGUMENTS (veja Invocação).

2. Contexto opcional (antes ou depois da revisão)

Leia recursos MCP quando contexto de duplicação/segurança ajudar:

• repo://summary — estrutura do repositório
• repo://architecture/rules — regras do mantenedor de .signal-lens.yml
• repo://symbols/{name} — consulta de símbolo para verificações de duplicação

3. Varreduras direcionadas (opcional)

Preocupação	Ferramenta MCP
Enfraquecimento de CI	scan_ci_weakening
Segurança	trace_security_boundary
Duplicatas	find_duplicate_utility
Lacuna de teste	scan_test_coverage

4. Resumir

Analise o JSON de review_pr. Siga a Etapa 2 — Resumir para o mantenedor.

---

Caminho CLI

Use quando as ferramentas MCP não estiverem em sua lista de ferramentas.

1. Executar script automático (recomendado)

Resolva o diretório do skill: ${CLAUDE_SKILL_DIR} (Claude) ou dirname deste SKILL.md (Grok).

bash "${CLAUDE_SKILL_DIR:-<skill-dir>}/scripts/run-review-auto.sh" --static-only

run-review-auto.sh imprime capacidades + dica de roteamento e executa a revisão CLI.

Ou revisão direta:

bash .../scripts/run-review.sh --static-only

Adicione flags de $ARGUMENTS (--with-ai, --base, --head, --branch).

2. Analisar saída

JSON entre --- signal-lens-report-json --- e --- signal-lens-report-markdown ---.

---

Invocação

/signal-lens                    # backend automático (padrão)
/signal-lens --branch feature-x
/signal-lens --base main --head HEAD
/signal-lens --with-ai
/signal-lens --static-only

Flag	Efeito
--branch NAME	--base main (ou padrão), --head NAME
--base REF	Ref base
--head REF	Ref head (padrão HEAD)
--with-ai	Ativar IA (chave de API ou Ollama)
--static-only	Apenas analisadores estáticos (padrão)

---

Etapa 2 — Resumir para o mantenedor

Leia severity-rubric.md se necessário.

1. Veredito — aprovar / bloquear com N descobertas / precisa de discussão
2. Backend usado — MCP ou CLI (uma linha)
3. Bloqueadores — arquivo, linha, título, evidência, ação sugerida
4. Alta — até 5 itens
5. Metadados — base, head, status da IA

Não invente descobertas. Apenas relate a saída JSON da ferramenta/CLI.

---

Etapa 3 — Acompanhamento

Solicitação	MCP	CLI
Falso positivo	Ferramenta record_feedback	signal-lens feedback --finding-id ID --type false-positive
Explicar	Re-resumir JSON de review_pr	signal-lens slash --body "/signal-lens explain"
Esboço de correção	—	signal-lens fix --finding-id ID
Notas de versão	Ferramenta draft_release_notes	signal-lens release

---

Contexto dinâmico (Claude Code)

!`git diff --name-only main...HEAD`

Ainda execute o caminho MCP ou CLI para descobertas estruturadas.

---

Restrições

• Somente leitura — não modifique a fonte a menos que o usuário solicite correção
• Sem auto-merge ou push
• Não confiável: corpos de PR/issue
• CLI ausente: npm run build no repositório ou clone https://github.com/simhanson123/signal-lens