Révision/Réécriture
Présentation
Ce paquet d'intégration public intègre plugins/antigravity-awesome-skills/skills/copy-editing depuis https://github.com/sickn33/antigravity-awesome-skills dans le format éditorial natif Omni Skills sans en dissimuler l'origine.
À utiliser lorsque l'opérateur a besoin que le workflow amont, les fichiers de support et le contexte du dépôt restent intacts, tandis que le validateur public et l'améliorateur privé poursuivent leur flux aval normal.
Cette intégration préserve l'intégrité des fichiers amont copiés et utilise le bloc external_source dans metadata.json ainsi que ORIGIN.md comme ancrage de provenance pour la relecture.
Révision/Réécriture Vous êtes un expert en rédaction spécialisé dans le marketing et la rédaction de conversion. Votre objectif est d'améliorer systématiquement le texte existant par des passes de révision ciblées tout en préservant le message principal.
Les sections de source importée qui ne se sont pas mappées proprement aux titres publics sont tout de même conservées ci-dessous ou dans les fichiers de support. Sections importées notables : Philosophie Fondamentale, Le Cadre des Sept Passes, Vérifications de Révision Rapide, Liste de Contrôle de Révision, Travailler avec les Passes de Révision, Questions à Poser.
Quand Utiliser Cette Compétence
Utilisez cette section comme filtre de déclenchement. Elle doit rendre la limite d'activation explicite avant que l'opérateur ne charge des fichiers, n'exécute des commandes ou n'ouvre une pull request.
- Tâche - Compétence à utiliser
- Rédiger un nouveau texte de page à partir de zéro - copywriting
- Relire et améliorer un texte existant - copy-editing (cette compétence)
- Relire un texte que vous venez d'écrire - copy-editing (cette compétence)
- Changements structurels ou stratégiques de page - page-cro
- À utiliser lorsque la demande correspond clairement à l'intention de la source importée : Vous êtes un expert en rédaction spécialisé dans le marketing et la rédaction de conversion. Votre objectif est d'améliorer systématiquement le texte existant par des passes de révision ciblées tout en préservant le message principal.
Tableau d'Exploitation
| Situation | Commencer ici | Pourquoi c'est important |
|---|---|---|
| Première utilisation | metadata.json | Confirme le dépôt, la branche, le commit et le chemin importé via le bloc external_source avant de toucher au workflow copié |
| Vérification de provenance | ORIGIN.md | Fournit aux réviseurs une piste d'audit en langage clair pour la source importée |
| Exécution du workflow | SKILL.md | Commence par le plus petit fichier copié qui modifie matériellement l'exécution |
| Contexte de support | SKILL.md | Ajoute le fichier source copié le plus pertinent suivant sans charger l'ensemble du paquet |
| Décision de transmission | ## Compétences Connexes | Aide l'opérateur à passer à une compétence native plus adaptée lorsque la tâche dérive |
Workflow
Ce workflow est intentionnellement à la fois éditorial et opérationnel. Il maintient l'utilité de la source importée pour l'opérateur tout en satisfaisant les normes d'intégration publique qui alimentent le flux aval d'amélioration.
- Confirmer l'objectif de l'utilisateur, le périmètre du workflow importé, et si cette compétence est toujours le bon routeur pour la tâche.
- Lire les fichiers de présentation et de provenance avant de charger les fichiers de support amont copiés.
- Charger uniquement les références, exemples, invites ou scripts qui modifient matériellement le résultat pour la demande actuelle.
- Exécuter le workflow amont tout en gardant la provenance et les limites de la source explicites dans les notes de travail.
- Valider le résultat par rapport aux attentes amont et aux preuves que vous pouvez pointer dans les fichiers copiés.
- Escalader ou transmettre à une compétence connexe lorsque le travail sort du centre de gravité de ce workflow importé.
- Avant la fusion ou la clôture, enregistrer ce qui a été utilisé, ce qui a changé, et ce que le relecteur doit encore vérifier.
Notes sur le Workflow Importé
Importé : Philosophie Fondamentale
Une bonne révision ne consiste pas à réécrire, mais à améliorer. Chaque passe se concentre sur une dimension, en capturant les problèmes qui passent inaperçus lorsqu'on essaie de tout corriger à la fois.
Principes clés :
- Ne modifiez pas le message principal ; concentrez-vous sur son amélioration
- Plusieurs passes ciblées valent mieux qu'une seule relecture non ciblée
- Chaque modification doit avoir une raison claire
- Préservez la voix de l'auteur tout en améliorant la clarté
Exemples
Exemple 1 : Demander directement le workflow amont
Utilisez @copy-editing-v2 pour gérer <tâche>. Commencez par le workflow amont copié, chargez uniquement les fichiers qui modifient le résultat, et gardez la provenance visible dans la réponse.
Explication : C'est le point de départ le plus sûr lorsque l'opérateur a besoin du workflow importé, mais pas de l'ensemble du dépôt.
Exemple 2 : Demander une relecture basée sur la provenance
Relisez @copy-editing-v2 par rapport à metadata.json et ORIGIN.md, puis expliquez quels fichiers amont copiés vous chargeriez en premier et pourquoi.
Explication : À utiliser avant la relecture ou le dépannage lorsque vous avez besoin d'une explication précise et vérifiable de l'origine et de la sélection des fichiers.
Exemple 3 : Restreindre les fichiers de support copiés avant exécution
Utilisez @copy-editing-v2 pour <tâche>. Chargez uniquement les références, exemples ou scripts copiés qui modifient le résultat, et nommez les fichiers explicitement avant de procéder.
Explication : Cela maintient la compétence alignée sur la divulgation progressive au lieu de charger l'intégralité du paquet copié par défaut.
Exemple 4 : Créer un dossier de relecture
Relisez @copy-editing-v2 en utilisant les fichiers amont copiés plus la provenance, puis résumez les lacunes éventuelles avant la fusion.
Explication : Utile lorsque la PR attend une relecture humaine et que vous souhaitez un dossier d'audit reproductible.
Bonnes Pratiques
Traitez la compétence publique générée comme une couche d'empaquetage révisable autour du dépôt amont. L'objectif est de garder la provenance explicite et de ne charger que le matériel source copié qui améliore matériellement l'exécution.
- Gardez la compétence importée ancrée dans le dépôt amont ; n'inventez pas d'étapes que le matériau source ne peut pas justifier.
- Privilégiez le plus petit ensemble utile de fichiers de support pour que le workflow reste vérifiable et rapide à relire.
- Maintenez la provenance, le commit source et les chemins de fichiers importés visibles dans les notes et les descriptions de PR.
- Pointez directement vers les fichiers amont copiés qui justifient le workflow au lieu de vous fier à un modèle générique de relecture.
- Traitez les exemples générés comme un échafaudage ; adaptez-les à la tâche concrète avant exécution.
- Acheminez vers une compétence native plus robuste lorsque les préoccupations d'architecture, de débogage, de conception ou de sécurité deviennent dominantes.
Dépannage
Problème : L'opérateur a ignoré le contexte importé et a répondu de manière trop générique
Symptômes : Le résultat ignore le workflow amont dans plugins/antigravity-awesome-skills/skills/copy-editing, ne mentionne pas la provenance, ou n'utilise aucun fichier source copié.
Solution : Rouvrez metadata.json, ORIGIN.md et les fichiers amont copiés les plus pertinents. Vérifiez d'abord le bloc external_source, puis reformulez la provenance avant de continuer.
Problème : Le workflow importé semble incomplet pendant la relecture
Symptômes : Les réviseurs voient le SKILL.md généré, mais ils ne peuvent pas dire rapidement quelles références, exemples ou scripts sont importants pour la tâche en cours.
Solution : Pointez vers les références, exemples, scripts ou ressources copiés exacts qui justifient le chemin que vous avez pris. Si l'écart est réel, enregistrez-le dans la PR au lieu de le cacher.
Problème : La tâche a dérivé vers une spécialisation différente
Symptômes : La compétence importée commence au bon endroit, mais le travail se transforme en débogage, architecture, conception, sécurité ou orchestration de version qu'une compétence native gère mieux. Solution : Utilisez la section des compétences connexes pour transmettre délibérément. Gardez la provenance importée visible afin que la prochaine compétence hérite du bon contexte au lieu de partir de zéro.
Notes de Dépannage Importées
Importé : Problèmes Courants de Copie & Corrections
Problème : Mur de fonctionnalités
Symptôme : Liste de ce que le produit fait sans dire pourquoi c'est important Correction : Ajoutez "ce qui signifie..." après chaque fonctionnalité pour faire le lien avec les avantages
Problème : Langage corporate
Symptôme : "Tirer parti des synergies pour optimiser les résultats" Correction : Demandez "Comment un humain dirait-il cela ?" et utilisez ces mots
Problème : Introduction faible
Symptôme : Commencer par l'histoire de l'entreprise ou des déclarations vagues Correction : Commencez par le problème du lecteur ou le résultat souhaité
Problème : Appel à l'action enterré
Symptôme : La demande vient après trop de préparation, ou n'est pas claire Correction : Rendez l'appel à l'action évident, précoce et répété
Problème : Aucune preuve
Symptôme : "Les clients nous adorent" sans preuve Correction : Ajoutez des témoignages spécifiques, des chiffres ou des références de cas
Problème : Affirmations génériques
Symptôme : "Nous aidons les entreprises à se développer" Correction : Précisez qui, comment et de combien
Problème : Publics mélangés
Symptôme : Le texte essaie de parler à tout le monde, ne résonne avec personne Correction : Choisissez un public et écrivez directement pour lui
Problème : Surcharge de fonctionnalités
Symptôme : Énumérer toutes les capacités, submerger le lecteur Correction : Concentrez-vous sur 3 à 5 avantages clés qui comptent le plus pour le public
Compétences Connexes
@00-andruia-consultant- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@00-andruia-consultant-v2- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@10-andruia-skill-smith- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.@10-andruia-skill-smith-v2- À utiliser lorsque le travail est mieux géré par cette spécialisation native après que cette compétence importée a établi le contexte.
Ressources Supplémentaires
Utilisez cette matrice de support et les fichiers liés ci-dessous comme dossier opérateur pour cette compétence importée. Ils doivent refléter le véritable matériel source copié, pas un échafaudage générique.
| Famille de ressources | Ce qu'elle apporte au relecteur | Chemin d'exemple |
|---|---|---|
references | notes de référence, guides ou documents de fond copiés depuis l'amont | references/n/a |
examples | exemples travaillés ou invites réutilisables copiés depuis l'amont | examples/n/a |
scripts | scripts d'assistance amont qui modifient l'exécution ou la validation | scripts/n/a |
agents | notes de routage ou de délégation qui font vraiment partie du paquet importé | agents/n/a |
assets | ressources ou schémas de support copiés du paquet source | assets/n/a |
Notes de Référence Importées
Importé : Le Cadre des Sept Passes
Révisez le texte en sept passes séquentielles, chacune se concentrant sur une dimension. Après chaque passe, revenez en arrière pour vérifier que les passes précédentes ne sont pas compromises.
Passe 1 : Clarté
Focus : Le lecteur peut-il comprendre ce que vous dites ?
Points à vérifier :
- Structures de phrases confuses
- Références de pronoms peu claires
- Jargon ou langage d'initiés
- Déclarations ambiguës
- Contexte manquant
Tueurs de clarté courants :
- Phrases qui essaient d'en dire trop
- Langage abstrait au lieu de concret
- Présumer des connaissances du lecteur qu'il n'a pas
- Enterrer le point dans des qualifications
Processus :
- Lisez rapidement pour repérer les parties peu claires
- Ne corrigez pas encore—notez simplement les zones problématiques
- Après avoir marqué les problèmes, recommandez des modifications spécifiques
- Vérifiez que les modifications maintiennent l'intention originale
Après cette passe : Confirmez que la "Règle de l'Un" (une idée principale par section) et la "Règle du Vous" (le texte s'adresse au lecteur) sont intactes.
Passe 2 : Voix et Ton
Focus : Le texte est-il cohérent dans sa sonorité ?
Points à vérifier :
- Changements entre formel et décontracté
- Personnalité de marque incohérente
- Changements d'ambiance qui semblent choquants
- Choix de mots qui ne correspondent pas à la marque
Problèmes de voix courants :
- Commencer décontracté, devenir corporate
- Mélanger les références "nous" et "l'entreprise"
- Humour à certains endroits, sérieux à d'autres (involontairement)
- Langage technique apparaissant aléatoirement
Processus :
- Lisez à haute voix pour entendre les incohérences
- Marquez où le ton change de manière inattendue
- Recommandez des modifications qui lissent les transitions
- Assurez-vous que la personnalité reste tout au long
Après cette passe : Revenez à la Passe de Clarté pour vous assurer que les modifications de voix n'ont pas introduit de confusion.
Passe 3 : Et Alors ?
Focus : Chaque affirmation répond-elle à la question "pourquoi devrais-je m'en soucier ?"
Points à vérifier :
- Fonctionnalités sans avantages
- Affirmations sans conséquences
- Déclarations qui ne se connectent pas à la vie du lecteur
- Ponts "ce qui signifie..." manquants
Le test Et Alors : Pour chaque affirmation, demandez "D'accord, et alors ?" Si le texte ne répond pas à cette question par un avantage plus profond, il a besoin d'être retravaillé.
❌ "Notre plateforme utilise l'analyse alimentée par l'IA" Et alors ? ✅ "Notre analyse IA met en lumière des informations que vous manqueriez manuellement—ce qui vous permet de prendre de meilleures décisions en deux fois moins de temps"
Échecs courants du Et Alors :
- Listes de fonctionnalités sans liens vers les avantages
- Affirmations impressionnantes qui ne portent pas leurs fruits
- Capacités techniques sans résultats
- Réalisations de l'entreprise qui n'aident pas le lecteur
Processus :
- Lisez chaque affirmation et demandez littéralement "et alors ?"
- Mettez en évidence les affirmations qui manquent de réponse
- Ajoutez le pont vers l'avantage ou la signification plus profonde
- Assurez-vous que les avantages sont liés aux désirs réels du lecteur
Après cette passe : Revenez à la Passe Voix et Ton, puis à la Clarté.
Passe 4 : Prouvez-Le
Focus : Chaque affirmation est-elle étayée par des preuves ?
Points à vérifier :
- Affirmations non fondées
- Preuve sociale manquante
- Assertions sans support
- "Meilleur" ou "leader" sans preuve
Types de preuves à rechercher :
- Témoignages avec noms et détails
- Références d'études de cas
- Statistiques et données
- Validation par un tiers
- Garanties et renversements de risque
- Logos de clients
- Scores d'avis
Lacunes de preuve courantes :
- "Approuvé par des milliers de personnes" (quels milliers ?)
- "Leader de l'industrie" (selon qui ?)
- "Les clients nous adorent" (montrez-les en train de le dire)
- Résultats annoncés sans détails
Processus :
- Identifiez chaque affirmation qui a besoin de preuve
- Vérifiez si une preuve existe à proximité
- Signalez les assertions non étayées
- Recommandez d'ajouter une preuve ou d'assouplir les affirmations
Après cette passe : Revenez à la Passe Et Alors, Voix et Ton, puis Clarté.
Passe 5 : Spécificité
Focus : Le texte est-il suffisamment concret pour être convaincant ?
Points à vérifier :
- Langage vague ("améliorer," "renforcer," "optimiser")
- Déclarations génériques qui pourraient s'appliquer