Camgineer/skills

Simple comme de la prose

Écrivez de façon à ce que le lecteur comprenne le message du premier coup et sache quoi faire ensuite. Lors de la révision, conservez le sens, les faits, les termes requis, le ton et les contraintes.

Définir la tâche

Avant de rédiger, déterminez qui est le lecteur, ce qu'il sait déjà, le résultat souhaité et son action suivante. Ne posez une question que si la réponse manquante changerait le résultat.

Écrire le point principal en premier

• Commencez par le résultat, la décision, le risque ou la demande.
• Donnez une seule idée par phrase. Scindez toute phrase qui oblige le lecteur à revenir en arrière.
• Utilisez la voix active, le présent, des noms concrets et des verbes forts.
• Utilisez le mot familier le plus court qui conserve le sens. Gardez les termes techniques nécessaires et expliquez-les si le lecteur risque de ne pas les connaître.
• Donnez un seul nom à chaque concept et répétez-le.
• Appuyez les affirmations avec des faits, des exemples, des chiffres, des noms ou des critères observables. Identifiez une déduction ou une supposition comme telle.
• Nommez le responsable, l'action, le délai, le blocage et la preuve lorsqu'ils affectent la suite.
• Conservez la chaleur, l'humour et l'opinion lorsqu'ils aident le message.

Adapter la forme à la tâche

• Montrez la structure au lieu de la décrire. Utilisez un tableau pour comparer des options et un diagramme Mermaid pour un flux, une architecture ou un état avant/après. Utilisez la prose pour le raisonnement entre les deux.
• Gardez les discussions et les mises à jour de statut courtes, avec le résultat avant le processus.
• Rédigez les demandes de façon à ce que le lecteur puisse agir sans avoir à deviner.
• Rédigez les procédures sous forme de commandes directes. Placez la condition avant l'instruction. Numérotez uniquement les séquences réelles.
• Gardez les références factuelles et complètes, sans persuasion.
• Expliquez un sujet par sa cause réelle, ses contraintes, ses compromis et ses conséquences.
• Donnez aux tutoriels un résultat visible tôt et dites au lecteur ce qu'il doit voir.
• Ne conservez un commentaire de code que pour une raison que le code ne peut pas montrer, comme une justification, une contrainte externe ou un compromis mesuré.

Expressions typiques de l'IA

Remplacez-les dès que vous les voyez. Pour les documents, les PR, les compétences et les réécritures, vérifiez également la liste complète dans ai-tells.md.

• Formules d'ouverture, de conclusion, éloges et résumés de fin. Commencez par le point et arrêtez-vous une fois qu'il est fait.
• Mots ampoulés. Écrivez « utiliser » pour « utiliser » ou « tirer parti », « aider » pour « faciliter », et « est » pour « sert de ».
• Mots d'IA génériques comme approfondir, crucial, central, favoriser, améliorer, paysage, tapisserie, témoignage, souligner et dynamique. Utilisez le mot concret.
• « Non seulement X, mais Y » et autres cadres de contraste. Énoncez le point.
• Groupes de trois forcés par le rythme. Utilisez le compte naturel.
• Phrases se terminant par « -ant » comme « assurant... » ou « soulignant... ». Nommez l'acteur et l'action, ou supprimez la phrase.
• Flèches, articles omis et fragments sans verbe. Écrivez des phrases complètes.
• Préambules comme « Voilà le truc », dictons comme « au cœur du sujet » et phrases de clôture d'une ligne qui reformulent le point. Énoncez l'affirmation et arrêtez-vous.

Ponctuation

• Séparez les idées par des points et des virgules. Là où un tiret pourrait aller, commencez une nouvelle phrase. Les caractères tiret long et tiret court n'apparaissent jamais.
• Utilisez les deux-points uniquement avant une liste ou un exemple.
• Utilisez des guillemets droits, des titres en casse de phrase et aucun emoji décoratif.
• Utilisez le gras, les titres et les listes uniquement lorsqu'ils rendent le texte plus facile à parcourir.

Relecture

1. Vérifiez que la première phrase oriente le lecteur.
2. Supprimez chaque mot et chaque phrase qui n'ajoutent ni sens, ni preuve, ni ton nécessaire, ni contexte.
3. Corrigez les pronoms, modificateurs, conditions et regroupements de listes peu clairs.
4. Remplacez chaque expression typique de l'IA. Utilisez ai-tells.md pour les documents, les PR, les compétences et les réécritures.
5. Recherchez les caractères tiret long et tiret court et remplacez chacun d'eux.
6. Lors de la révision, comparez le résultat avec l'original. Il n'ajoute aucun fait, nom, nombre, date, citation ou affirmation que l'original ne possède pas, et n'en supprime aucun qui s'applique encore. Chaque affirmation conserve sa certitude. Un « a échoué » plus court pour « peut avoir échoué » est une nouvelle affirmation, conservez donc la nuance. Lorsqu'une phrase a besoin d'un détail que vous ne possédez pas, demandez-le ou écrivez une phrase plus simple.
7. Lisez une fois à vitesse normale. Révisez tout ce qui sonne comme un script, est rigide ou vague.

Signaler le travail

• Nommez ce qui change pour le consommateur avant les détails d'implémentation, puis ce que le prochain mainteneur hérite.
• Conservez les détails nécessaires, les compromis, les choix et les décisions ouvertes, même dans une réponse courte.
• Liez uniquement les artefacts que vous avez produits ou lus dans cette session. Ne fabriquez jamais de citation ou de référence de transcription.
• Conservez la preuve de chaque affirmation ou étiquetez-la avec celle-ci. Distinguez les affirmations mesurées, déduites, relayées et supposées. Un nombre provenant d'un autre agent reste relayé jusqu'à ce que sa mesure soit vérifiée. Indiquez ce que chaque nombre compte.
• Signalez les résultats par résultat : corrigé, atténué, différé ou rejeté. Un résultat partiellement non résolu est différé ; un résultat clos uniquement par un avertissement ou une prose est atténué. N'appelez pas un ensemble mixte « tout corrigé ».

Retourner le bon artefact

• Pour une réécriture, retournez le texte amélioré. N'expliquez les modifications que si cela aide.
• Pour une critique, nommez les principaux problèmes, donnez la révision et listez les règles qui ont le plus compté.
• Pour un brouillon, déduisez le lecteur et le résultat, et écrivez la version la plus courte et complète.
• En conversation, répondez directement et laissez ce processus non mentionné.

Terminé quand

• Le lecteur comprend le message du premier coup.
• L'action suivante est explicite lorsqu'il y en a une.
• Chaque affirmation est sourcée, mesurée ou étiquetée comme une déduction ou une supposition.
• Chaque phrase mérite sa place.
• Le texte donne l'impression qu'une personne compétente l'a écrit pour ce lecteur.
• Aucun caractère tiret long ou tiret court ne subsiste.