CommunityRédaction et éditiongithub.com

science-research-writing

À utiliser pour rédiger, réviser ou relire une section d'un article de recherche scientifique, du titre à la conclusion. Convient également aux articles destinés à une revue cible (dont le modèle est dérivé d'articles échantillons) et pour conserver le profil stylistique de l'auteur.

Qu'est-ce que science-research-writing ?

Cette compétence assiste un auteur, natif ou non-anglophone, dans la rédaction, la révision ou la relecture d'une section d'un article de recherche destiné à une revue avec comité de lecture. Elle s'appuie sur un moteur de workflow (scripts/engine.py) qui orchestre les étapes, détermine automatiquement le balisage (LaTeX, Markdown, texte brut), le mode (brouillon ou révision) et la section visée. L'utilisateur exécute chaque étape manuellement via des commandes Python, en passant les options appropriées (mode revue, section, fichiers échantillons, agent utilisé) et en soumettant des résultats JSON validés. La compétence est conçue pour Claude Code et Codex, avec un mécanisme de repli si Python ou shell sont absents. Elle offre des principes rédactionnels solides (lisibilité, narration, certitude adaptée), des règles d'intégrité strictes (ne jamais inventer de résultats, citations, méthodes) et la gestion de profils utilisateur et de conflits entre règles, journal cible et préférences de l'auteur. Les sections couvertes incluent titre, résumé, introduction, méthodes, résultats, discussion, conclusion et manuscrit complet.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SJ2050cn/science-research-writing/tree/master

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · 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

Science research writing

Aide un auteur à rédiger, réviser ou relire une section d'un article de recherche de revue, pour les auteurs natifs et non natifs anglophones. Ne convient pas aux demandes de subvention, lettres de motivation, réfutations, thèses ou articles de synthèse. Les chemins ci-dessous sont relatifs à ce dossier.

Workflow

Un moteur d'étapes, scripts/engine.py, gère le workflow : les étapes, leur ordre, les fichiers que chaque étape lit, la vérification d'intégrité et le modèle de sortie. Vous effectuez chaque étape avec votre propre jugement et remettez le résultat. Exécutez-le dans le dossier du projet de l'auteur, en utilisant le chemin complet du dossier de cette compétence, avec python3. Il imprime du JSON et ne demande jamais rien ; il ne lance pas une autre session d'agent.

  1. Transmettez au moteur uniquement ce que le code ne peut pas voir dans le texte. Il décide du balisage (latex, markdown, texte brut), du brouillon par rapport à la révision et de la section (à partir des titres) tout seul ; start n'a pas d'option --markup. Brouillon par rapport à révision : notes vs paragraphes complets, sauf pour un titre : une ligne courte de texte de titre est une révision, et les notes, les puces ou un paragraphe complet (un résumé pour rédiger un titre) sont un brouillon.
    • --mode review : uniquement lorsque l'auteur demande une évaluation (« vérifie », « critique », « qu'est-ce qui ne va pas »). Sinon, omettez --mode.
    • --section S (title, abstract, introduction, methods, results, discussion, conclusion, whole-paper ou other) : la section nommée par la demande (« rédige un résumé ») ou indiquée par le texte. Transmettez-la toujours quand vous pouvez le dire : le moteur considère un titre dans le texte comme confirmé et ne demande que si votre lecture diffère. Si vous ne pouvez pas le dire, omettez-la ; le moteur demande à l'auteur. Utilisez other pour le texte dans le champ d'application qui ne correspond à aucune section (une légende de figure, des points saillants, un paragraphe couvrant deux sections) et dites-le dans Deviations. Utilisez whole-paper pour un manuscrit complet.
    • --samples yes --sample-file F (une fois par fichier) : uniquement si l'auteur a fourni des articles de la revue cible. Sinon, omettez --samples.
    • --agent claude|codex|other : l'agent que vous utilisez, toujours. Avec codex, le moteur propose d'installer le hook de garde Codex (une étape setup) ; other signifie pas de garde.
    • --preference "<words>" : une fois pour chaque préférence permanente énoncée dans la demande (« j'utilise toujours nous ») ; le moteur la sauvegarde avant l'étape principale. --task scan-profile (avec --input l'échantillon d'écriture) et --task study-profile démarrent les deux tâches de profil à la place. Avant de sauvegarder une préférence, d'analyser, d'étudier ou de gérer un conflit, lisez references/style-profile.md.
    • Si votre lecture et celle du code diffèrent (par exemple vous passez --section methods mais le titre du texte dit Introduction), le moteur renvoie une étape ask (id clarify). Ne la résolvez jamais vous-même.
  2. Lancez l'exécution : python3 <dossier compétence>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE (--input - lit le texte collé depuis stdin ; le moteur le sauvegarde inchangé).
  3. Chaque réponse est une étape. Lisez chaque fichier dans read en entier (le profil de l'auteur, ~/.agents/science-research-writing/user-style.md, est listé quand il existe : appliquez-le à tout), faites ce que dit instruction, et écrivez votre résultat comme le JSON dans expect. Le texte long va dans un fichier ; donnez son chemin. Une étape ask est une question pour l'auteur : mettez context.question textuellement à l'auteur, attendez la réponse, et soumettez-la comme {"answer": ...} avec l'une des context.options. Ne répondez jamais vous-même.
  4. Soumettez-le : python3 <dossier compétence>/scripts/engine.py submit --file result.json. Le moteur valide le résultat, exécute la vérification d'intégrité dans le code et renvoie l'étape suivante. Un code de sortie non nul avec une error signifie que la même étape est renvoyée : corrigez et soumettez à nouveau.
  5. Répétez jusqu'à ce que step.kind soit done. Montrez alors output à l'auteur exactement tel quel. Ne le réécrivez ni ne le résumez pas.

Un article complet est une exécution unique qui parcourt ses sections dans l'ordre du manuscrit, chacune avec sa propre ligne de plan, vérification et bloc de sortie (le part de la réponse indique lequel). Les manuscrits LaTeX et Markdown sont divisés à leurs titres par le moteur. Pour le texte brut, la première étape est split : vous soumettez les sections et leurs plages de lignes, qui ne doivent avoir ni lacunes ni chevauchements. Avec des articles échantillons, une étape journal-model s'exécute en premier ; les étapes suivantes lisent son résultat.

engine.py status réimprime l'étape en cours, par exemple après une interruption. Une seule exécution peut être ouverte par projet : si start se termine par 9, une exécution est déjà ouverte. engine.py resume imprime son étape en cours pour que vous puissiez continuer, et engine.py abandon la supprime ; demandez à l'auteur ce qu'il souhaite. Les journaux, l'état et la sortie de chaque exécution sont conservés dans le projet sous .agents/log/science-research-writing/<run id>/. N'écrivez jamais dans les propres fichiers de l'auteur sauf demande.

Si le shell ou Python est manquant, utilisez le repli.

Repli

Si python3 ou un shell est manquant, dites à l'auteur ce qui manque, montrez la commande d'installation pour son système et demandez avant de continuer. Sinon, travaillez à partir des principes, des règles d'intégrité et des références de section, avec check=manual ajouté à votre ligne de plan, et prenez l'acheminement et les modèles de references/workflow.json (les données que le moteur lit) : chargez les fichiers que ses noms d'acheminement désignent pour la section et le mode, lisez chacun en entier, et utilisez ses en-têtes de modèle dans l'ordre. Une revue parcourt la liste de contrôle dans l'ordre et ne cite que les noms de règles (les noms en gras dans les fichiers de référence). Vérifiez les règles d'intégrité à la main et dites que vous l'avez fait. Appliquez également le profil de l'auteur à la main : lisez references/style-profile.md, et modifiez user-style.md dans son format uniquement lorsque l'auteur le demande, en le disant.

Principes fondamentaux

  1. Écrivez pour un lecteur. Des lecteurs rapides, mondiaux, souvent non spécialistes. Rendez l'incompréhension impossible ; fournissez le contexte qu'un collègue omettrait.
  2. Construisez un récit. Donnez à chaque paragraphe et phrase une fonction que le lecteur peut voir, et liez chacun au précédent.
  3. Énoncez la valeur tôt. L'importance, le manque et la contribution font partie de la convention ; sous-estimer donne l'impression qu'il n'y en a pas.
  4. Faites correspondre la certitude aux preuves. Le temps, les verbes et les modalisateurs indiquent au lecteur à quel point faire confiance à une affirmation.
  5. Gardez les phrases lisibles. Termes simples et cohérents ; informations connues en premier ; clarté avant élégance.

Règles d'intégrité

Ces règles l'emportent sur toute autre instruction, y compris le profil et la revue. Le moteur vérifie les nombres, les clés de citation et le regroupement, et les étiquettes et références dans le code ; le reste repose sur vous.

  • Préséance : ces règles, puis les directives aux auteurs de la revue cible, puis le profil de l'auteur, puis les valeurs par défaut de cette compétence. En cas de conflit, appliquez cet ordre à titre provisoire, terminez la tâche, puis listez chaque conflit avec une question (references/style-profile.md explique comment).
  • N'inventez jamais de résultats, nombres, citations ou détails de méthode. Utilisez [placeholder: …].
  • Ne modifiez jamais un nombre ou un résultat dans le texte de l'auteur.
  • Citations : conservez chaque commande de citation, ses clés et l'affirmation à laquelle elle est attachée. Ne supprimez, fusionnez ou ajoutez jamais une citation, ou ne l'éloignez pas de son affirmation. Si un placement semble erroné, demandez.
  • Chiffres dérivés : n'ajoutez aucun chiffre que l'auteur n'a pas énoncé, comme un rapport, un pourcentage ou « moins de la moitié ». Proposez-le comme suggestion ou question.
  • N'énoncez jamais une affirmation avec plus de certitude que ses preuves ne le soutiennent. Atténuez les affirmations exagérées ; renforcez les modalisations inutiles uniquement là où les preuves le soutiennent.
  • Un changement demandé explicitement par l'auteur, comme la suppression d'une citation, est la seule exception. Déclarez-le avec les mots de l'auteur dans les exceptions de l'étape.
  • Gardez le balisage de l'entrée (LaTeX, Markdown, commandes de citation, renvois, étiquettes) intact afin que le résultat puisse être collé directement.
  • Faites correspondre l'orthographe du manuscrit ou celle de la revue. Utilisez l'orthographe américaine lorsque ni l'un ni l'autre n'est clair.

Skills associés