convez.ai
PluginEscrita & ConteúdoAvançado
MariusYvard

Scriptorium

MariusYvard/Scriptorium

Orquestra redação rigorosa com scripts determinísticos e charte gráfica obrigatória

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin de engenharia textual que transforma pedidos de redação em documentos estruturados e verificáveis. Combina julgamento do modelo com 18 scripts determinísticos para aplicar rigor, estilo e conformidade a 25 gêneros de conteúdo, cobrindo ciclo completo de enquadramento, produção, controle e entrega em múltiplos formatos (Word, PDF, HTML, PowerPoint).

Instalação

$npx convez-ai MariusYvard/Scriptorium

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 2 meses
Versão
v0.14.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Produção de documentos técnicos e relatórios com verificação de fontes
  • Geração de 25 gêneros textuais com estilo corporativo consistente
  • Redação colaborativa com controle de qualidade adversarial e auditorias de coerência

Veredito

Ferramenta robusta para equipes que exigem documentos verificáveis com alta conformidade. Deslocar a rigurosidade do modelo para código é abordagem sólida, mas demanda curva de aprendizado significativa com suas 4 competências e 18+ scripts específicos.

README

A tradução para o português deste README ainda está na fila.

Scriptorium est un plugin Claude (Cowork et Claude Code) qui transforme une demande de rédaction en document fini. Il applique une méthodologie d'ingénierie textuelle, déplace la rigueur vérifiable du jugement du modèle vers dix-huit scripts déterministes, et impose un style maison à directives strictes. Quatre compétences couvrent le cycle de vie complet, du cadrage à la livraison, sur vingt-cinq genres adossés chacun à des sources faisant autorité.

Comment ça marche

flowchart LR
  A["<b>atelier</b><br/>piloter · cadrer · projet"] --> P["<b>produire</b><br/>genre · sourcer · figure · tableau<br/>equation · style · charte · image"]
  P --> C["<b>controler</b><br/>revue · contredire · consensus<br/>humaniser · audit · relecteurs"]
  C --> L["<b>livrer</b><br/>document · decliner"]
  L --> O(["Word · PDF · HTML · PowerPoint"])

Deux moteurs travaillent ensemble. Le modèle tranche le jugement : rédiger, classer, résumer, décrire une image, formuler une contre-thèse. Le code tranche le mécanique et le reproductible : détecter un tiret cadratin, nettoyer une URL, noter un document sur cent, lire les dimensions d'une image. Une affirmation majeure sans preuve cartographiée est affaiblie ou retirée, c'est une contrainte dure et non une préférence.

Installation

Télécharger scriptorium-0.6.7.plugin depuis la page des releases, puis l'installer.

  • Cowork : ouvrir le fichier .plugin et accepter l'installation.
  • Claude Code : /plugin marketplace add MariusYvard/Scriptorium, puis installer le plugin scriptorium.

Les compétences apparaissent sous le préfixe scriptorium:. Les scripts et le harnais d'évaluation tournent en Python sans dépendance (python3 evals/run-evals.py).

Les quatre compétences

CompétenceSous-commandesRôle
atelierpiloter · cadrer · projetPoint d'entrée. Orchestre la production de A à Z, cadre le sujet, garde le contexte du projet entre les sessions.
produiregenre · sourcer · revue-litterature · figure · tableau · equation · style · charte · imageProduit le contenu et fixe la forme. Rédige les vingt-cinq genres, trouve et vérifie les sources, génère figures et tableaux, pose les équations, applique style et charte, extrait les images d'un document source.
controlerrevue · contredire · consensus · humaniser · audit · relecteursÉprouve un écrit. Revue adversariale, contradiction par le modèle de Toulmin, vote de consensus, détection d'empreinte IA, audit d'un document existant, réponse aux relecteurs.
livrerdocument · declinerMet en forme le livrable (Word, PDF, HTML) et le décline par canal (présentation, résumé, abstract, post, communiqué).

Chaque sous-commande charge à la demande son fichier de référence, le contexte reste léger. Décrire la cible suffit à déclencher la bonne action ; il est aussi possible de nommer l'action, par exemple produire figure.

En une demande

« Rédige une analyse stratégique de 20 pages sur le marché X pour mon comité de direction, avec un SWOT et un PESTEL. »

atelier enchaîne le cadrage (problématique fermée, plan validé), le sourcing (sources pondérées, carte preuve-affirmation), la rédaction déléguée section par section à l'agent redacteur, les figures SWOT et PESTEL produites en SVG, la revue adversariale, puis la mise en forme à la charte. Trois points de contrôle reviennent vers vous : le périmètre, la suffisance des preuves, le verdict de révision.

Garde-fous déterministes

Dix-huit scripts en Python pur déplacent la rigueur du jugement du modèle vers un contrôle mécanique et reproductible. Une porte d'intégration continue (tools/check.py) verrouille un document contre un seuil de note.

ScriptCe qu'il attrape
lint-style.pyTiret cadratin, typographie courbe, lexique promotionnel, virgule d'Oxford, métadiscours, paramètres de suivi.
verify-sources.pyURL à nettoyer, doublons, DOI douteux.
scorecard.pyNote déterministe de 0 à 100 sur cinq axes, calcul montré, verdict.
traceability.pyRéférences orphelines ou pendantes, appels de figures et de tableaux.
ai-fingerprint.pyRythme uniforme, ouvertures répétées, cadence ternaire, connecteurs suremployés.
numbers.pyPourcentages impossibles, partitions qui ne somment pas, séparateur décimal mixte.
theme.pyValidation de charte, contraste WCAG, émission du CSS du HTML.
images.pyExtraction d'images (Office, PDF), déduplication, dimensions, manifeste.

Le catalogue complet est dans scripts/README.md. Un hook lance le linter après chaque écriture et bloque la finalisation tant qu'un écart critique subsiste.

Vingt-cinq genres sourcés

Chaque genre est adossé à des sources faisant autorité, citées dans son playbook (skills/produire/references/genre-*.md).

  • Académique et recherche : rapport scientifique et mémoire (IMRAD), article, revue de littérature (PRISMA), demande de financement et proposition de recherche, dissertation et commentaire.
  • Entreprise et conseil : long rapport décisionnel, analyse stratégique (SWOT, PESTEL, 5 forces, Mactor), prospective, étude de cas, business plan, étude de marché, proposition commerciale et réponse à appel d'offres.
  • Technique : cahier des charges et spécification (IEEE 29148), documentation technique (Diátaxis), rapport d'incident et post-mortem.
  • Finance : note d'analyse financière et mémo d'investissement.
  • Public et droit : note de politique publique, rapport d'évaluation (critères OCDE/CAD), note et consultation juridique (IRAC), conclusions et mémoire contentieux, rédaction de contrat.
  • Santé : cas clinique et protocole de recherche (CARE, CONSORT, STROBE, PRISMA).
  • Communication : livre blanc, discours et allocution, présentation (soutenance), pitch (commercial et levée de fonds).

Quatorze publics

PublicGenres de prédilection
ChercheurRapport scientifique IMRAD, article, revue de littérature, demande de financement.
IngénieurCahier des charges, documentation technique, post-mortem, étude de cas.
Analyste géopolitiqueAnalyse stratégique (Mactor, PESTEL), prospective, note de politique publique.
JuristeNote et consultation juridique (IRAC), conclusions contentieuses, contrat.
Professionnel de santéCas clinique, protocole de recherche (CARE, CONSORT, STROBE).
Consultant et dirigeantLong rapport décisionnel, analyse stratégique, business plan.
Communicant et marketingLivre blanc, article, présentation, étude de marché.
ÉtudiantDissertation et commentaire, mémoire, présentation de soutenance.
Analyste financierNote d'analyse financière, mémo d'investissement.
EntrepreneurBusiness plan, étude de marché, proposition commerciale, pitch.
EnseignantSupport de cours, dissertation, présentation.
Chef de projetCahier des charges, proposition commerciale, rapport d'évaluation.
Agent publicNote de politique publique, rapport d'évaluation.
JournalisteArticle, enquête, tribune.

La méthode et le style maison ne changent pas, seuls le genre et les exemples s'adaptent au domaine. Les profils de discipline (voir controler consensus) calibrent la norme de citation et le seuil d'exigence.

Formats de sortie

Le format de travail est le Markdown. La finalisation produit un document Word (.docx), un PDF, un HTML autonome dont le CSS dérive de la charte graphique (jetons, focus visible, feuille d'impression, source idéale pour un PDF fidèle), ou une présentation PowerPoint. Les figures sortent en SVG, les tableaux en Markdown, les équations en PDF via LaTeX, et les images d'un document source sont extraites puis replacées, numérotées et à la charte.

Style maison

Le style par défaut applique des directives strictes : registre encyclopédique et neutre, zéro tiret cadratin, pas de virgule d'Oxford, guillemets et apostrophes droits, lexique promotionnel banni, faits précis ou rien, sources vérifiées sans paramètres de suivi. Il vit dans skills/produire/references/directives-strictes.md et le linter applique les mêmes règles. La compétence produire (style) peut régénérer une charte à partir de vos écrits.

Agents délégués

Le travail lourd est confié à cinq agents lancés via l'outil Task : redacteur (rédaction long-format), controle-qualite (validation structurée), synthese-sources (recherche et triangulation), contradicteur (contre-thèse), verificateur-faits (vérification factuelle).

Évaluations et release

evals/run-evals.py relie des cas piégés à des attentes précises et vérifie que les garde-fous attrapent ce qu'ils doivent, et que chaque playbook de genre porte une section Sources. La publication est automatisée : un tag vX.Y.Z déclenche la vérification des versions, les evals, la construction du .plugin et la création de la Release. Voir docs/RELEASE.md et CHANGELOG.md.

Licence

MIT. Voir LICENSE.

Ver o original no GitHub

Bom para

Relacionados