tpc-pascal/agent-skills

Bản tiếng Anh: SKILL.en.md

orchestrateur — coordination des entrées

Compétence légère auto-écrite : aucun code propre — reçoit une entrée, détermine son type, l'achemine vers le bon traitement.

Compétences de ce dépôt

Compétence	Quand l'utiliser
doc	PDF/DOCX/XLSX : extraire le texte, OCR, conversion, fractionner/assembler des pages
media	vidéo/audio/images/URL : résumé, extraire le texte, sous-titres, montage, frames, téléchargement
paper	rédaction de rapports internationaux ou de rapports de vulgarisation vietnamiens
web	lire des pages web/journaux/réseaux sociaux + recherche (Jina, agent-reach, exa)
diagram	dessiner des diagrammes Mermaid / graphiques matplotlib pour les rapports
orchestrator (cette compétence)	coordonner les compétences ci-dessus + questionnaire avant rapport

Pour installer tout ce qu'il faut : npx skills add tpc-pascal/agent-skills --all (ou --skill orchestrator web doc media paper diagram).

Table de routage par type d'entrée

Entrée + besoin	Destination
PDF/DOCX/XLSX (texte, OCR, conversion, fractionner/assembler)	compétence doc
vidéo/audio/images/URL média (résumé, sous-titres, montage, frames, téléchargement)	compétence media
Lire le web/réseaux sociaux/recherche (URL, articles, exa)	compétence web
Rédiger un rapport à partir de sources	Questionnaire (section ci-dessous) → choisir un formulaire dans la compétence paper
Dessiner des schémas/graphiques pour un rapport	compétence diagram

Questionnaire préalable au rapport

Déclencheur : l'utilisateur demande de créer ou de réécrire un rapport ; ne s'applique pas aux demandes de simple extraction/conversion.

Avant de mener des recherches approfondies ou de rédiger un rapport, poser au maximum 4 questions, uniquement sur les points manquants :

• Type : rapport international ou rapport de vulgarisation vietnamien ?

• Objectif et public : qui va le lire, à quelle(s) question(s) doit-il répondre ?

• Sortie : langue, format et limite de longueur, le cas échéant ?

• Sources et périmètre : quelles sources/parties utiliser ; est-il permis d'ajouter des sources externes ?

• Ne pas redemander ce qui est déjà présent dans la demande/la conversation. Si l'utilisateur délègue la décision, choisir l'option appropriée et mentionner brièvement les hypothèses qui affectent le résultat.

• Ne pas attendre de réponse pour des informations non essentielles ; ne pas imposer le choix détaillé des sections avant de connaître les sources.

• Extraire avec la compétence appropriée, puis rédiger selon un formulaire exact de paper.

Règles de coordination

1. Respecter la langue de l'entrée — répondre dans la même langue que l'utilisateur.
2. Indiquer clairement la sortie du fichier source : <nom_original>.<suffixe>. Ne pas écraser les fichiers. Suffixes : document .extract.md|.txt|.csv, résumé .digest.md, sous-titres .srt|.vtt, clip .clip-<t1>-<t2>.mp4, rapport .report.md|.report.docx.
3. Ne pas importer d'entrée — ne traiter que les fichiers réellement présents, placer la sortie dans/sous les fichiers ; ne pas ajouter de fichiers soi-même.
4. Entrée web/réseau social/recherche → compétence web (Jina/agent-reach/exa) lire d'abord ; entrée média → compétence media.
5. Contenu verrouillé (réseaux sociaux, articles payants) → laisser la compétence web (agent-reach/Jina) lire à la place ; ne pas se connecter, ne pas contourner le verrou — signaler à l'utilisateur si la lecture échoue.
6. Lorsqu'un rapport/fichier de rapport (tout .report.docx) : vérifier selon la compétence paper — pdfinfo + pdftotext, ne pas inventer.
7. La compétence média nécessite une récupération par session → voir la compétence media (section fetch) ou scripts/fetch-session.sh --list.
8. Local d'abord : privilégier les outils locaux pour les fichiers locaux. Le web/API nécessitent une connexion ; en mode hors-ligne, n'utiliser que les sources locales/cache réellement disponibles ou fournies par l'utilisateur, et mentionner les parties inaccessibles.
9. Toujours signaler les fichiers écrits (nom + chemin) — ne pas rester silencieux.

Notation des flux

Dans le schéma ci-dessous, ▸ signifie passage à l'étape suivante ; → signifie continuation du flux ; les crochets décrivent le type de source ou de résultat. C'est une notation de flux, pas des étiquettes de source ou de format de sortie.

Flux de coordination courants

PDF scanné ▸ compétence doc ▸ texte/tableau ▸ compétence paper ▸ rapport
URL web/réseau social ▸ compétence web ▸ texte ▸ compétence paper (si besoin de rapport)
URL/fichier vidéo ▸ compétence media ▸ digest + frame ▸ compétence paper (si besoin de rapport)
SRT/mm:ss ▸ compétence media ▸ rogner ▸ concaténer