Skill Clinical Report Writing — Guida completa
Guida dettagliata alla skill Clinical Report Writing: cosa include, come richiederla, struttura dei file creati, riferimenti usati e controlli di validazione eseguiti.
La skill Clinical Report Writing aiuta a redigere e validare la documentazione clinica: report di casi (linee guida CARE), report diagnostici (radiologia, patologia, laboratorio), report di studi clinici (ICH-E3, SAE, CSR) e documentazione paziente (note SOAP, H&P, riepiloghi di dimissione). Questa guida spiega cosa copre la skill, come usarla, quale struttura e quali template fornisce, quali riferimenti usa e quali controlli eseguono gli strumenti integrati.
Cosa include la skill
La skill guida quattro categorie principali di report clinici:
- Report di casi clinici per pubblicazione — Linee guida CARE: titolo, parole chiave, abstract, introduzione, informazioni paziente, reperti clinici, cronologia, valutazione diagnostica, interventi terapeutici, follow-up, discussione e consenso informato.
- Report diagnostici — Struttura di report di radiologia, patologia e laboratorio (indicazione clinica, tecnica, confronto, reperti, impressione).
- Report di studi clinici — Clinical Study Report (CSR) secondo ICH-E3; report SAE; riepiloghi in stile DSMB.
- Documentazione paziente — Note SOAP, anamnesi ed esame obiettivo (H&P), riepilogo di dimissione, note di consulenza.
Applica inoltre normativa e qualità: de-identificazione HIPAA (18 identificatori), consenso informato, abbreviazioni JCAHO “Do Not Use” e ambigue, e uso opzionale della skill scientific-schematics per almeno una figura per report (es. cronologia, diagramma CONSORT).
Cosa puoi richiedere
| Obiettivo | Esempi di prompt |
|---|---|
| Redigere report di caso | “Redigi un report di caso clinico per sottomissione a rivista secondo le linee guida CARE. Ho aggiunto le mie note e la cronologia del paziente (de-identificata).” |
| Creare report diagnostico | “Crea un report di radiologia (o patologia/laboratorio) dai reperti che ho incollato.” |
| Documentazione paziente | “Scrivi una nota SOAP (o riepilogo di dimissione, H&P) per questo incontro.” |
| Report di studio | “Redigi lo schema di un Clinical Study Report secondo ICH-E3” o “Formatta questa CSV di eventi avversi in una tabella riepilogativa EA.” |
| Verificare conformità CARE | “Valida il mio report di caso rispetto alle linee guida CARE.” |
| Verificare de-identificazione | “Esegui il controllo di de-identificazione su questo report prima della sottomissione.” |
| Verificare terminologia | “Controlla abbreviazioni vietate o ambigue.” |
| Verificare conformità normativa | “Controlla gli indicatori HIPAA/GCP/FDA in questo documento.” |
Aggiungi i materiali sorgente (note, cronologie, valori di laboratorio, CSV) allo spazio di lavoro del progetto e attiva la skill Clinical Report Writing; l’agente ti guiderà passo passo.
Struttura dei file creati
La skill non impone una struttura di cartelle fissa. Fornisce template (negli assets/ della skill) che l’agente può copiare e compilare:
Report di caso e di studio
| Template | Scopo |
|---|---|
case_report_template.md | Report di caso strutturato CARE. |
clinical_trial_csr_template.md | Struttura ICH-E3 di CSR. |
clinical_trial_sae_template.md | Report di evento avverso grave. |
Documentazione paziente
| Template | Scopo |
|---|---|
soap_note_template.md | Nota SOAP. |
history_physical_template.md | Anamnesi ed esame obiettivo. |
discharge_summary_template.md | Riepilogo di dimissione. |
consult_note_template.md | Nota di consulenza. |
Report diagnostici
| Template | Scopo |
|---|---|
radiology_report_template.md | Report di radiologia. |
pathology_report_template.md | Report di patologia. |
lab_report_template.md | Report di laboratorio. |
Checklist
| Risorsa | Scopo |
|---|---|
quality_checklist.md | Qualità e completezza. |
hipaa_compliance_checklist.md | De-identificazione HIPAA e consenso. |
Cosa viene usato come riferimento
La skill carica le seguenti riferimenti dalla directory references/:
| File di riferimento | Contenuto |
|---|---|
case_report_guidelines.md | Checklist CARE per report di caso. |
clinical_trial_reporting.md | ICH-E3 e struttura CSR/SAE/DSMB. |
diagnostic_reports_standards.md | Standard per report radiologia, patologia, laboratorio. |
patient_documentation.md | Convenzioni SOAP, H&P, dimissione, consulenza. |
data_presentation.md | Tabelle, figure, presentazione dati. |
medical_terminology.md | Terminologia, abbreviazioni, codifica (es. ICD-10). |
peer_review_standards.md | Revisione tra pari e requisiti delle riviste. |
regulatory_compliance.md | HIPAA, FDA, ICH-GCP (consenso, de-identificazione, sicurezza). |
Riferimenti concettuali: CARE, ICH E6(R3) GCP, ICH E3 (CSR), HIPAA (18 identificatori), lista “Do Not Use” JCAHO, FDA.
Quali controlli vengono eseguiti
La skill include un’estensione con sette strumenti:
1. validate_case_report
Valida i report di caso rispetto a CARE: sezioni richieste, controllo HIPAA rapido, conteggio parole, riferimenti. Output: PASS/NEEDS_REVISION, checklist CARE, avvisi HIPAA.
2. validate_trial_report
Valida i CSR rispetto alle sezioni ICH-E3 (frontespizio, sinossi, indice, abbreviazioni, etica, investigatori, introduzione, obiettivi, pazienti, efficacia, sicurezza, discussione, tabelle/figure, riferimenti, appendici). Output: percentuale di conformità e checklist sezioni.
3. check_deidentification
Cerca i 18 identificatori HIPAA (nomi, dati geografici, date, telefono, email, SSN, MRN, ecc.) e riporta gravità (CRITICAL/HIGH/MEDIUM) ed esempi. Verifica età >89 (aggregazione “90 o più”). Output: COMPLIANT / NEEDS_REVIEW / NON_COMPLIANT.
4. validate_terminology
Verifica abbreviazioni JCAHO Do Not Use (U, IU, QD, QOD, MS, MSO4, MgSO4) con sostituzioni suggerite, abbreviazioni ambigue (cc, hs, TIW, SC, D/C, OS, OD, OU, ecc.) e codici ICD-10.
5. check_compliance
Verifica indicatori HIPAA (consenso, de-identificazione), GCP (IRB/IEC, protocollo, consenso), FDA (IND/IDE/protocollo, eventi avversi/SAE). Output: OK/MISSING per punto di controllo.
6. extract_clinical_data
Estrae dati strutturati: demografia, parametri vitali (temp, PA, FC, FR, SpO2), farmaci (principio, dose, via, frequenza). Output: JSON.
7. format_adverse_events
Converte un CSV con colonne treatment_arm, any_ae, related, serious, fatal, discontinuation in una tabella riepilogativa Markdown per braccio di trattamento.
Quando eseguire cosa: Dopo la redazione di un report di caso, validate_case_report e check_deidentification; per CSR, validate_trial_report. Prima della finalizzazione, validate_terminology e check_compliance. Usare extract_clinical_data e format_adverse_events per dati strutturati o tabelle EA.
Riepilogo
| Argomento | Riepilogo |
|---|---|
| Contenuto della skill | Quattro categorie: report di caso (CARE), diagnostici, di studio (ICH-E3, SAE, CSR), documentazione paziente. Più HIPAA, terminologia e scientific-schematics opzionale. |
| Prompt | Redigere report; validare CARE/ICH-E3; verificare de-identificazione, terminologia, conformità; formattare CSV EA; estrarre dati clinici. |
| Struttura | Template per report di caso, CSR, SAE, SOAP, H&P, dimissione, consulenza, radiologia, patologia, laboratorio e checklist. |
| Riferimenti | Otto file di riferimento (CARE, ICH E3/E6, HIPAA, JCAHO, FDA). |
| Controlli | Sette strumenti: validate_case_report, validate_trial_report, check_deidentification, validate_terminology, check_compliance, extract_clinical_data, format_adverse_events. |
Usa la skill Clinical Report Writing quando devi redigere o validare documentazione clinica e vuoi che l’agente segua CARE, ICH-E3 e HIPAA con template, riferimenti e strumenti di validazione in un unico posto.