Lucian1u/material-to-deliverable

Transformez des documents bruts en actifs de connaissance réutilisables : rapports, résumés et index de sources organisés.

Qu'est-ce que material-to-deliverable ?

Cette compétence permet de transformer des documents bruts, situés dans le dossier `00_input/`, en livrables structurés et vérifiables (rapports, résumés, présentations, etc.) tout en garantissant la traçabilité et la sécurité des informations. Utile pour les développeurs, chercheurs ou professionnels souhaitant capitaliser sur leurs données, elle prend en charge plusieurs environnements (Claude Code, Cursor, Codex, etc.) via des scripts Python et des fichiers de configuration markdown. Le processus inclut : l'analyse des entrées, la détection des informations sensibles (avec demande d'autorisation), la clarification des besoins via des questions ciblées, la création d'un plan détaillé avec sources, la génération du livrable final, un audit automatique, et la validation finale. Les livrables sont placés dans `02_delivery/` et l'utilisateur doit toujours valider manuellement. Le système s'arrête et explique le manque si les conditions ne sont pas remplies, sans inventer de contenu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Lucian1u/material-to-deliverable

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

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

Documentation

Matériau en Livrable

Transformez les documents réels situés dans 00_input/ en fichiers textuels vérifiables, traçables et prêts à être livrés.

Conditions de Démarrage

N'exécuter que lorsque toutes les conditions suivantes sont réunies :

  • L'utilisateur fournit ou spécifie un répertoire de projet local.
  • 00_input/ contient au moins un document réel.
  • L'utilisateur souhaite obtenir un rapport, un plan, une rétrospective, une étude ou une présentation de cours.

Si le répertoire n'est pas clair, ne demander que le répertoire du projet. Si le type de livrable n'est pas clair, ne demander que le type de livrable. En l'absence de documents réels, s'arrêter sans générer d'exemple ou de contenu de substitution.

Lectures Obligatoires Avant Chaque Traitement

Avant de commencer le traitement, lire intégralement :

Après avoir confirmé le type de livrable, lire la section correspondante dans Règles des Types de Livrables.

Flux de Travail

1. Confirmation du Projet et Initialisation

Si le projet n'est pas encore initialisé, appeler le script depuis le répertoire d'installation de cette compétence, en passant le chemin absolu du projet :

python3 <skill-directory>/scripts/init_project.py /chemin/absolu/vers/le/projet

Ne pas supposer que scripts/ se trouve dans le répertoire courant du projet de l'utilisateur. Déterminer <skill-directory> d'après l'emplacement de ce fichier avant d'exécuter le script.

Si 01_working/ existe déjà, lire l'état existant et continuer sans réinitialiser ni écraser les fichiers.

2. Vérification des Entrées et des Informations Sensibles

Lister tous les fichiers dans 00_input/. Noter ceux qui sont illisibles ou dont la source est inconnue. Ne pas modifier, déplacer ni renommer les documents originaux.

Effectuer d'abord la vérification des informations sensibles. En cas de découverte de noms, coordonnées personnelles, comptes, données clients, contrats, informations financières, médicales, éducatives, justificatifs, chemins internes ou autres données potentiellement restreintes :

  1. Enregistrer uniquement le type de risque et l'emplacement du fichier dans 02_material-index.md, sans copier les valeurs sensibles.
  2. Suspendre immédiatement.
  3. Demander à l'utilisateur de confirmer qu'il a le droit de traiter ces documents, ou de fournir une copie anonymisée.

Sans confirmation de l'utilisateur, ne pas continuer avec le plan, la rédaction ou la livraison.

3. Clarification de la Mission

Poser une seule question à la fois, maximum sept, qui modifie le livrable final. Prioriser : le destinataire, le contexte d'utilisation, la décision à faciliter, la date butoir, le type de livrable, le contenu impératif et le contenu interdit.

Si l'utilisateur répond « je ne sais pas », enregistrer comme point à confirmer, sans répondre à sa place. Rédiger les résultats dans 01_task-brief.md, afficher un résumé, et attendre la confirmation de l'utilisateur.

4. Établir l'Index des Documents et les Lacunes

Remplir 02_material-index.md pour chaque document, en distinguant :

  • Faits directement soutenus par la source
  • Déclarations de la personne ou de l'organisation concernée
  • Entretiens, retours ou observations partielles
  • Jugements personnels de l'utilisateur
  • Informations à confirmer

Noter les conflits, les éléments manquants, les fichiers illisibles, les besoins d'anonymisation et les preuves insuffisantes dans 03_gaps-and-conflicts.md. Un petit nombre de documents ne permet pas de tirer des conclusions générales.

Si des lacunes bloquantes persistent, continuer à poser des questions ou s'arrêter, sans générer de livrable principal.

5. Créer un Plan avec Sources

Créer 04_source-backed-outline.md en fonction du type de livrable. Chaque section doit préciser : la question à répondre, les documents utilisés, les conclusions autorisées, les jugements de l'utilisateur, les points à confirmer et le mode de validation.

Afficher un résumé du plan et la couverture des sources, puis attendre la confirmation de l'utilisateur. Ne pas rédiger le livrable principal avant confirmation.

6. Générer le Livrable et l'Index des Sources

Après confirmation du plan, générer :

  • 05_main-deliverable.md
  • 06_one-page-summary.md
  • 07_source-index.md

Chaque fait clé doit être lié dans l'index des sources à un fichier et une position spécifiques. Ne pas ajouter de chiffres, personnes, cas, citations ou résultats absents des documents. Les jugements personnels doivent être séparés des faits sourcés.

7. Retour aux Documents Originaux pour Audit

Relire 00_input/, sans se baser uniquement sur le livrable généré pour une auto-vérification. Noter les problèmes de faits, de portée, de logique, de confidentialité, de cohérence de la mission et d'expression dans 08_audit-report.md.

Ne modifier que les problèmes pouvant être clairement corrigés par les documents existants. Les éléments nécessitant un jugement de l'utilisateur restent en attente.

8. Préparer le Paquet de Livraison

N'écrire dans le paquet livrable que si l'audit ne révèle aucun problème bloquant :

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/ ne doit pas contenir de documents originaux, de consignes, d'échanges utilisateur, de brouillons internes ou de valeurs sensibles. Enfin, depuis le répertoire d'installation de cette compétence, exécuter :

python3 <skill-directory>/scripts/validate_project.py /chemin/absolu/vers/le/projet --stage delivery

Une fois le script de validation passé, rappeler à l'utilisateur d'effectuer une validation manuelle finale. Le script ne vérifie que la structure des fichiers et les résidus évidents ; il ne peut pas prouver l'exactitude des faits.

Conditions d'Arrêt

S'arrêter et expliquer ce qui manque dans les cas suivants :

  • 00_input/ est vide ou les documents sont illisibles.
  • L'utilisateur n'a pas confirmé que les documents sensibles peuvent être traités.
  • Le destinataire, le type de livrable ou l'objectif principal restent flous.
  • Les documents actuels ne peuvent pas soutenir la conclusion principale.
  • L'utilisateur n'a pas encore confirmé le brief de mission ou le plan.

Ne pas contourner les conditions d'arrêt avec des documents fictifs, des recherches en ligne ou des déductions basées sur le bon sens, sauf si l'utilisateur autorise explicitement une nouvelle source de données.

Langue de Sortie

Par défaut, suivre la langue actuelle de l'utilisateur. Les noms de fichiers restent en anglais pour une compatibilité multi-environnements ; le contenu des fichiers utilise la langue de l'utilisateur.

Skills associés