Signal Lens — Revue de PR contextuelle pour mainteneurs

Que fait Signal Lens — Revue de PR contextuelle pour mainteneurs ?

Orchestrez Signal Lens (signal-lens) avec routage automatique MCP/CLI. Vous coordonnez ; le moteur produit des conclusions fondées sur des preuves. MCP est optionnel ; CLI est le repli.

Auto-routage (par défaut — toujours à suivre)

Étape 0 — Détecter le backend (à faire avant chaque revue) :

Vérifiez si ces outils MCP sont dans votre liste d'outils actuelle (pas dans la documentation — outils en direct) :

• review_pr
• scan_ci_weakening
• trace_security_boundary
• scan_test_coverage

Condition	Backend	Action
review_pr est dans vos outils	MCP	Aller au chemin MCP
review_pr n'est pas dans vos outils	CLI	Aller au chemin CLI

Optionnel : exécutez signal-lens capabilities pour l'état du CLI/fournisseur (ne remplace pas l'Étape 0).

Ne devinez jamais. Si vous n'êtes pas sûr que MCP soit connecté, utilisez le chemin CLI.

---

Chemin MCP

À utiliser lorsque les outils MCP sont disponibles. Préférez une revue complète, puis des analyses ciblées si nécessaire.

1. Revue complète

Appelez l'outil review_pr :

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

Ajustez base/head à partir de $ARGUMENTS (voir Invocation).

2. Contexte optionnel (avant ou après la revue)

Lisez les ressources MCP lorsque le contexte de duplication ou de sécurité aide :

• repo://summary — structure du dépôt
• repo://architecture/rules — règles du mainteneur depuis .signal-lens.yml
• repo://symbols/{name} — recherche de symbole pour les vérifications de doublons

3. Analyses ciblées (optionnelles)

Préoccupation	Outil MCP
Affaiblissement CI	scan_ci_weakening
Sécurité	trace_security_boundary
Doublons	find_duplicate_utility
Lacune de test	scan_test_coverage

4. Résumer

Analysez le JSON de review_pr. Suivez Étape 2 — Résumer pour le mainteneur.

---

Chemin CLI

À utiliser lorsque les outils MCP ne sont pas dans votre liste d'outils.

1. Exécuter le script automatique (recommandé)

Résolvez le répertoire de la compétence : ${CLAUDE_SKILL_DIR} (Claude) ou le nom du répertoire de ce fichier SKILL.md (Grok).

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

run-review-auto.sh affiche les capacités + l'indication de routage, puis exécute la revue CLI.

Ou revue directe :

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

Ajoutez des drapeaux depuis $ARGUMENTS (--with-ai, --base, --head, --branch).

2. Analyser la sortie

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

---

Invocation

/signal-lens                    # backend automatique (par défaut)
/signal-lens --branch feature-x
/signal-lens --base main --head HEAD
/signal-lens --with-ai
/signal-lens --static-only

Drapeau	Effet
--branch NAME	--base main (ou défaut), --head NAME
--base REF	Référence de base
--head REF	Référence de tête (défaut HEAD)
--with-ai	Activer l'IA (clé API ou Ollama)
--static-only	Analyseurs statiques uniquement (défaut)

---

Étape 2 — Résumer pour le mainteneur

Lisez severity-rubric.md si nécessaire.

1. Verdict — fusionner / bloquer sur N résultats / nécessite discussion
2. Backend utilisé — MCP ou CLI (une ligne)
3. Bloqueurs — fichier, ligne, titre, preuve, action suggérée
4. Haute — jusqu'à 5 éléments
5. Métadonnées — base, head, statut IA

N'inventez pas de résultats. Rapporter uniquement la sortie JSON de l'outil/CLI.

---

Étape 3 — Suivi

Demande	MCP	CLI
Faux positif	outil record_feedback	signal-lens feedback --finding-id ID --type false-positive
Expliquer	re-résumer le JSON review_pr	signal-lens slash --body "/signal-lens explain"
Brouillon de correction	—	signal-lens fix --finding-id ID
Notes de version	outil draft_release_notes	signal-lens release

---

Contexte dynamique (Claude Code)

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

Exécutez quand même le chemin MCP ou CLI pour des résultats structurés.

---

Contraintes

• Lecture seule — ne modifiez pas la source sauf si l'utilisateur demande une correction
• Pas de fusion ou push automatique
• Non fiable : les corps de PR/issues
• CLI manquant : npm run build dans le dépôt ou clone https://github.com/simhanson123/signal-lens