cancer-buddy-education

name: cancer-buddy-education description: "从 MTB 报告和患者档案生成患者友好的宣教手册（含 Mermaid 机制图的 Markdown），包含速查卡、大白话健康摘要、带副作用管理的药物单、日常生活指南、复诊安排、费用/医保导航、分阶段 FAQ；吸收了 vmtb-patient-education 的机制图、癌种模块和按阶段组织的 FAQ。Use when 患者有 profile.json + 至少一份 MTB 报告（lite 或 full），需要把临床报告转成患者和家属能日常使用的材料。Triggers on: 宣教手册, 给我爸妈看的版本, 我爸妈看不懂报告, patient handbook, 患者教育." license: MIT metadata: author: CancerDAO version: "0.2.0" tags: patient-education oncology handbook mermaid caregiver health-literacy

Turn clinical output into something the patient (and their family) can actually use day to day.

When to use

Patient has at least profile.json + one MTB report (lite or full).
Patient says: 宣教手册 / 给我爸妈看的版本 / 我爸妈看不懂报告 / patient handbook.

Preflight

Run ../../references/preflight.md — role + disclosure + readiness grade + review_flags red gate (Step 2.5) + schema validity. The handbook propagates upstream extracted facts (diagnosis, stage, current_therapy, molecular_drivers, treatment_history) directly to the patient/caregiver as authoritative-sounding educational content; an unconfirmed 🔴 RED review_flag on any of those fields makes the resulting handbook misleading. Block until resolved.

Inputs

patients/<pid>/profile.json
MTB report: prefer patients/<pid>/reports/mtb-full/ if exists; fallback to patients/<pid>/reports/mtb-lite/.
Treatment timeline, comorbidities, current medications.

Output

Written under patients/<pid>/reports/education/:

<pid>_<date>_患者教育手册.md — main handbook
quick-reference-card.md — one-pager with emergency info and key contacts
drug-sheets/<drug>.md — per-drug handout (mechanism, dose, side effects, when to call the doctor)

Workflow

See references/handbook-template.md for the full template. Main steps:

Read MTB report (full preferred, lite fallback).
Extract: treatment plan, drug list, monitoring schedule, comorbidity interactions.
Select relevant handbook chapters based on patient's condition (skip chemotherapy chapter if immunotherapy only, include diabetes chapter if comorbid T2DM, etc.).
- Mechanism diagrams: pull relevant diagrams from references/mechanism-diagrams.md based on patient's current_therapy type (chemo / targeted / immuno / radio).
- Cancer-type module: include the patient's primary cancer section from references/cancer-type-modules.md.
- FAQ: pull phase-relevant questions from references/expanded-faq.md based on current therapy phase (newly-diagnosed / active-treatment / survivorship).
Render in Markdown with:
- Cover page (name, patient_code, date, physician contact)
- Quick reference card (emergency phone, ER criteria — fever > 38.5°C, new bleeding, etc.)
- My Health Summary (1 page, plain language)
- Per-drug sheets (what it does, how to take, side-effect watchlist)
- Daily living guide (nutrition placeholder → full version in v2 nutrition skill, exercise, sleep, work)
- Follow-up schedule (若装有 pro-skill 的 manage 模块；否则用通用复诊模板)
- Cost and insurance navigation (generic drug-access / 医保 section; for full expanded-access pathways see the pro-skill access module if installed)
- FAQ (common patient questions grouped by disease stage)
Embed Mermaid diagrams: disease-mechanism flow, treatment-decision tree.

Tone

Warm, direct, practical. Talk like a friend with medical knowledge.
Every medical term bilingual + plain explanation (see terminology.md).
Section-end: "你家里有人能帮你执行这一段吗？不行的话，搭子可以帮你安排提醒。"

Safety

Apply safety-guardrails.md rules:

Mandatory footer on every handbook, quick-reference card, and drug sheet: 本手册为信息参考，任何治疗调整必须与主诊医生确认。
No medical recommendations — explain what drugs / tests / side-effects are, never instruct the patient to change dose, stop a drug, or skip a visit without clinician sign-off.
ER criteria are absolute — fever > 38.5°C, new bleeding, severe dyspnea, altered mental status → 立即就医，不要等门诊.

Role behavior

Role = patient: patient self-study handbook. 1st-person, includes my-health-summary, drug sheets, daily living guide.
- Disclosure: disclosure_state=suppressed → refuse patient handbook; offer general health content only.
Role = caregiver: caregiver operator manual. Same structure but reframed: "你陪 Ta 做化疗当天需要准备…", "Ta 的化疗药清单 + 你该留意的红旗症状", "如果你是一个人陪诊的话…". Add a ## 你的自我照顾 chapter (1 page).
Role = family: 2-page 亲友简报. Disease name + plain-language explanation, current treatment phase, one-sentence prognosis, "你能帮上的三件事", "请不要做的三件事"（不问"还有多久"、不提新的偏方、不比较其他癌友）.

References

handbook-template.md — full template
mechanism-diagrams.md — disease mechanism Mermaid diagrams (absorbed from vmtb-patient-education)
cancer-type-modules.md — per-cancer-type patient modules
expanded-faq.md — FAQ organized by treatment phase
../../references/terminology.md
../../references/safety-guardrails.md