Skill Clinical Report Writing — Guide complet
Guide détaillé de la skill Clinical Report Writing : contenu, comment la solliciter, structure des fichiers créés, références utilisées et contrôles de validation effectués.
La skill Clinical Report Writing vous aide à rédiger et valider la documentation clinique : rapports de cas (recommandations CARE), rapports diagnostiques (radiologie, pathologie, laboratoire), rapports d’essais cliniques (ICH-E3, SAE, CSR) et documentation patient (notes SOAP, H&P, résumés de sortie). Ce guide explique ce que couvre la skill, comment l’utiliser, quelle structure et quels modèles elle fournit, quelles références elle utilise et quels contrôles exécutent les outils intégrés.
Ce que la skill inclut
La skill couvre quatre grandes catégories de rapports cliniques :
- Rapports de cas cliniques pour publication — Recommandations CARE : titre, mots-clés, résumé, introduction, informations patient, constatations cliniques, chronologie, évaluation diagnostique, interventions thérapeutiques, suivi, discussion et consentement éclairé.
- Rapports diagnostiques — Structure des rapports de radiologie, pathologie et laboratoire (indication clinique, technique, comparaison, constatations, impression).
- Rapports d’essais cliniques — Clinical Study Reports (CSR) selon ICH-E3 ; rapports SAE ; résumés type DSMB.
- Documentation patient — Notes SOAP, anamnèse et examen physique (H&P), résumé de sortie, notes de consultation.
Elle applique aussi les exigences réglementaires et qualité : dé-identification HIPAA (18 identifiants), consentement éclairé, abréviations JCAHO « Do Not Use » et ambiguës, et usage optionnel de la skill scientific-schematics pour au moins une figure par rapport (ex. chronologie, diagramme CONSORT).
Ce que vous pouvez demander
| Objectif | Exemples de prompt |
|---|---|
| Rédiger un rapport de cas | “Rédige un rapport de cas clinique pour soumission à une revue selon les recommandations CARE. J’ai ajouté mes notes et la chronologie patient (dé-identifiée).” |
| Créer un rapport diagnostique | “Crée un rapport de radiologie (ou pathologie / laboratoire) à partir des constatations que j’ai collées.” |
| Documentation patient | “Rédige une note SOAP (ou un résumé de sortie, H&P) pour cette consultation.” |
| Rapports d’essai | “Rédige le plan d’un Clinical Study Report selon ICH-E3” ou “Formate cette CSV d’événements indésirables en tableau récapitulatif EA.” |
| Vérifier la conformité CARE | “Valide mon rapport de cas par rapport aux recommandations CARE.” |
| Vérifier la dé-identification | “Lance le contrôle de dé-identification sur ce rapport avant soumission.” |
| Vérifier la terminologie | “Vérifie les abréviations interdites ou ambiguës.” |
| Vérifier la conformité réglementaire | “Vérifie les indicateurs HIPAA/GCP/FDA dans ce document.” |
Ajoutez vos sources (notes, chronologies, valeurs de labo, CSV) dans l’espace de travail du projet et activez la skill Clinical Report Writing ; l’agent vous guidera étape par étape.
Structure des fichiers créés
La skill n’impose pas une arborescence fixe. Elle fournit des modèles (dans les assets/ de la skill) que l’agent peut copier et remplir :
Rapports de cas et d’essai
| Modèle | Usage |
|---|---|
case_report_template.md | Rapport de cas structuré CARE. |
clinical_trial_csr_template.md | Structure ICH-E3 de CSR. |
clinical_trial_sae_template.md | Rapport d’événement indésirable grave. |
Documentation patient
| Modèle | Usage |
|---|---|
soap_note_template.md | Note SOAP. |
history_physical_template.md | Anamnèse et examen physique. |
discharge_summary_template.md | Résumé de sortie. |
consult_note_template.md | Note de consultation. |
Rapports diagnostiques
| Modèle | Usage |
|---|---|
radiology_report_template.md | Rapport de radiologie. |
pathology_report_template.md | Rapport de pathologie. |
lab_report_template.md | Rapport de laboratoire. |
Listes de contrôle
| Ressource | Usage |
|---|---|
quality_checklist.md | Qualité et complétude. |
hipaa_compliance_checklist.md | Dé-identification HIPAA et consentement. |
Ce qui est utilisé comme référence
La skill charge les références suivantes depuis son répertoire references/ :
| Fichier de référence | Contenu |
|---|---|
case_report_guidelines.md | Checklist CARE pour rapports de cas. |
clinical_trial_reporting.md | ICH-E3 et structure CSR/SAE/DSMB. |
diagnostic_reports_standards.md | Normes pour rapports radiologie, pathologie, laboratoire. |
patient_documentation.md | Conventions SOAP, H&P, sortie, consultation. |
data_presentation.md | Tableaux, figures, présentation des données. |
medical_terminology.md | Terminologie, abréviations, codage (ex. ICD-10). |
peer_review_standards.md | Revue par les pairs et exigences des revues. |
regulatory_compliance.md | HIPAA, FDA, ICH-GCP (consentement, dé-identification, sécurité). |
Références conceptuelles : CARE, ICH E6(R3) GCP, ICH E3 (CSR), HIPAA (18 identifiants), liste « Do Not Use » JCAHO, FDA.
Quels contrôles sont effectués
La skill fournit une extension avec sept outils :
1. validate_case_report
Valide les rapports de cas par rapport à CARE : sections requises, contrôle HIPAA rapide, nombre de mots, références. Sortie : PASS / NEEDS_REVISION, checklist CARE, avertissements HIPAA.
2. validate_trial_report
Valide les CSR par rapport aux sections ICH-E3 (page de titre, synopsis, sommaire, abréviations, éthique, investigateurs, introduction, objectifs, patients, efficacité, sécurité, discussion, tableaux/figures, références, annexes). Sortie : taux de conformité et checklist des sections.
3. check_deidentification
Recherche les 18 identifiants HIPAA (noms, données géographiques, dates, téléphone, e-mail, SSN, MRN, etc.) et indique la gravité (CRITICAL/HIGH/MEDIUM) et des exemples. Vérifie l’âge >89 (agrégation « 90 ou plus »). Sortie : COMPLIANT / NEEDS_REVIEW / NON_COMPLIANT.
4. validate_terminology
Vérifie les abréviations JCAHO Do Not Use (U, IU, QD, QOD, MS, MSO4, MgSO4) avec remplacements suggérés, les abréviations ambiguës (cc, hs, TIW, SC, D/C, OS, OD, OU, etc.) et les codes ICD-10.
5. check_compliance
Vérifie les indicateurs HIPAA (consentement, dé-identification), GCP (IRB/IEC, protocole, consentement), FDA (IND/IDE/protocole, événements indésirables/SAE). Sortie : OK / MISSING par point de contrôle.
6. extract_clinical_data
Extrait des données structurées : démographie, constantes (temp, TA, FC, FR, SpO2), médicaments (principe, dose, voie, fréquence). Sortie : JSON.
7. format_adverse_events
Convertit un CSV avec colonnes treatment_arm, any_ae, related, serious, fatal, discontinuation en tableau récapitulatif Markdown par bras de traitement.
Quand exécuter quoi : Après rédaction d’un rapport de cas, validate_case_report et check_deidentification ; pour un CSR, validate_trial_report. Avant finalisation, validate_terminology et check_compliance. Utiliser extract_clinical_data et format_adverse_events pour données structurées ou tableaux d’EA.
Résumé
| Thème | Résumé |
|---|---|
| Contenu de la skill | Quatre catégories : rapports de cas (CARE), diagnostiques, d’essai (ICH-E3, SAE, CSR), documentation patient. Plus HIPAA, terminologie et scientific-schematics en option. |
| Prompts | Rédiger rapports ; valider CARE/ICH-E3 ; vérifier dé-identification, terminologie, conformité ; formater CSV EA ; extraire données cliniques. |
| Structure | Modèles pour rapport de cas, CSR, SAE, SOAP, H&P, sortie, consultation, radiologie, pathologie, laboratoire et listes de contrôle. |
| Références | Huit fichiers de référence (CARE, ICH E3/E6, HIPAA, JCAHO, FDA). |
| Contrôles | Sept outils : validate_case_report, validate_trial_report, check_deidentification, validate_terminology, check_compliance, extract_clinical_data, format_adverse_events. |
Utilisez la skill Clinical Report Writing lorsque vous devez rédiger ou valider de la documentation clinique et souhaitez que l’agent suive CARE, ICH-E3 et HIPAA avec modèles, références et outils de validation en un seul endroit.