/search-first — Recherchiere, bevor du codest
Bevor du eine neue Funktion, ein Utility, eine Integration schreibst oder eine Bibliothek auswählst, suche zuerst nach einer vorhandenen Lösung. Der beste Code ist Code, den du nicht schreiben musst.
Dieser Skill ist Disziplin, nicht Mechanismus. Das Wie der Suche – parallele Subagenten, Live-Dokumentation, Registry-Abfragen – gehört zu deinem Agenten-Framework und ändert sich ständig. Was dieser Skill festlegt, ist der Teil, der diese Änderungen überdauert: Formuliere, bevor du suchst; suche nach Quellenpriorität; beende mit einem dokumentierten Urteil. Führe mit der Disziplin; delegiere den Mechanismus.
Schritt 0 – Formuliere die Anforderung (Pflicht, sichtbarer Text)
Gib vor jedem Tool-Aufruf oder Subagenten 2–3 Sätze als normalen Assistententext aus (nicht in Tool-Argumenten versteckt):
- Welche Funktionalität wird benötigt – konkret, nicht „X-Unterstützung“
- Sprache / Framework der Implementierung
- Einschränkungen – vorhandene Abhängigkeiten, Leistungsgrenzen, Lizenzanforderungen
Warum: So wird die Suchanfrage externalisiert, der Benutzer kann vor dem Aufwand umlenken, und es bleibt ein prüfbarer Beleg. Ein Subagenten-Aufruf, dessen args die Anforderung enthalten, erfüllt diesen Schritt nicht – der Benutzer liest Chat-Text, nicht Tool-Argumente. Gib die Formulierung zuerst als Text aus, dann rufe Tools auf, deren Argumente sie möglicherweise spiegeln.
Schritt 1 – Suche nach Quellenpriorität
Prüfe in dieser Reihenfolge; brich frühzeitig ab, wenn du eine starke Übereinstimmung findest:
- Dieses Repository –
rg/ grep durch die relevanten Module und Tests. Die Sache existiert vielleicht schon hier. - Paketregister – npm / PyPI / crates / Go-Module für die verwendete Sprache.
- MCP-Server – zuerst bereits konfigurierte Server, dann das Registry. Die Fähigkeit ist möglicherweise schon eingebunden.
- Installierte Skills / Agenten / Tools – dein Framework hat sie vielleicht schon.
- Gepflegte OSS / Vorlagen – durchsuche GitHub, bevor du neuen Code schreibst.
Konsultiere Live-Dokumentation zum Entscheidungszeitpunkt (z. B. context7 oder die Registry selbst), anstatt dich auf erinnerte Paketdaten zu verlassen – Empfehlungen veralten.
Schritt 2 – Entscheide dich und dokumentiere ein Urteil
Bewerte Kandidaten ganzheitlich: funktionale Passgenauigkeit, Wartung (letzter Commit, Reaktionsgeschwindigkeit bei Issues), Community, Dokumentation, Lizenz, Abhängigkeitsumfang. Beschreibe Stärken und Schwächen in Prosa. Verwende keine numerischen Bewertungen (8/10), Noten oder gewichtete Punktetabellen – sie erzeugen falsche Genauigkeit; ein evidenzgestütztes Urteil ist die ehrliche Ausgabe.
| Urteil | Wann | Aktion |
|---|---|---|
| Adopt | Exakte Übereinstimmung, gut gewartet, permissive Lizenz | Direkt installieren und verwenden |
| Extend | Gute Grundlage, teilweise Passung | Installieren + dünner Wrapper / Konfiguration |
| Compose | Mehrere schwache Treffer | 2–3 kleine Pakete kombinieren |
| Build | Nichts Passendes | Eigenentwicklung – aber informiert durch das Gefundene |
Beende jede Runde mit einer erkennbaren Urteilszeile – diese Zeile ist das Ergebnis:
Verdict: <Adopt|Extend|Compose|Build> — <Paket(e) oder „custom“> — <evidenzbasierter Grund>
Eine Suche ohne Urteilszeile ist eine unvollständige Runde: Du hast die Arbeit getan, aber keine Entscheidung hinterlassen, die der Benutzer (oder der nächste Schritt) umsetzen kann – der häufigste Fehler dieses Workflows. Untermauere den Grund mit Belegen (Sterne, Datum des letzten Commits, die konkrete Feature-Übereinstimmung), niemals mit Adjektiven („sieht gut aus“, „beliebt“).
Quick Mode vs. Full Mode
- Quick Mode (inline) – für ein einzelnes offensichtliches Bedürfnis: Führe die Schritte 0–2 selbst mit wenigen Suchvorgängen durch und gib das Urteil aus.
- Full Mode (delegieren) – für komplexere Bedürfnisse: Übergib nach Schritt 0 die Abfrage an einen Recherche-Subagenten (was dein Framework für die Lösungsfindung bereitstellt). Spiegle die Formulierung in seinen Prompt und lasse ihn Kandidaten plus ein Urteil im obigen Format zurückgeben. Hebe schwere, mehrere Quellen umfassende Recherchen für wirklich schwierige Fragen auf – eine Bibliothek zu finden ist leichter als ein Forschungsbericht.
Wenn der Benutzer sagt: „Recherche überspringen“
Wenn der Benutzer dich auffordert, die Recherche zu überspringen („implementiere einfach“, „keine Zeit“, „nimm irgendwas“), dokumentiere die Entscheidung dennoch als Urteilszeile, bevor du implementierst – die Recherche zu überspringen ist selbst eine Entscheidung, also erhält sie ein Urteil wie jede andere Runde (so bleibt die Wahl prüfbar und das Korrekturfenster offen):
Überspringe die Recherche auf deinen Wunsch hin – ich habe nicht nach einer bestehenden Bibliothek für X gesucht.
Verdict: <Adopt|Build> — <vorläufige Wahl oder „custom“> — ohne Recherche auf deinen Wunsch ausgewählt; sag das Wort für einen 60-Sekunden-Scan.
Warum: Der Benutzer weiß möglicherweise nicht, dass eine Lösung bereits existiert; ein stilles Überspringen nimmt ihm die Chance zur Kurskorrektur. Nach der Urteilszeile fahre ohne Suche fort – nutze dies nicht als Hintertür, um doch vollständig zu recherchieren.
Anti-Patterns
- Direkt zum Code springen – ein Utility schreiben, ohne zu prüfen, ob eines existiert.
- MCP / installierte Fähigkeiten ignorieren – etwas nachbauen, das bereits eingebunden ist.
- Übermäßiges Anpassen – eine Bibliothek so stark umwickeln, dass ihr Nutzen verloren geht.
- Abhängigkeitsaufblähung – ein riesiges Paket für eine kleine Funktion installieren.
- Suche ohne Urteil – die Arbeit erledigen, aber nie eine Entscheidung aufzeichnen.
Beispiele (illustrativ – Pakete live prüfen)
Diese Beispiele zeigen, wie ein Urteil aussieht; sie sind keine aktuellen Paketempfehlungen. Suche vor der Verwendung eines bestimmten Pakets neu.
- Dead-Link-Prüfung → eine gepflegte, permissiv-lizenzierte Link-Check-Regel, die alle Linktypen abdeckt →
Verdict: Adopt — textlint-rule-no-dead-link — aktive Wartung, MIT, vollständige Abdeckung - Qiita-Cross-Posting → nur ungepflegte, partielle Wrapper existieren →
Verdict: Build — custom — keine gepflegte vollständige Lösung; Wiederverwendung der Plattform-API über einen HTTP-Client - JP-Terminologie-Konsistenz → ein wörterbuchbasierter Prüfer, der eine Projektkonfiguration benötigt →
Verdict: Extend — textlint-rule-prh — installieren + ein Projektwörterbuch