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.
- 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 ;
startn'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. Utilisezotherpour 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. Utilisezwhole-paperpour 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. Aveccodex, le moteur propose d'installer le hook de garde Codex (une étapesetup) ;othersignifie 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--inputl'échantillon d'écriture) et--task study-profiledé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, lisezreferences/style-profile.md.- Si votre lecture et celle du code diffèrent (par exemple vous passez
--section methodsmais le titre du texte dit Introduction), le moteur renvoie une étapeask(idclarify). Ne la résolvez jamais vous-même.
- 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é). - Chaque réponse est une étape. Lisez chaque fichier dans
readen entier (le profil de l'auteur,~/.agents/science-research-writing/user-style.md, est listé quand il existe : appliquez-le à tout), faites ce que ditinstruction, et écrivez votre résultat comme le JSON dansexpect. Le texte long va dans un fichier ; donnez son chemin. Une étapeaskest une question pour l'auteur : mettezcontext.questiontextuellement à l'auteur, attendez la réponse, et soumettez-la comme{"answer": ...}avec l'une descontext.options. Ne répondez jamais vous-même. - 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 uneerrorsignifie que la même étape est renvoyée : corrigez et soumettez à nouveau. - Répétez jusqu'à ce que
step.kindsoitdone. Montrez alorsoutputà 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
- É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.
- Construisez un récit. Donnez à chaque paragraphe et phrase une fonction que le lecteur peut voir, et liez chacun au précédent.
- É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.
- Faites correspondre la certitude aux preuves. Le temps, les verbes et les modalisateurs indiquent au lecteur à quel point faire confiance à une affirmation.
- 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.mdexplique 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
exceptionsde 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.