Shift Handover Summarizer

Generate structured shift handover summaries from EHR updates, highlighting critical events that occurred during the shift.

Clinical Disclaimer: This tool generates summaries for handover support only. All clinical decisions must be verified by qualified medical staff. Patient data must comply with applicable data protection regulations (e.g., HIPAA).

Quick Check

python -m py_compile scripts/main.py
python scripts/main.py --help

When to Use

• Use this skill when generating a structured handover summary from EHR records at the end of a clinical shift.
• Use this skill when prioritizing patients by event severity for incoming staff.
• Do not use this skill as a substitute for direct clinical handover, real-time patient assessment, or emergency triage.

Workflow

1. Confirm the patient records file, shift start/end times, and optional department filter.
2. Validate that the input records are within the declared shift time range.
3. Timezone validation: If --shift-start or --shift-end lacks a timezone offset (e.g., 2026-02-06T00:00:00 without Z or +HH:MM), emit a warning: "Shift times appear to lack a timezone offset. Assuming UTC. Specify timezone explicitly (e.g., 2026-02-06T00:00:00+08:00) to avoid incorrect event filtering."
4. Run the summarizer script or apply the manual extraction path.
5. Return a structured summary with patients ranked by priority, key events, and pending tasks.
6. If inputs are incomplete, state exactly which fields are missing and request only the minimum additional information.

Usage

python scripts/main.py \
  --records data/shift_records.json \
  --shift-start "2026-02-06T00:00:00Z" \
  --shift-end "2026-02-06T08:00:00Z" \
  --department "Cardiology" \
  --output summary.json

Parameters

Event Priority Levels

Output

• Shift summary with total patients and critical patient count
• Per-patient priority ranking, key events, vitals summary, medication summary, and pending tasks
• Plain-text handover narrative

Scope Boundaries