Research Skill
Untersuche ein technisches Problem effizient und halte das Gelernte fest, damit das Team nie wieder dasselbe Thema zweimal recherchiert.
1. Thema eingenzen
Extrahiere aus der Nachricht des Benutzers (frage nur nach, wenn es wirklich unklar ist):
- Topic-Slug: Ordner-Name in Kleinschrift mit Bindestrichen, z.B.
bluetooth-audio-routing - Stack: Plattform/Sprache/Framework
- Symptom: beobachtetes vs. erwartetes Verhalten
- Bekannt: bereits ausprobiere Hypothesen
2. Arbeitsbereich vorbereiten
Führe scripts/init-research.sh {topic-slug} aus, um den docs-Ordner zu erstellen.
3. 3 Standard-Agenten parallel starten
Jeder Agent erhält eine einzeilige Perspektive plus den geteilten Kontext. Lies reference/agent-prompts.md, wenn du die genaue Formulierung der Anweisungen benötigst.
- Codebasis-Analyse (Explore-Agent) — finde relevanten Code, Lücken, Datei:Zeile-Referenzen.
- Ursachenforschung (Web-Agent) — warum es auf OS/Framework/Protokoll-Ebene passiert.
- Lösungen & Validierung (Web-Agent) — native APIs, Bibliotheken, durch die Community bestätigte Korrekturen.
Starte die optionalen 4. und 5. Agenten nur, wenn der Benutzer ausdrücklich nach Bibliotheksvergleichen oder plattformübergreifenden API-Deep-Dives fragt.
4. Synthese
Erstelle genau diese beiden Dateien:
docs/{topic}/NOTAS.md— rohe Ergebnisse, Code-Ausschnitte, URLs, schnelle Beobachtungen.docs/{topic}/RESEARCH_CONSOLIDADO.md— strukturiertes Master-Dokument.
Verwende reference/consolidated-template.md nur, wenn du die vollständige Vorlage benötigst.
Optionale Detaildateien (03_android_api.md, 04_librerias.md usw.) werden nur erstellt, wenn die Ergebnisse sie rechtfertigen.
5. Abschluss
Führe scripts/finalize-research.sh {topic-slug} aus, um zu prüfen, ob das Master-Dokument existiert, und füge eine Iterationszeile hinzu. Melde dann dem Benutzer:
- Ursache (mit Datei:Zeile, falls zutreffend)
- Top 3 nicht offensichtliche Erkenntnisse
- Erstellte Dateien
- Vorgeschlagener nächster Schritt
Halte den Chat-Bericht knapp; die Details stehen in den Dokumenten.