GitHub Deep Research Skill (Tiefenrecherche-Fähigkeit für GitHub)
Mehrstufige Recherche, die GitHub-API, web_search und web_fetch kombiniert, um umfassende Markdown-Berichte zu erstellen.
Recherche-Workflow
- Runde 1: GitHub-API
- Runde 2: Erkundung
- Runde 3: Tiefenuntersuchung
- Runde 4: Tiefer Einstieg
Kernmethodik
Abfragestrategie
Vom Breiten zum Schmalen: Beginne mit der GitHub-API, dann allgemeine Abfragen, verfeinere basierend auf Ergebnissen.
Runde 1: GitHub-API
Runde 2: „{Thema} Überblick"
Runde 3: „{Thema} Architektur", „{Thema} vs. Alternativen"
Runde 4: „{Thema} Issues", „{Thema} Roadmap", „site:github.com {Thema}"
Quellenpriorisierung:
- Offizielle Dokumentationen/Repos (höchstes Gewicht)
- Technische Blogs (Medium, Dev.to)
- Nachrichtenartikel (geprüfte Quellen)
- Community-Diskussionen (Reddit, HN)
- Soziale Medien (geringstes Gewicht, für Stimmungsbild)
Recherche-Runden
Runde 1 - GitHub-API
Führe scripts/github_api.py direkt ohne read_file() aus:
python /pfad/zum/skill/scripts/github_api.py <besitzer> <repo> summary
python /pfad/zum/skill/scripts/github_api.py <besitzer> <repo> readme
python /pfad/zum/skill/scripts/github_api.py <besitzer> <repo> tree
Verfügbare Befehle (das letzte Argument von github_api.py):
- summary
- info
- readme
- tree
- languages
- contributors
- commits
- issues
- prs
- releases
Runde 2 - Erkundung (3-5 web_search)
- Verschaffe dir einen Überblick und identifiziere wichtige Begriffe
- Finde die offizielle Website/das Repository
- Identifiziere die Hauptakteure/Wettbewerber
Runde 3 - Tiefenuntersuchung (5-10 web_search + web_fetch)
- Details zur technischen Architektur
- Zeitstrahl der wichtigsten Ereignisse
- Community-Stimmung
- Verwende web_fetch für wertvolle URLs, um den vollständigen Inhalt zu erhalten
Runde 4 - Tiefer Einstieg
- Analysiere den Commit-Verlauf für den Zeitstrahl
- Überprüfe Issues/PRs auf Feature-Entwicklung
- Prüfe die Aktivität der Mitwirkenden
Berichtsstruktur
Folge der Vorlage in assets/report_template.md:
- Metadaten-Block – Datum, Vertrauensniveau, Thema
- Zusammenfassung – 2-3 Sätze Überblick mit Schlüsselkennzahlen
- Chronologischer Zeitstrahl – Aufschlüsselung in Phasen mit Daten
- Wichtige Analyseabschnitte – Themenspezifische Tiefenbohrungen
- Metriken & Vergleiche – Tabellen, Wachstumsdiagramme
- Stärken & Schwächen – Ausgewogene Bewertung
- Quellen – Kategorisierte Referenzen
- Vertrauensbewertung – Behauptungen nach Vertrauensniveau
- Methodik – Verwendeter Forschungsansatz
Mermaid-Diagramme
Füge nach Bedarf Diagramme ein:
Zeitstrahl (Gantt):
gantt
title Projektzeitstrahl
dateFormat YYYY-MM-DD
section Phase 1
Entwicklung :2025-01-01, 2025-03-01
section Phase 2
Start :2025-03-01, 2025-04-01
Architektur (Flussdiagramm):
flowchart TD
A[Benutzer] --> B[Koordinator]
B --> C[Planer]
C --> D[Forschungsteam]
D --> E[Berichterstatter]
Vergleich (Kreis-/Balken):
pie title Marktanteil
„Projekt A" : 45
„Projekt B" : 30
„Sonstige" : 25
Vertrauensbewertung
Vertrauen basierend auf der Quellenqualität zuweisen:
| Vertrauen | Kriterium |
|---|---|
| Hoch (90 %+) | Offizielle Dokumentationen, GitHub-Daten, mehrere bestätigende Quellen |
| Mittel (70–89 %) | Einzelne zuverlässige Quelle, aktuelle Artikel |
| Niedrig (50–69 %) | Soziale Medien, nicht verifizierte Behauptungen, veraltete Informationen |
Ausgabe
Bericht speichern als: research_{thema}_{JJJJMMTT}.md
Formatierungsregeln
- Keine spezifische Regel für chinesische Inhalte (Standard-Zeichensetzung verwenden)
- Technische Begriffe: Bei erster Erwähnung Wiki-/Dokumentations-URL angeben
- Tabellen: Für Metriken, Vergleiche verwenden
- Codeblöcke: Für technische Beispiele
- Mermaid: Für Architektur, Zeitstrahlen, Abläufe
Best Practices
- Beginne mit offiziellen Quellen – Repository, Dokumentation, Unternehmensblog
- Überprüfe Daten aus Commits/PRs – Zuverlässiger als Artikel
- Trianguliere Behauptungen – 2+ unabhängige Quellen
- Widersprüchliche Informationen vermerken – Widersprüche nicht verstecken
- Unterscheide Fakten von Meinungen – Spekulation klar kennzeichnen
- KRITISCH: Immer Inline-Zitate einfügen – Verwende das Format
[citation:Titel](https://raw.githubusercontent.com/bytedance/deer-flow/main/URL)unmittelbar nach jeder Behauptung aus externen Quellen - Extrahiere URLs aus Suchergebnissen – web_search gibt {titel, url, snippet} zurück – verwende immer das URL-Feld
- Synthetisiere während des Vorgehens – Warte nicht bis zum Ende, um zu synthetisieren
Zitierbeispiele
Gut – Mit Inline-Zitaten:
Das Projekt erhielt innerhalb von 3 Monaten nach dem Start 10.000 Sterne [citation:GitHub Stats](https://github.com/owner/repo).
Die Architektur verwendet LangGraph zur Workflow-Orchestrierung [citation:LangGraph Docs](https://langchain.com/langgraph).
Schlecht – Ohne Zitate:
Das Projekt erhielt innerhalb von 3 Monaten nach dem Start 10.000 Sterne.
Die Architektur verwendet LangGraph zur Workflow-Orchestrierung.