agent-sort

Vue d’ensemble de la compétence agent-sort

agent-sort est une compétence de planification orientée dépôt, conçue pour transformer une configuration ECC trop large en une surface d’installation plus réduite et fondée sur des preuves. Elle vous aide à décider ce qui doit être chargé au quotidien et ce qui doit rester simplement consultable dans une bibliothèque, afin d’éviter de surinstaller des compétences, règles, hooks ou scripts que le projet n’utilisera pas.

Cette compétence convient particulièrement aux mainteneurs, aux responsables des workflows d’agent et à toute personne qui réalise un travail de agent-sort install sur un dépôt existant. Le véritable objectif n’est pas de « ranger des fichiers », mais de produire un plan d’installation défendable à partir de la base de code réelle, avec moins d’hypothèses et moins de bruit ECC.

À quoi sert agent-sort

Utilisez la compétence agent-sort lorsque vous devez classer des éléments ECC propres au dépôt dans des catégories réellement exploitables, en particulier dans un projet aux workflows mixtes ou à l’adoption ECC partielle. Elle est utile si vous voulez garder une surface chargée au quotidien compacte, tout en conservant des éléments de référence pour consultation ultérieure.

Ce qui distingue agent-sort

La compétence agent-sort est pilotée par les preuves : c’est le contenu du dépôt qui détermine le plan d’installation, et non les préférences personnelles. Sa principale valeur est de réduire les installations accidentelles et de faire ressortir ce que le projet utilise réellement, ce qui en fait un outil plus orienté décision qu’un prompt générique.

Cas où agent-sort est adapté — et cas où il l’est moins

Elle est adaptée aux dépôts où ECC est présent mais trop large, trop répétitif, ou en train de dériver du workflow réel du projet. Elle l’est moins si vous cherchez un prompt ponctuel et rapide pour résumer un dépôt, ou si le projet n’utilise pas du tout de surfaces natives ECC.

Comment utiliser la compétence agent-sort

Installation et mise en place du contexte

Commencez par le flux agent-sort install dans le dépôt cible, puis lisez skills/agent-sort/SKILL.md, qui sert de guide opératoire. La compétence est pensée pour travailler à partir des preuves présentes dans le dépôt : installez-la donc aux côtés du dépôt que vous évaluez, et non de manière isolée.

Les entrées qui améliorent la qualité du résultat

Fournissez à la compétence un dépôt cible précis, un périmètre clair et la frontière de décision qui vous intéresse. Une bonne consigne ressemble à ceci : « Sort this repo’s ECC surfaces into DAILY vs LIBRARY for the current app, preserving only what is needed for routine agent runs. » Une mauvaise consigne reste vague, par exemple : « organize the project » ou « make it cleaner. »

Workflow recommandé

Commencez par vérifier le README du dépôt, les instructions de type AGENTS, ainsi que les dossiers ou fichiers manifeste liés à ECC. Ensuite, utilisez agent-sort usage pour relier des preuves concrètes aux candidats à charger au quotidien, aux références à conserver en bibliothèque uniquement, et à tout ce qui ne devrait pas être installé du tout. L’objectif est d’obtenir un plan d’installation concis avec une étape de vérification, pas une réarchitecture spéculative.

Fichiers à lire en premier

Commencez par SKILL.md, puis examinez l’arborescence du dépôt pour repérer README.md, AGENTS.md, metadata.json, ainsi que d’éventuels dossiers rules/, resources/, references/ ou scripts/. Dans ce dépôt, SKILL.md est la source principale, car il n’existe pas de fichiers de support à recouper.

FAQ sur la compétence agent-sort

agent-sort est-il réservé aux projets ECC ?

Oui, agent-sort est conçu autour des surfaces natives ECC et des décisions d’installation. Si votre dépôt ne suit pas ce modèle, un prompting classique sera généralement plus simple et plus approprié que la compétence agent-sort.

En quoi est-ce différent d’un prompt classique ?

Un prompt classique peut produire une recommandation rapide, mais agent-sort pousse vers une classification appuyée sur des preuves et un véritable plan d’installation. C’est important lorsque vous avez besoin d’un usage répétable de agent-sort usage à l’échelle d’un dépôt, plutôt que d’un avis ponctuel.

agent-sort est-il accessible aux débutants ?

Oui, à condition de pouvoir identifier clairement le dépôt à évaluer et d’accepter de parcourir d’abord l’arborescence source. La principale exigence n’est pas une expertise ECC poussée ; c’est de savoir ce qui doit être installé chaque jour et ce qui doit plutôt rester du matériel de bibliothèque.

Quand ne faut-il pas utiliser agent-sort ?

Ne l’utilisez pas si vous avez seulement besoin d’un résumé générique du dépôt, si le projet ne comporte aucune surface ECC à trier, ou si vous cherchez une refonte large plutôt qu’une décision d’installation. Dans ces cas-là, le surcoût de agent-sort for Skill Authoring n’est pas justifié.

Comment améliorer la compétence agent-sort

Fournissez des preuves dépôt plus précises

Les meilleurs résultats avec agent-sort viennent de signaux concrets du dépôt : chemins de fichiers, noms de workflows actuels et exemples de ce que l’agent manipule réellement. Si vous pouvez pointer vers des commandes, dossiers ou fichiers de règles spécifiques, la séparation daily/library sera plus précise.

Définissez clairement la frontière d’installation

Précisez si vous triez pour l’ensemble du dépôt, pour un sous-package ou pour un workflow étroitement délimité. Un périmètre précis évite que la compétence ne classe à tort du matériel de référence dans la charge quotidienne, ce qui est un mode d’échec fréquent lors d’un travail de agent-sort install.

Relisez le premier passage pour détecter une surcharge

Si le résultat vous paraît trop lourd, demandez quels éléments sont réellement nécessaires à chaque exécution et lesquels ne servent qu’à la consultation. L’itération la plus utile consiste à réduire les installations quotidiennes jusqu’à ce que le plan reflète l’usage courant, et non une utilité théorique.

Préservez le matériel de bibliothèque utile

Un bon agent-sort guide ne supprime pas tout ce qui n’est pas quotidien. Conservez en bibliothèque les éléments à la frontière si ceux-ci soutiennent des décisions ultérieures, car la compétence vise à réduire la charge par défaut, pas à effacer la connaissance du projet.