tpc-pascal/agent-skills

Rédigez des rapports selon l'un des deux formats : norme internationale ou format courant au Vietnam. Synthétisez les sources avec citations, gardez le rapport principal concis et séparez les données auxiliaires si nécessaire ; exportez au format `.report.md` ou `.report.docx`.

Qu'est-ce que agent-skills ?

Cette compétence d'agent IA permet de rédiger des rapports structurés à partir de sources collectées, en choisissant entre deux formats distincts : le format académique international, pour des travaux de recherche nécessitant une méthodologie rigoureuse et des citations complètes, et le format de rapport courant au Vietnam, destiné à un public généraliste tout en maintenant l'exactitude des preuves. L'agent suit des règles précises : il interroge d'abord l'orchestrateur pour déterminer le type de rapport, le public, l'objectif, la langue et le format ; il utilise exclusivement le cadre choisi sans mélanger les deux styles ; il conserve le fichier `.report.md` centré sur l'argumentation et place les extraits bruts, les grands tableaux de données et les annexes dans des fichiers séparés. La compétence privilégie les outils locaux pour la rédaction et la vérification hors ligne, exporte en DOCX/PDF via des outils locaux et vérifie la cohérence des citations et du contenu. Elle prend en charge les plateformes d'agents comme Claude Code, Cursor ou Codex, et est utile pour tout développeur ou rédacteur technique devant produire des rapports formalisés avec des sources traçables.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/tpc-pascal/agent-skills/tree/HEAD/skills/research/paper

Documentation

Version anglaise : SKILL.en.md

paper — rédiger un rapport

Cette compétence rédige un rapport à partir de sources collectées. Choisissez un des deux formats ; ne mélangez pas les deux cadres dans un même rapport.

Deux formats de rapport

Format	Référence	Utilisation
Rapport académique international	`references/report-academic.md`	Lorsqu'une structure de recherche claire, une méthodologie évaluable et des citations complètes sont nécessaires. Suivez le guide correspondant au type de recherche ; ne déclarez pas de conformité à une norme sans avoir vérifié la checklist correspondante.
Rapport courant au Vietnam	`references/report-template.md`	Lorsqu'il faut expliquer les résultats à un public généraliste en langue française, tout en conservant l'exactitude des preuves et des limites.

Les règles générales se trouvent dans references/output-format.md. Extrayez les documents/médias au préalable via la compétence appropriée si nécessaire.

Règles d'exécution

Interrogez le portail de demande de l'orchestrator ; arrêtez le format, le public, l'objectif, la langue et le format. Ne reposez pas de questions sur des informations déjà fournies.
Utilisez exclusivement le cadre du format choisi. La langue par défaut suit la demande/le contexte ; n'imposez pas le bilinguisme.
Gardez le fichier .report.md concentré sur le contenu et l'argumentation. Placez les extraits textuels, les grands tableaux de données, les métadonnées techniques, les journaux d'outils et les annexes non essentielles dans un fichier séparé ; conservez les citations nécessaires directement dans le rapport.
Utilisez les outils locaux lorsque c'est approprié. Un rapport issu de sources locales doit pouvoir être rédigé et vérifié hors ligne ; n'accédez à une URL/API ou à un service externe que lorsque la source/la demande nécessite le réseau. Ne basculez pas silencieusement vers un service distant.
Enregistrez <nom_source>.report.md à côté de la source, sans écraser la source. Placez les fichiers auxiliaires avec un suffixe clair, par exemple .sources.md, .extract.txt, .data.csv, .transcript.md ou .diagram.png.
N'inventez pas de données, de citations ou de numéros de page. Attribuez une source à chaque affirmation ; distinguez les faits, les observations et les déductions lorsque le style d'écriture n'est pas assez clair.
Vérifiez les liens de citation, la cohérence et le contenu du rapport. Lors de l'exportation en DOCX/PDF, utilisez les outils locaux disponibles pour vérifier le texte et les pages ; signalez clairement si un outil n'est pas disponible.
Répondez dans la même langue que l'utilisateur et indiquez le nom/chemin de tous les fichiers créés.

Exportation DOCX et PDF

Privilégiez les outils locaux installés. Si une conversion complexe est nécessaire, référez-vous à la compétence doc — doc-recipes.md. Vérifiez la sortie avec pdfinfo et pdftotext lorsque c'est possible.

Sources de recherche

Les sources utilisées pour élaborer les principes de rédaction sont consignées dans references/reporting-principles-sources.md ; il s'agit d'un document de référence de la compétence, et non d'une partie obligatoire à insérer dans chaque rapport.