Skill pipeline-comptable — orchestrateur
> Action humaine : traiter son courrier du matin de bout en bout.
> N'invente aucune logique : il appelle les quatre briques dans l'ordre et passe
> le « dossier » de l'une à l'autre. Toute l'intelligence est dans les briques.
📬 mail / dépôt de pièces
│
① tri-courrier-entrant ce mail me concerne ? quelles pièces ?
▼
② analyse-piece-comptable qu'est-ce que c'est ? quels montants ?
▼
③ identification-client à quel client ça appartient ? achat ou vente ?
▼
④ classement-document je range au bon endroit.
▼
⑤ rapprochement-paiements je pointe les relevés avec les factures.
L'étape ⑤ se lance automatiquement une fois les pièces classées (le moteur
retraite tout le dossier client, c'est un cache reconstructible). Pour la sauter
ponctuellement : --no-rapprochement.
Comment l'utiliser
# Depuis un mail (tri ① inclus, puis ②③④ par pièce) :
python3 scripts/pipeline.py --email <mail.json> --clients-root <chemin/clients>
# Depuis un lot de pièces déjà déposées (②③④, pas de mail donc pas d'étape ①) :
python3 scripts/pipeline.py --inbox <dossier> --clients-root <chemin/clients>
Sortie : un rapport JSON consolidé sur la sortie standard (un « dossier »
complet par pièce, avec chaque bloc rempli par son étape) + un résumé lisible
sur la sortie d'erreur (pièces rangées, doublons, en attente, questions).
Comment en rendre compte au comptable
Lis le résumé et restitue-le simplement, dans le ton habituel :
- Ce qui a été fait — « 5 pièces traitées : 4 factures rangées, 1 relevé. »
- Ce qui attend une décision — pose les questions d'identification telles
quelles, une par pièce ambiguë. Ne tranche jamais à la place du comptable. - Ce qui mérite attention — pièces incomplètes, doublons écartés.
Jamais de chemin technique, de nom de script, de « JSON » ou d'« index ».
Quand des pièces ont été rangées, la suite naturelle est le rapprochement des
paiements (rapprochement-paiements) — propose-le.
Pourquoi un orchestrateur séparé
Chaque brique reste utilisable seule (analyser une pièce isolée, reconnaître un
client, ranger un document). L'orchestrateur ne fait que les enchaîner pour le
cas courant « du courrier arrive, traite-le ». Si une brique évolue, l'orchestrateur
n'a rien à changer : il parle le même « dossier » JSON d'un bout à l'autre.
Limites assumées
- Les questions d'identification s'adressent au comptable : l'orchestrateur les
remonte, il ne décide pas à sa place. - Il traite, range et rapproche (étapes ① → ⑤). Il ne rédige pas les relances
lui-même : il les fait remonter (workflow e-mail) pour validation du comptable. - Le tri ① ne s'applique qu'au mode mail ; un dépôt direct de pièces commence à ②.
