CommunityRecherche & Datenanalysegithub.com

steipete/github-deep-review

Tiefgehende GitHub-Überprüfung: Bugs, PRs, beste Lösung, stale-or-real, Code zuerst lesen.

Was ist github-deep-review?

Diese Fähigkeit (Skill) für KI-Agenten wie Claude Code ermöglicht eine tiefgehende, evidenzbasierte Überprüfung von GitHub-Issues und Pull-Requests. Das Ziel ist nicht nur eine Zusammenfassung, sondern das Verständnis der Bug-Klasse, die Identifikation der wahren Ursache, die Bewertung der besten Lösung nach gründlicher Code-Lektüre und die Entscheidung, ob eine größere Refaktorisierung sinnvoll wäre. Der Agent wird angewiesen, `gh`-CLI-Befehle anstelle des Webbrowsers zu verwenden, die Code-Tiefe entlang des gesamten Aufrufpfads zu verfolgen und für nicht von Peter stammende Autoren zusätzlichen Autorenkontext zu sammeln. Die Überprüfung folgt einem klaren Vertrag: Sie beantwortet explizit Fragen zur Ursache, Herkunft von Regressionen, Qualität der Lösung und verbleibenden Risiken, und vermeidet vage Kommentare. Sie ist besonders nützlich für Entwicklerteams, die hohe Qualitätsstandards für Code-Reviews anstreben und sicherstellen wollen, dass Entscheidungen auf soliden Beweisen basieren.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-deep-review

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

GitHub Deep Review

Review wie Peter: hohe Sicherheit, evidenzbasiert, code-bewusst, und bereit, „nicht belegt“ zu sagen, wenn die Spur schwach ist. Das Ziel ist keine allgemeine Zusammenfassung. Das Ziel ist es, die Bug-Klasse zu verstehen, die wirkliche Ursache zu finden, wenn möglich die beste Lösung nach ausreichendem Lesen des Codes zu bestimmen und darauf hinzuweisen, ob eine größere Refaktorisierung das Design verbessern würde.

Start

Verwenden Sie gh, nicht die Web-Browsing, für GitHub-Referenzen:

gh issue view <n> --json number,title,state,author,body,comments,labels,updatedAt,url
gh pr view <n> --json number,title,state,author,body,comments,reviews,files,commits,statusCheckRollup,mergeStateStatus,headRefName,headRepositoryOwner,url
gh pr diff <n> --patch

Für PRs sammeln Sie standardmäßig den Autorenkontext, es sei denn, der Autor ist Peter (steipete oder ein offensichtliches Peter-Konto). Verwenden Sie den lokalen Workflow in ~/Projects/agent-scripts/skills/github-author-context/SKILL.md und fügen Sie einen kurzen Author context:-Block nahe dem Anfang des Reviews ein, wenn der Autor nicht Peter ist. Nach Merge/Ablehnung/Schließen/Review verwenden Sie denselben Autorenkontext-Workflow, um einen Beitragshinweis anzuhängen, jedoch nur, wenn die Interaktion ein dauerhaftes Signal für zukünftige Reviews erzeugt.

Für repo-lokale Reviews überprüfen Sie auch:

git status --short --branch
git fetch origin
git log --oneline --decorate -20
rg "<key symbol/error/config/endpoint>"

Wenn das Repository lokale Anweisungen, Issue/PR-Skills, Dokumentationslisten, Testanleitungen oder Maintainer-Runbooks enthält, lesen Sie diese vor einer Entscheidung.

Review-Vertrag

Beantworten Sie immer diese Fragen explizit:

  • URL/Ref: Issue- oder PR-Nummer und betroffene Oberfläche.
  • Was ist der Bug oder das Verhalten, das behoben wird?
  • Können wir die Grundursache identifizieren? Wenn ja, wo im Code und warum. Wenn nein, welche Beweise fehlen.
  • Für Regressionen: Wer/was hat sie eingeführt und wann? Fügen Sie Commit/PR-Herkunft bei, wenn diese durch eine begrenzte Historie nachvollziehbar ist; sagen Sie „unbekannt“ anstatt zu raten.
  • Ist die aktuelle/vorgeschlagene Lösung die beste mögliche Lösung nach dem Lesen des angrenzenden Codes?
  • Würde eine größere Refaktorisierung Korrektheit, Klarheit oder zukünftige Wartbarkeit verbessern?
  • Welche Beweise existieren: Tests, Live-Reproduktion, CI-Prüfungen, Dokumentation, Abhängigkeitsdokumentation/-quellen, ausgeliefertes/aktuelles Verhalten.
  • Was bleibt riskant oder unverifiziert.

Code-Lesetiefe

Lesen Sie über die erste geänderte Datei hinaus. Verfolgen Sie den tatsächlichen Aufrufpfad:

  • Einstiegspunkt -> Validierung/Parsing -> Routing/Dispatch -> Besitzer-Modul -> gemeinsamer Helfer -> Persistenz/Netzwerk/Laufzeit-Grenze
  • Konfiguration/Schema/Dokumentation -> Laufzeitnutzung -> Doctor/Migrations-/Fehlerbehebungspfad
  • Provider/Kanal/Plugin-Besitzer-Code -> generischer Kern-Seam, nur wenn mehrere Besitzer ihn benötigen
  • Tests rund um die betroffene Oberfläche plus angrenzende Regressionstests

Wenn das Verhalten von einer Abhängigkeit abhängt, lesen Sie die Upstream-Dokumentation/Quellen/Typen oder den aktuellen Paketvertrag, bevor Sie Annahmen treffen.

Bevorzugen Sie aktuelle Quellen und ausführbare Beweise gegenüber Issue-Kommentaren. Behandeln Sie veraltete Kommentare, alte CI- und alte Release-Verhalten als Hinweise, bis sie erneut überprüft werden.

Herkunft

Für Bug-/Regressions-Reviews fügen Sie, wenn möglich, eine kompakte Provenance:-Antwort ein:

  • Verwenden Sie git log -S/-G, git blame, verlinkte PRs/Issues und Tests.
  • Trennen Sie Autor, Committer/Merger und aktuellen PR-Autor, wenn diese unterschiedlich sind.
  • Formulieren Sie als introduced by, made visible by oder carried forward by.
  • Fügen Sie Vertrauensniveau ein: clear, likely oder unknown.
  • Für Features, Dokumentationen, Refaktorisierungen oder nicht nachvollziehbare Bugs schreiben Sie N/A oder sagen Sie, welche Beweise fehlen.

Qualitätsbar für Lösungen

Gute Lösungen:

  • liegen an der Besitzergrenze, zu der der Bug gehört
  • bewahren das öffentliche/abwärtskompatible Verhalten, es sei denn, das Issue betrifft dessen Außerdienststellung
  • fügen einen Regressionstest an der kleinsten sinnvollen Nahtstelle hinzu
  • vermeiden breite Sonderfälle, versteckte Migrationen, semantische Sentinelwerte und Provider-/Kanal-IDs im generischen Kern
  • aktualisieren die Dokumentation/Changelog, wenn sich das benutzersichtbare Verhalten ändert
  • scheitern klar in Laufzeitpfaden und reparieren durch Doctor-/Migrationspfade, wenn dies der etablierte Vertrag ist

Weisen Sie darauf hin, wenn eine Lösung nur Symptomebene ist. Wenn eine etwas größere Refaktorisierung die Invariante offensichtlich macht und zukünftige Fehler reduziert, empfehlen Sie sie. Wenn die Refaktorisierung das Risiko erhöht, ohne die Bug-Klasse zu verbessern, sagen Sie das.

PR-Review-Format

Führen Sie bei der Überprüfung eines PRs mit Ergebnissen an. Ergebnisse benötigen Datei/Zeilen/Symbol-Referenzen und eine konkrete Fehlerbeschreibung. Vermeiden Sie vage „überlegenswert“-Kommentare.

Wenn keine blockierenden Probleme vorliegen:

  • sagen Sie, dass keine blockierenden Korrektheitsprobleme gefunden wurden
  • listen Sie die stärksten überprüften Beweise auf
  • nennen Sie verbleibende Risiken/Testlücken
  • beantworten Sie, ob das Design die beste verfügbare Form ist

Genehmigen, kommentieren, schließen, mergen, pushen oder landen Sie nicht, es sei denn, der Benutzer hat diese Aktion angefordert.

Issue-Review-Format

Für Bugs/Issues:

  1. Rekonstruieren Sie das Szenario des Reporters und die betroffene Version/Oberfläche.
  2. Prüfen Sie, ob der aktuelle main das Problem bereits behebt.
  3. Reproduzieren Sie das Problem oder erstellen Sie einen minimalen lokalen/Live-Beweis, wenn möglich.
  4. Wenn klar, identifizieren Sie die Grundursache und eine vorgeschlagene Fix.
  5. Wenn auf main gelöst, kommentieren/schließen Sie nur, wenn der Benutzer danach fragt; fügen Sie Beweise und den kanonischen Commit/PR bei, falls bekannt.

Wenn eine Reproduktion nicht möglich ist, sagen Sie genau, was sie blockiert und welche Beweise die Entscheidung zuverlässig machen würden.

Ausgabevorlage

Verwenden Sie diese Form, wenn der Benutzer fragt „worum geht es hier“, „ist das der beste Fix“ oder „was haben wir repariert“:

Ref: #123 / PR #456
Surface: <runtime/CLI/provider/channel/docs>

Bug: <ein oder zwei Sätze>
Cause: <Codepfad + Vertrauensniveau>
Provenance: <introduced/made visible/carried forward by commit/PR/date, or N/A/unknown>
Best fix: <was sich ändern sollte und warum>
Refactor: <ja/nein, spezifische Form>
Proof: <tests/live/CI/source/dependency docs>
Risk: <verbleibende Unsicherheit>

Halten Sie es prägnant, aber überspringen Sie nicht die Entscheidung über Ursache/Lösung/Refaktorisierung/Beweis.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Verwandte Skills