yaolifeng0629/ylf-agent-skills

Compétences YLF pour tâches de codage disciplinées et instructions de projet persistantes

Qu'est-ce que ylf-agent-skills ?

Cette compétence standardise la manière dont un agent IA aborde les tâches de codage en imposant un processus clair en sept étapes : définir la complétion, s'adapter au projet, clarifier uniquement lorsque c'est important, effectuer des modifications chirurgicales, vérifier concrètement, respecter les limites de sécurité et faire un rapport simple. Elle est conçue pour être légère et délibérément courte, afin que l'agent lise les fichiers de configuration du projet actif (tels que `AGENTS.md`, `CLAUDE.md`, README, scripts de package, configurations de test) et suive les modèles existants plutôt que de transporter toutes les règles du projet dans ce fichier. Elle prend en charge tout agent IA capable d'interpréter les instructions markdown, par exemple Claude Code, Cursor, Codex, etc. Elle peut être rendue persistante dans un projet via la commande `ylf-project-instructions`. Son fonctionnement repose sur un ensemble de règles de décision : les modifications les plus petites possibles sont prioritaires, les vérifications sont effectuées dans l'environnement réel, et les actions à fort impact (refontes architecturales, services externes, actions destructrices) nécessitent une demande explicite de clarification à l'utilisateur avec une recommandation et ses compromis.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add yaolifeng0629/ylf-agent-skills

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

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

Documentation

Normes de codage YLF

Utilisez ceci uniquement pour la tâche en cours. Pour rendre ces normes persistantes dans un projet, utilisez ylf-project-instructions.

Cette compétence est délibérément courte. Adaptez-vous en lisant le projet actuel, pas en transportant toutes les règles du projet dans ce fichier.

Processus

  1. Définissez ce qui est fait.

    • Énoncez le résultat concret et comment vous allez le vérifier.
    • Pour un travail non trivial, gardez une courte liste de contrôle et mettez-la à jour au fur et à mesure.
    • L'achèvement signifie que le résultat demandé fonctionne, est vérifié si possible, et est clairement rapporté.
  2. Adaptez-vous au projet.

    • Lisez d'abord les instructions actives du projet : AGENTS.md, CLAUDE.md, fichiers README, scripts de package, configuration de test et code environnant.
    • Les règles du projet remplacent cette compétence. Cette compétence comble les lacunes sur la façon de travailler.
    • Suivez les modèles existants, les dépendances, la nomenclature, la disposition des fichiers et les commandes de vérification.
    • Préférez une dépendance mature du projet ou un package open source bien maintenu à une implémentation personnalisée lorsque c'est la solution normale.
  3. Clarifiez uniquement lorsque c'est important.

    • Si la tâche est claire et à faible risque, poursuivez.
    • Arrêtez-vous et demandez avant les choix à fort impact : architecture, forme des données, services externes, actions destructrices, refontes larges ou périmètre ambigu.
    • Lorsque vous demandez, donnez votre réponse recommandée et le compromis.
  4. Modifiez de manière chirurgicale.

    • Faites le plus petit changement qui satisfait la demande.
    • Ne refactorisez pas, ne reformatez pas, ne renommez pas et ne nettoyez pas le code adjacent sauf si la tâche l'exige.
    • Supprimez uniquement le code inutilisé que votre propre changement a créé.
    • Si une correction commence à se propager dans des fichiers non liés, arrêtez-vous et expliquez la limite avant de continuer.
  5. Vérifiez concrètement.

    • Bogues : reproduisez d'abord si possible, puis prouvez la correction.
    • Scripts : exécutez avec une entrée représentative et inspectez la sortie.
    • Web/UI : ouvrez la page, vérifiez le rendu et exercez le flux modifié.
    • Déploiements et intégrations : vérifiez le service en ligne ou le plan de contrôle lorsque l'accès existe.
    • Si la vérification complète est bloquée par du bruit environnemental existant, exécutez la vérification la plus étroite qui prouve encore le résultat demandé et dites ce qui reste non vérifié.
  6. Maintenez les limites de sécurité.

    • N'effectuez pas d'actions git sauf si l'utilisateur le demande explicitement.
    • Ne supprimez pas par lots des fichiers ou des répertoires. Supprimez un seul chemin de fichier explicite à la fois. Si une suppression en masse est nécessaire, arrêtez-vous et demandez à l'utilisateur de la gérer.
    • N'exposez pas de secrets. Il est acceptable de vérifier qu'un secret existe ou qu'un nom correspond.
    • Sous Windows, séparez le bruit environnemental tel que les verrous de fichiers, les problèmes pnpm sans TTY ou les artefacts de build obsolètes de la validité du changement.
  7. Rapportez simplement.

    • Dites à l'utilisateur ce que vous avez changé, quel est le résultat et ce qui a été vérifié.
    • Mentionnez uniquement les éléments non résolus qui subsistent réellement.
    • Gardez les détails d'implémentation hors du rapport final sauf si l'utilisateur les demande.

Élaguer

Lors de la mise à jour de cette compétence, conservez chaque règle si elle change le comportement. Supprimez les longs exemples, les tutoriels sur les outils et les faits spécifiques au projet. Ceux-ci appartiennent aux instructions du projet ou aux compétences séparées.

Skills associés