Communitygithub.com

shimo4228/search-first

Compétence Claude Code : force les agents à rechercher les solutions existantes avant de coder — réduit la réinvention

Qu'est-ce que search-first ?

Cette compétence impose une discipline de recherche avant toute implémentation, afin d'éviter de réinventer la roue. Elle guide l'agent à travers un processus structuré : articuler clairement le besoin, effectuer des recherches par ordre de priorité (dépôt actuel, registres de paquets, serveurs MCP, outils installés, OSS maintenu), puis rendre un verdict exploitable (Adopter, Étendre, Composer, Construire). Le verdict final est obligatoire : sans lui, la passe de recherche est incomplète. La compétence prend en charge un mode rapide pour les besoins simples et un mode délégué pour les questions complexes confiées à un sous-agent. Utile sur Claude Code, Cursor, Codex et toute plateforme d'agent de codage où l'on souhaite réduire le code inutile et améliorer la qualité des décisions.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/search-first

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/search-first — Rechercher avant de coder

Avant d'écrire une nouvelle fonctionnalité, un outil utilitaire, une intégration ou de choisir une bibliothèque, recherchez d'abord une solution existante. Le meilleur code est celui que vous n'avez pas à écrire.

Cette compétence repose sur la discipline, pas sur le mécanisme. Le comment de la recherche — sous-agents parallèles, documentation en direct, requêtes de registre — appartient à votre harnais d'agent et change constamment. Ce que cette compétence fixe, c'est la partie qui survit à ces changements : articuler avant de chercher, chercher par priorité de source, et terminer par un verdict enregistré. Menez avec la discipline ; déléguez le mécanisme.

Étape 0 — Articuler le besoin (obligatoire, texte visible par l'utilisateur)

Avant tout appel d'outil ou sous-agent, écrivez 2–3 phrases de texte d'assistant en clair (pas enfoui dans les arguments d'un outil) indiquant :

  • Quelle fonctionnalité est nécessaire — concrètement, pas « support X »
  • Langage / framework que l'implémentation utilisera
  • Contraintes — dépendances existantes, limites de performance, exigences de licence

Pourquoi : cela externalise la requête de recherche afin que l'utilisateur puisse rediriger avant que vous dépensiez des efforts, et cela laisse une trace vérifiable. Un appel de sous-agent dont les args portent le besoin ne satisfait pas cette étape — l'utilisateur lit le texte du chat, pas les arguments des outils. Émettez l'articulation d'abord en texte, puis appelez des outils dont les arguments peuvent le refléter.

Étape 1 — Rechercher par priorité de source

Vérifiez ces sources dans l'ordre ; arrêtez-vous tôt lorsque vous trouvez une correspondance solide :

  1. Ce dépôt — rg / grep dans les modules et tests pertinents. La chose existe peut-être déjà ici.
  2. Registres de paquets — npm / PyPI / crates / modules Go pour le langage utilisé.
  3. Serveurs MCP — d'abord ceux déjà configurés, puis le registre. La capacité est peut-être déjà câblée.
  4. Compétences / agents / outils installés — votre harnais peut déjà la contenir.
  5. OSS maintenu / modèles — recherchez sur GitHub avant d'écrire du code neuf.

Interrogez la documentation en direct au moment de la décision (par ex. context7, ou le registre lui-même) plutôt que de vous fier à des informations mémorisées sur des paquets — les recommandations vieillissent.

Étape 2 — Décider et enregistrer un Verdict

Évaluez les candidats holistiquement : adéquation fonctionnelle, maintenance (dernier commit, réactivité aux problèmes), communauté, documentation, licence, empreinte des dépendances. Décrivez les forces et faiblesses en prose. N'attribuez pas de scores numériques (8/10), de notes alphabétiques ou de tableaux de points pondérés — ils fabriquent une fausse précision ; un verdict fondé sur des preuves est le résultat honnête.

VerdictQuandAction
AdopterCorrespondance exacte, bien maintenu, licence permissiveInstaller et utiliser directement
ÉtendreBonne base, adéquation partielleInstaller + fine couche / configuration
ComposerPlusieurs correspondances faiblesCombiner 2–3 petits paquets
ConstruireRien de convenableÉcrire du sur-mesure — mais éclairé par ce qui a été trouvé

Terminez chaque passe par une ligne de verdict reconnaissable — cette ligne est le livrable :

Verdict: <Adopter|Étendre|Composer|Construire> — <paquet(s) ou "sur-mesure"> — <raison fondée sur des preuves>

Une recherche sans ligne de verdict est une passe incomplète : vous avez fait le travail mais n'avez laissé aucune décision sur laquelle l'utilisateur (ou l'étape suivante) peut agir — c'est l'échec le plus courant de ce flux. Appuyez la raison sur des preuves (étoiles, date du dernier commit, correspondance de fonctionnalité spécifique), jamais sur des adjectifs ("a l'air bien", "populaire").

Mode Rapide vs Mode Complet

  • Mode Rapide (en ligne) — pour un besoin unique et évident : exécutez vous-même les étapes 0–2 avec quelques recherches et énoncez le verdict.
  • Mode Complet (délégué) — pour des besoins non triviaux : après l'étape 0, confiez la revue à un sous-agent de recherche (selon ce que fournit votre harnais pour la découverte de solutions). Reproduisez l'articulation dans son invite et demandez-lui de renvoyer les candidats ainsi qu'un verdict au format ci-dessus. Réservez les recherches multi-sources lourdes pour les questions vraiment difficiles — trouver une bibliothèque est plus léger qu'un rapport de recherche.

Quand l'utilisateur dit « saute la recherche »

Si l'utilisateur vous demande de sauter la recherche (« implémente juste », « pas le temps », « utilise n'importe quoi »), enregistrez quand même la décision sous forme de ligne de verdict avant d'implémenter — sauter la recherche est lui-même une décision, donc il reçoit un verdict comme toute autre passe (cela garde le choix vérifiable et la fenêtre de correction ouverte) :

Je saute la recherche à votre demande — je n'ai pas vérifié s'il existe une bibliothèque existante pour X. Verdict: <Adopter|Construire> — <choix provisoire ou "sur-mesure"> — choisi sans recherche à votre demande ; dites le mot pour une analyse de 60 secondes.

Pourquoi : l'utilisateur peut ignorer qu'une solution existe déjà ; un saut silencieux leur enlève la possibilité de corriger le cap. Après la ligne de verdict, procédez sans chercher — ne l'utilisez pas comme une porte dérobée pour faire une recherche complète quand même.

Anti-patrons

  • Sauter au code — écrire un utilitaire sans vérifier s'il en existe un.
  • Ignorer la capacité MCP / installée — reconstruire ce qui est déjà câblé.
  • Sur-personnaliser — envelopper une bibliothèque si lourdement que son bénéfice est perdu.
  • Gonflement des dépendances — installer un paquet volumineux pour une petite fonctionnalité.
  • Recherche sans verdict — faire le travail mais ne jamais enregistrer de décision.

Exemples (illustratifs — vérifiez les paquets en direct)

Ces exemples montrent à quoi ressemble un verdict ; ce ne sont pas des recommandations de paquets actuelles. Re-cherchez avant de vous fier à un paquet spécifique.

  • Vérification de liens morts → une règle de vérification de liens maintenue, sous licence permissive, couvrant tous les types de liens → Verdict: Adopter — textlint-rule-no-dead-link — maintenance active, MIT, couverture complète
  • Publication croisée Qiita → seuls des wrappers partiels non maintenus existent → Verdict: Construire — sur-mesure — aucune solution complète maintenue ; réutiliser l'API de la plateforme via un client HTTP
  • Cohérence terminologique JP → un vérificateur basé sur un dictionnaire nécessitant une configuration de projet → Verdict: Étendre — textlint-rule-prh — installer + un dictionnaire de projet

Skills associés