# 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.

Author: map[bio:Rakenne Team name:Rakenne]
Published: 2026-02-18
Tags: Sanità, Report clinici, CARE, HIPAA, Skills
URL: https://rakenne.app/it/learn/tutorials/clinical-reports-skill-guide/index.md


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:

1. **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.
2. **Report diagnostici** — Struttura di report di radiologia, patologia e laboratorio (indicazione clinica, tecnica, confronto, reperti, impressione).
3. **Report di studi clinici** — Clinical Study Report (CSR) secondo ICH-E3; report SAE; riepiloghi in stile DSMB.
4. **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.


---

Back to [Tutorial](https://rakenne.app/it/learn/tutorials/index.md)