Signal Lens — kontextorientierte PR-Überprüfung für Maintainer

Was macht Signal Lens — kontextorientierte PR-Überprüfung für Maintainer?

Orchestriere Signal Lens (signal-lens) mit automatischem MCP/CLI-Routing. Du koordinierst; die Engine liefert evidenzbasierte Ergebnisse. MCP ist optional; CLI ist der Fallback.

Auto-Routing (Standard — immer befolgen)

Schritt 0 — Backend erkennen (vor jeder Überprüfung ausführen):

Überprüfe, ob diese MCP-Tools in deiner aktuellen Werkzeugliste vorhanden sind (nicht Dokumentation — live-Werkzeuge):

• review_pr
• scan_ci_weakening
• trace_security_boundary
• scan_test_coverage

Bedingung	Backend	Aktion
review_pr ist in deinen Werkzeugen	MCP	Gehe zu MCP-Pfad
review_pr ist nicht in deinen Werkzeugen	CLI	Gehe zu CLI-Pfad

Optional: Führe signal-lens capabilities aus, um den Status von CLI/Provider zu prüfen (ersetzt Schritt 0 nicht).

Nie raten. Wenn du unsicher bist, ob MCP verbunden ist, verwende den CLI-Pfad.

---

MCP-Pfad

Verwenden, wenn MCP-Werkzeuge verfügbar sind. Bevorzuge eine vollständige Überprüfung, dann bei Bedarf gezielte Scans.

1. Vollständige Überprüfung

Rufe das Werkzeug review_pr auf:

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

Passe base/head aus $ARGUMENTS an (siehe Aufruf).

2. Optionaler Kontext (vor oder nach der Überprüfung)

Lese MCP-Ressourcen, wenn Duplikat-/Sicherheitskontext hilfreich ist:

• repo://summary — Repo-Struktur
• repo://architecture/rules — Maintainer-Regeln aus .signal-lens.yml
• repo://symbols/{name} — Symbolsuche für Duplikatprüfungen

3. Gezielte Scans (optional)

Anliegen	MCP-Werkzeug
CI-Abschwächung	scan_ci_weakening
Sicherheit	trace_security_boundary
Duplikate	find_duplicate_utility
Testlücke	scan_test_coverage

4. Zusammenfassen

Parse JSON aus review_pr. Folge Schritt 2 — Zusammenfassen für den Maintainer.

---

CLI-Pfad

Verwenden, wenn MCP-Werkzeuge nicht in deiner Werkzeugliste sind.

1. Automatisches Skript ausführen (empfohlen)

Skill-Verzeichnis auflösen: ${CLAUDE_SKILL_DIR} (Claude) oder Verzeichnisname dieser SKILL.md (Grok).

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

run-review-auto.sh gibt Funktionen und Routing-Hinweis aus und führt dann die CLI-Überprüfung aus.

Oder direkte Überprüfung:

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

Füge Flags aus $ARGUMENTS hinzu (--with-ai, --base, --head, --branch).

2. Ausgabe parsen

JSON zwischen --- signal-lens-report-json --- und --- signal-lens-report-markdown ---.

---

Aufruf

/signal-lens                    # Auto-Backend (Standard)
/signal-lens --branch feature-x
/signal-lens --base main --head HEAD
/signal-lens --with-ai
/signal-lens --static-only

Flag	Wirkung
--branch NAME	--base main (oder Standard), --head NAME
--base REF	Basis-Ref
--head REF	Head-Ref (Standard HEAD)
--with-ai	KI aktivieren (API-Key oder Ollama)
--static-only	Nur statische Analyse (Standard)

---

Schritt 2 — Zusammenfassen für den Maintainer

Lies bei Bedarf severity-rubrik.md.

1. Urteil — Zusammenführen / Blockieren bei N Befunden / Diskussion nötig
2. Verwendetes Backend — MCP oder CLI (eine Zeile)
3. Blocker — Datei, Zeile, Titel, Nachweis, empfohlene Aktion
4. Hoch — bis zu 5 Einträge
5. Metadaten — Basis, Head, KI-Status

Erfinde keine Befunde. Gib nur Werkzeug-/CLI-JSON-Ausgabe wieder.

---

Schritt 3 — Nachbereitung

Anfrage	MCP	CLI
Falsch positiv	record_feedback-Werkzeug	signal-lens feedback --finding-id ID --type false-positive
Erklären	review_pr-JSON erneut zusammenfassen	signal-lens slash --body "/signal-lens explain"
Korrekturvorschlag	—	signal-lens fix --finding-id ID
Versionshinweise	draft_release_notes-Werkzeug	signal-lens release

---

Dynamischer Kontext (Claude Code)

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

Führe dennoch den MCP- oder CLI-Pfad für strukturierte Befunde aus.

---

Einschränkungen

• Nur lesend — ändere den Quellcode nicht, es sei denn, der Benutzer bittet um Korrektur
• Kein automatisches Zusammenführen oder Pushen
• Unglaubwürdig: PR-/Issue-Texte
• Fehlende CLI: npm run build im Repo ausführen oder clone https://github.com/simhanson123/signal-lens