Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

Ensemble de compétences pour l'agent Claude Code dédié à la rédaction et à la révision d'articles académiques (SSRN / arXiv / Zenodo / revues). Regroupe une compétence orchestratrice, une compétence de brouillon et 5 sous-agents réviseurs — premier dépôt à empaqueter compétences et agents via install.sh.

Qu'est-ce que claude-skill-paper-ecosystem ?

Cette compétence fournit un flux de travail complet pour la rédaction d'articles académiques (position papers, preprints, articles de revue) à l'aide de l'agent Claude Code. Elle s'intègre à l'orchestrateur `paper-ecosystem` et comprend une checklist pré-rédaction, un modèle de section standardisé, une structure d'abstract, des règles de formatage des références, et un processus de révision parallèle utilisant cinq agents spécialisés : réviseur de structure, vérificateur de fidélité des sources, vérificateur de cohérence du vocabulaire, formateur de citations, et vérificateur de qualité finale. La compétence impose des règles strictes : utilisation obligatoire des sources primaires, mappage 1:1 entre les affirmations et leurs citations, préservation des sous-classifications conceptuelles, et une procédure de dépôt en 7 points. Elle est idéale pour les chercheurs, ingénieurs et rédacteurs techniques qui souhaitent produire des articles académiques rigoureux avec l'assistance d'un agent IA, tout en maintenant une haute fidélité aux sources originales et une cohérence terminologique.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

paper-writing — Procédure de brouillon d'article académique

Compétence qui organise la procédure de brouillon d'un position paper / preprint / article de revue selon les règles canoniques de l'orchestrateur paper-ecosystem.

Quand activer

  • Rédiger un brouillon de papier pour les plateformes SSRN / arXiv / Zenodo / revue
  • Extraire un papier à partir d'une série d'essais existants, d'ADR ou d'historique d'implémentation
  • Passer à la rédaction de chaque section après validation du plan du position paper
  • Réviser un preprint v1 → v2 (lorsqu'une réécriture significative est nécessaire)

Hors activation

  • Blog post / essai (humain principal, informel) → utiliser writing-ecosystem
  • llms.txt / FAQ (IA principal) → utiliser llms-txt-writer
  • README / CHANGELOG (doc de projet) → écrire directement sans compétence

Checklist pré-rédaction

Avant de commencer le brouillon du papier, l'auteur doit avoir terminé ce qui suit :

1. Établir la liste des sources primaires

Lister les sources primaires que le papier va citer :

  • Essais / billets de blog sources (URL + date + résumé d'une ligne)
  • ADR / documents de spécification sources (chemin repo + version + résumé d'une ligne)
  • Articles externes sources (Auteur ANNÉE + arXiv ID / DOI + résumé d'une ligne)
  • Documents de normes / cadres sources (Organisme ANNÉE + ID de norme)

Chaque source primaire doit être accessible en lecture directe lors de la rédaction du brouillon (URL accessible, repo cloné, PDF téléchargé).

2. Éviter de se baser sur le glossaire / les résumés

Ne pas utiliser un glossaire / résumé / document secondaire du repo comme source de citation à la place de la source primaire. La dérive du document secondaire se propagerait au papier (détails : Règles de Fidélité aux Sources de la compétence paper-ecosystem).

Les documents secondaires sont utilisés uniquement pour :

  • Vérifier la cohérence des définitions de termes (vérifier que la définition du papier correspond à celle du glossaire)
  • Référence pour le format de la liste de références (exemple de style pour déterminer les champs à inclure)

3. Mappage 1:1 entre affirmation et source citée

Au stade du plan, écrire en une phrase l'affirmation centrale de chaque section, et lui associer une source citée en correspondance 1:1. Les affirmations dont le mappage est ambigu doivent être résolues avant d'entrer dans le brouillon.

Exemple de format :

§3 affirmation centrale : "L'échec de redirection a deux modes architecturalement distincts — le mode de principe (intrinsèque aux boucles autonomes) et le mode artificiel (tâche de workflow routée via des boucles autonomes)."
Sources citées :
- Essai 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Contexte (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) "Moral Crumple Zones"

4. Préservation des sous-classifications

Lorsqu'une source primaire attribue une sous-forme / sous-cellule / sous-type à un concept, cela doit être explicité dans l'introduction du terme dans le papier. L'aplatissement constitue une dérive (détails : Règles de Cohérence du Vocabulaire de la compétence paper-ecosystem).


Modèle de section (position paper / preprint)

Structure standard en 9 sections :

  1. Page de titre — Titre + sous-titre + auteur + ORCID + version + dépôt compagnon + licence
  2. Résumé — 250-300 mots, structure en 3 paragraphes (ci-dessous)
  3. Introduction — Énoncé du problème + aperçu de la thèse + feuille de route des sections
  4. [Sections du corps] — Contribution centrale du papier. Environ 3 à 6 sections
  5. Relation avec les cadres existants — Court (1 paragraphe à 1 page), relations avec les cadres concurrents
  6. Conclusion — Reprise de la thèse + questions ouvertes
  7. Références — Simplifié style APA
  8. Remerciements (optionnel)
  9. Annexe (optionnel)

Pour un article de revue, ajuster la numérotation des sections, la hiérarchie des titres et la disposition des tableaux et figures selon le style maison de la revue.


Structure du résumé (250-300 mots)

3 paragraphes :

  1. Énoncé du problème (~70-90 mots) — Quel phénomène est abordé et ce qui manque dans le discours actuel
  2. Contributions (~120-150 mots) — Énoncer explicitement les 2-3 contributions centrales du papier. Pour chaque contribution, une phrase sur quoi, pourquoi et comment
  3. Conséquence (~60-90 mots) — Ce que la contribution apporte au public du papier, avec mention des questions ouvertes non résolues

Mots-clés (5-8) placés juste après le résumé.


Format des références (simplifié style APA)

Type de sourceFormat
Article de revueAuteur, A. B. (ANNÉE). Titre. *Nom de la revue* Vol(Numéro) : pages.
Prépublication arXivAuteur, A. B., & Auteur, C. D. (ANNÉE). *Titre.* arXiv:NNNN.NNNNN.
Article de conférenceAuteur, A. B. (ANNÉE). Titre. Dans *Titre des actes* (pages). Éditeur.
Document industriel / entrepriseOrganisme. (ANNÉE). *Titre.* URL
NormeOrganisme. (ANNÉE). *ID de norme Titre.* Éditeur.
Dépôt / jeu de donnéesAuteur, A. B. (ANNÉE). *Titre (Version).* Plateforme. DOI

Détails : Règles de Formatage des Citations de la compétence paper-ecosystem.


Convention multilingue (optionnelle)

Si une version en langue subordonnée (ex. traduction en japonais) est créée en parallèle :

  • La version anglaise est la version principale, la version en langue subordonnée n'est pas la version de référence
  • Nom de fichier : <nom-papier>.md (anglais) + <nom-papier>.ja.md (japonais)
  • En cas de modification du contenu, la version anglaise vient en premier, la version en langue subordonnée est mise à jour progressivement
  • Les termes techniques (Quadrant / Phase Separation / nom d'artefact, etc.) restent en anglais dans la version en langue subordonnée, ou sont accompagnés de l'anglais

Détails : Convention multilingue de la compétence paper-ecosystem.


Processus de rédaction (rédaction d'une section)

Procédure de brouillon pour chaque section :

  1. Rédiger l'affirmation de la section en une phrase (revérifier la sortie de la checklist pré-rédaction)
  2. L'ouverture de la section doit être concrète : exemple / phénomène connu / citation de la source citée, ne pas commencer par un cadrage abstrait
  3. Placer immédiatement après la preuve soutenant l'affirmation (1:1 avec la citation)
  4. Marquer la transition de section à la fin de la section : ce qui est transmis à la section suivante, ce qui est transféré comme hypothèse de la section actuelle
  5. Les paragraphes subordonnés doivent suivre soit une direction de décomposition de l'affirmation, soit une direction de traitement des contre-arguments / alternatives, pas les deux à la fois (le mélange affaiblit le flux)

Après avoir terminé le brouillon de chaque section, lancer en parallèle l'agent paper-reviewer + l'agent source-fidelity-checker + l'agent vocabulary-consistency-checker pour effectuer la révision (détails : organigramme Quand Utiliser Quoi de la compétence paper-ecosystem).


Contrôle qualité (avant dépôt)

Juste avant le dépôt, vérifier :

  • Toutes les sections ont passé la révision par paper-reviewer
  • Toutes les affirmations ont reçu un verdict ALIGNÉ ou PARTIEL (DRIFT n'est pas présent) de source-fidelity-checker
  • Tous les termes ont passé la vérification de vocabulary-consistency-checker (introduction de sous-classification explicite)
  • citation-formatter rapporte 0 citation orpheline, correspondance 1:1 entre citations et références
  • Le nombre de mots du résumé se situe dans la plage standard de la plateforme
  • Tous les DOI / arXiv ID / URL sont valides
  • En cas de version multilingue, pas de divergence de contenu entre la version anglaise et les autres

Pour les dimensions détaillées, se référer aux 4 sections de règles canoniques de la compétence paper-ecosystem.


Liens connexes

  • Compétence paper-ecosystem — Source de référence pour la Fidélité aux Sources / la Cohérence du Vocabulaire / la Voix Académique / le Format des Citations. Orchestrateur sur lequel repose cette compétence
  • Agent paper-reviewer — Révision de structure après le brouillon d'une section
  • Agent source-fidelity-checker — Vérification de la correspondance citation-affirmation après le brouillon d'une section
  • Agent vocabulary-consistency-checker — Vérification de la cohérence terminologique après le brouillon d'une section
  • Agent citation-formatter — Contrôle final des citations et références avant dépôt
  • Compétence writing-ecosystem — Pour les billets de blog / essais, utiliser celle-ci, pas la présente
  • Compétence llms-txt-writer — Pour la documentation destinée à l'IA, utiliser celle-ci, pas la présente

Skills associés