AgentSkillsCN

esc-guidelines-query

通过自动从目录（TOC）中定位相关 PDF 并提取引用答案，快速查询欧洲心脏病学会（ESC）指南。在依据 ESC 的官方建议解答心血管疾病相关的临床问题时，此功能尤为实用。

SKILL.md
--- frontmatter
name: esc-guidelines-query
description: Query ESC (European Society of Cardiology) Guidelines by automatically locating the relevant PDF from the TOC and extracting cited answers. Use when answering clinical questions about cardiovascular diseases based on official ESC recommendations.

ESC Guidelines Query System

Expert system for querying ESC Guidelines with automatic PDF location and citation extraction.

When to Use This Skill

  • •Answering clinical cardiovascular questions
  • •Finding ESC recommendations on specific conditions
  • •Extracting diagnostic or therapeutic guidelines
  • •Locating specific ESC criteria or thresholds
  • •Comparing recommendations across different ESC guidelines
  • •Verifying treatment protocols against ESC standards

Core Workflow

This skill implements a 3-phase intelligent retrieval system:

Phase 1: TOC Analysis (Locate)

Goal: Identify which ESC guideline PDF contains the relevant information

Process:

  1. •Read the master index: ESC_GUIDELINES_TOC.md
  2. •Analyze the user's clinical question to extract:
    • •Medical condition (e.g., "aortic aneurysm", "atrial fibrillation")
    • •Specific aspect (e.g., "imaging", "treatment threshold", "follow-up")
    • •Clinical context (e.g., "45mm diameter", "pregnancy", "diabetes")
  3. •Search the TOC using Grep with relevant keywords
  4. •Identify the specific PDF file and page/section numbers

Example TOC Analysis:

markdown
User Question: "Si deve fare TAC se uno ha 45mm di aortic root?"

Keywords to search: aortic root, imaging, CT, TAC, surveillance, thoracic aorta, 45mm

TOC Result:
- File: 2024_Peripheral_Arterial_Aortic.pdf
- Section: 9.2.2 Thoracic aortic aneurysms (p. 66)
- Subsection: 9.2.2.4 Surveillance (p. 70)
- Imaging section: 5.4 Evaluation of the aorta (p. 25)

Phase 2: PDF Extraction (Read)

Goal: Read the specific sections from the identified PDF

Process:

  1. •Open the PDF file identified in Phase 1
  2. •Navigate to the specific sections/pages from the TOC
  3. •Extract relevant content including:
    • •Recommendations (with class/level of evidence)
    • •Diagnostic criteria
    • •Threshold values
    • •Imaging protocols
    • •Follow-up schedules
  4. •Capture exact quotes for citation

Reading Strategy:

markdown
Priority reading order:
1. Main section related to the question
2. Imaging/diagnostic section if relevant
3. Management/treatment section
4. Surveillance/follow-up section
5. Special populations section if applicable

Phase 3: Answer Synthesis (Cite)

Goal: Provide accurate answer with proper citations

Required Elements:

  1. •✅ Direct answer to the user's question
  2. •✅ ESC Recommendation (Class I/IIa/IIb/III, Level A/B/C)
  3. •✅ Exact citation (PDF file, section, page number)
  4. •✅ Clinical context (thresholds, conditions, exceptions)
  5. •✅ Related information (surveillance intervals, imaging modality choice)

Citation Format:

markdown
**ESC Recommendation** [Class I, Level B]:
"[Exact quote from PDF]"

**Source**: [2024_Peripheral_Arterial_Aortic.pdf] - Section 9.2.2.4 (p. 70)

Implementation Protocol

Step-by-Step Execution

markdown
## Phase 1: Locate (TOC Analysis)

1. **Parse User Question**
   - Extract: condition, aspect, context
   - Identify: relevant keywords for search

2. **Search TOC**
   ```bash
   Grep pattern: [keywords from question]
   File: ESC_GUIDELINES_TOC.md
   Mode: content with context
  1. •Identify Target PDF
    • •PDF filename: [extracted from TOC]
    • •Section numbers: [from TOC structure]
    • •Page numbers: [from TOC annotations]

Phase 2: Read (PDF Extraction)

  1. •

    Open Target PDF

    bash
    Read: references/esc-guidelines/[PDF_filename].pdf
Focus: Sections identified in Phase 1
  2. •

    Extract Relevant Content

    • •Recommendations boxes/tables
    • •Diagnostic criteria
    • •Threshold values
    • •Imaging protocols
    • •Follow-up schedules
  3. •

    Capture Exact Quotes

    • •Copy verbatim text for citations
    • •Note recommendation class/level
    • •Record page numbers

Phase 3: Cite (Answer Synthesis)

  1. •

    Structure Answer

    • •Direct response to question
    • •ESC recommendation with class/level
    • •Exact citation with source
    • •Clinical context and nuances
  2. •

    Format Output

    • •Use markdown for clarity
    • •Include tables if comparing options
    • •Link to PDF file
    • •Provide page references
code

## Output Template

```markdown
# [Clinical Question]

## ESC Recommendation

**[Recommendation Class & Level]**: [Brief summary]

"[Exact quote from ESC Guidelines]"

## Clinical Context

- **Threshold/Criteria**: [Specific values]
- **Imaging Modality**: [Recommended method]
- **Surveillance**: [Follow-up interval]
- **Special Considerations**: [Risk factors, comorbidities]

## When to [Action]

| Condition | Recommendation | Evidence |
|-----------|----------------|----------|
| [Scenario 1] | [Action] | Class [X], Level [Y] |
| [Scenario 2] | [Action] | Class [X], Level [Y] |

## Source Citation

**PDF**: [[PDF_filename].pdf](references/esc-guidelines/[PDF_filename].pdf)
**Section**: [Section number and title]
**Pages**: [Page numbers]

## Additional Recommendations

[Related information from the same guideline]

Example Query Execution

User Question

"Si deve fare TAC se uno ha 45mm di aortic root?"

Phase 1: Locate

bash
# Search TOC
Grep: "aortic root|imaging|CT|TAC|thoracic.*aneurysm|surveillance"
File: ESC_GUIDELINES_TOC.md

# Result
PDF: 2024_Peripheral_Arterial_Aortic.pdf
Sections:
- 5.4 Evaluation of the aorta (p. 25)
  - 5.4.6 Cardiovascular computed tomography (p. 29)
- 9.2.2 Thoracic aortic aneurysms (p. 66)
  - 9.2.2.4 Surveillance (p. 70)

Phase 2: Read

bash
# Open PDF
Read: references/esc-guidelines/2024_Peripheral_Arterial_Aortic.pdf

# Extract from Section 5.4.6 (p. 29)
"CT angiography is the gold standard for aortic imaging..."

# Extract from Section 9.2.2.4 (p. 70)
"Surveillance with CT or MRI is recommended when aortic diameter is ≥45mm..."
[Recommendation Class I, Level B]

Phase 3: Cite

markdown
# Imaging per Aortic Root di 45mm

## ESC Recommendation

**Class I, Level B**: La sorveglianza con TC o RM è raccomandata quando il diametro aortico è ≥45mm.

"Surveillance imaging with CT or MRI is recommended when the aortic root diameter reaches 45mm or greater, with annual follow-up for diameters 45-49mm."

## Clinical Context

- **Threshold**: ≥45mm richiede imaging di conferma e sorveglianza
- **Imaging Modality**: TC angiografia (gold standard) o RM cardiovascolare
- **Surveillance Interval**: Annuale per 45-49mm
- **Surgery Threshold**: ≥50-55mm (salvo fattori di rischio)

## Indicazioni Specifiche per TC

| Condizione | Raccomandazione | Classe/Livello |
|------------|-----------------|----------------|
| Prima misurazione ≥45mm | TC o RM per conferma | Class I, Level C |
| Follow-up annuale | TC o RM | Class I, Level B |
| Valvola bicuspide + ≥45mm | TC annuale | Class I, Level B |
| Marfan + ≥45mm | TC ogni 6-12 mesi | Class I, Level C |

## Source Citation

**PDF**: [2024_Peripheral_Arterial_Aortic.pdf](references/esc-guidelines/2024_Peripheral_Arterial_Aortic.pdf)
**Sections**:
- 5.4.6 Cardiovascular computed tomography (p. 29)
- 9.2.2.4 Surveillance (p. 70)

## Additional Recommendations

- La TC senza contrasto può essere sufficiente per follow-up dimensionale
- La RM è preferibile in pazienti giovani per ridurre esposizione radiante
- L'ecocardiogramma può essere usato per screening ma non per decisioni chirurgiche

Best Practices

1. Keyword Selection

  • •Use medical synonyms (e.g., "myocardial infarction" = "MI" = "heart attack")
  • •Include Italian and English terms
  • •Search for abbreviations (e.g., "AF" for atrial fibrillation)

2. TOC Navigation

  • •Start with broad section search (e.g., "aorta", "arrhythmia")
  • •Narrow to specific subsections (e.g., "surveillance", "imaging")
  • •Check multiple related sections (diagnosis, treatment, follow-up)

3. PDF Reading

  • •Read tables first - often contain key recommendations
  • •Look for highlighted boxes - ESC recommendations are emphasized
  • •Check figures/algorithms - provide decision pathways
  • •Don't skip page headers - confirm you're in the right section

4. Citation Accuracy

  • •Quote exactly - don't paraphrase recommendations
  • •Include class/level - essential for clinical decision-making
  • •Provide page numbers - for user verification
  • •Link to PDF - enable direct access

5. Clinical Context

  • •Mention patient-specific factors (age, comorbidities)
  • •Note variations by condition (bicuspid valve, Marfan syndrome)
  • •Include surveillance schedules - not just one-time recommendations
  • •Highlight contraindications or special considerations

Common Pitfalls to Avoid

❌ Don't:

  • •Rely on TOC alone without reading the PDF
  • •Paraphrase recommendations (lose precision)
  • •Omit class/level of evidence
  • •Ignore special populations sections
  • •Miss related sections (e.g., imaging section when answering treatment question)

✅ Do:

  • •Cross-reference multiple sections
  • •Extract exact quotes
  • •Include all relevant thresholds
  • •Mention alternative approaches
  • •Cite page numbers for verification

Performance Optimization

Efficient TOC Search

bash
# Use multiple keywords with OR
Grep: "aortic root|radice aortica|ascending aorta"

# Include Italian medical terms
Grep: "scompenso|insufficienza|ipertensione"

# Search for diagnostic terms
Grep: "imaging|CT|TAC|eco|RM|angio"

Parallel Reading

When question involves multiple aspects:

  1. •Read diagnostic section (Phase 2a)
  2. •Read treatment section (Phase 2b)
  3. •Read surveillance section (Phase 2c)
  4. •Synthesize all in Phase 3

Smart Caching

  • •Remember frequently accessed PDFs (e.g., 2024 guidelines)
  • •Note common sections for quick reference
  • •Build mental map of TOC structure

Advanced Query Patterns

Pattern 1: Comparative Questions

"Quale imaging è meglio per aneurisma aortico, TC o RM?"

Strategy:

  1. •Locate imaging section in TOC
  2. •Read both CT and MRI subsections
  3. •Create comparison table with recommendations
  4. •Cite both sections

Pattern 2: Threshold Questions

"A che diametro si opera l'aorta ascendente?"

Strategy:

  1. •Locate surgical management section
  2. •Extract all threshold values
  3. •Note variations by condition
  4. •Present as structured table

Pattern 3: Special Population Questions

"Come gestire aneurisma aortico in gravidanza?"

Strategy:

  1. •Search TOC for "pregnancy" or "gravidanza"
  2. •Check both main section + pregnancy subsection
  3. •Extract pregnancy-specific recommendations
  4. •Note differences from general population

Pattern 4: Multi-guideline Questions

"Le linee guida 2024 cambiano il management dell'aorta rispetto al 2020?"

Strategy:

  1. •Locate same section in both TOCs
  2. •Read both PDFs in parallel
  3. •Create "What's new" comparison
  4. •Cite both guidelines with year

Quality Checklist

Before delivering answer, verify:

  • • TOC was searched with comprehensive keywords
  • • Correct PDF was identified and opened
  • • Relevant sections were fully read (not just skimmed)
  • • Exact quotes were extracted (not paraphrased)
  • • Recommendation class and level are included
  • • Page numbers are accurate
  • • PDF filename and section are cited
  • • Clinical context is provided (thresholds, intervals)
  • • Special populations are mentioned if relevant
  • • Related recommendations are included
  • • Answer directly addresses user's question

Resources

  • •Primary Source: ESC_GUIDELINES_TOC.md (Master index of all ESC guidelines)
  • •PDF Repository: references/esc-guidelines/ (All ESC guideline PDFs)
  • •Available Guidelines:
    • •2024: Atrial Fibrillation, Chronic Coronary Syndromes, Hypertension, Peripheral Arterial & Aortic
    • •2023: Acute Coronary Syndromes, Cardiomyopathies, CVD & Diabetes
    • •2022: Cardio-oncology, Valvular Heart Disease
    • •2021: Heart Failure, Pacing & CRT
    • •2020: Adult Congenital Heart Disease, Sports Cardiology

Example Queries to Practice

  1. •"Quali sono le indicazioni ESC per impianto ICD nella cardiomiopatia dilatativa?"
  2. •"A che frazione di eiezione si considera scompenso cardiaco con FE ridotta?"
  3. •"Quali anticoagulanti sono raccomandati in fibrillazione atriale con CHA2DS2-VASc ≥2?"
  4. •"Quando si fa PCI vs CABG nella malattia coronarica cronica?"
  5. •"Come gestire ipertensione in paziente con diabete secondo ESC 2024?"

Activation Prompt

When user asks a clinical question about cardiovascular disease:

  1. •Activate this skill automatically
  2. •Execute Phase 1: Search TOC for relevant PDF
  3. •Execute Phase 2: Read identified PDF sections
  4. •Execute Phase 3: Synthesize answer with exact citations

Remember: The goal is to provide evidence-based answers directly from ESC Guidelines, not general medical knowledge. Always cite the source with precision.