Copd

COPD Management Skill

Long-term management of Chronic Obstructie Pulmonary Disease (COPD), including lung function monitoring, symptom assessment, and exacerbation prevention.

Core Flow

User Input -> Identify Operation Type -> Extract Parameter Info -> Check Completeness -> [Need Supplement] Ask User
                                                      |
                                                   [Information Complete]
                                                      |
                                              Generate JSON -> Save Data -> Output Confirmation

Step 1: Parse User Input

Operation Type Recognition

Lung Function Keywords Mapping

Symptom Type Keywords

Sputum Color Keywords

Sputum Volume Keywords

Exacerbation Severity

Exacerbation Triggers

Step 2: Check Information Completeness

Lung Function Record Required:

• FEV1 value (L)

CAT Score Required:

• Total score (0-40 points)

mMRC Score Required:

• Grade (0-4 level)

Symptom Record Required:

• Symptom type
• Severity or description

Exacerbation Record Required:

• Severity (mild/moderate/severe)

Step 3: Interactive Prompts (If Needed)

Scenario A: Incomplete Lung Function Values

Please provide complete lung function data:
- FEV1 value (L)
- FEV1 percent predicted (%)
- FVC value (L) [optional]
- FEV1/FVC ratio [optional]

Scenario B: Missing CAT Score

Please perform CAT scoring (each item 0-5 points):
1. Cough
2. Sputum
3. Chest tightness
4. Shortness of breath climbing stairs
5. Limitation in housework activities
6. Confidence in outdoor activities
7. Sleep quality
8. Energy level

Or enter total score directly (0-40 points)

Scenario C: Missing mMRC Grade

Please select mMRC grade (0-4):
Grade 0 - Only shortness of breath during strenuous exercise
Grade 1 - Shortness of breath when walking fast or climbing incline
Grade 2 - Walk slower than peers or need to stop to catch breath
Grade 3 - Need to stop after 100m or few minutes
Grade 4 - Severe shortness of breath, cannot leave home

Step 4: Generate JSON

Lung Function Record

{
  "date": "2025-06-10",
  "post_bronchodilator": {
    "fev1": 1.8,
    "fev1_percent_predicted": 65,
    "fvc": 3.2,
    "fev1_fvc_ratio": 0.56
  },
  "gold_grade": "Grade 2",
  "interpretation": "Moderate airflow limitation"
}

CAT Score Record

{
  "date": "2025-06-20",
  "total_score": 18,
  "max_score": 40,
  "interpretation": "Moderate symptom impact",
  "impact_level": "Medium",
  "items": {
    "cough": 2,
    "sputum": 2,
    "chest_tightness": 2,
    "breathlessness_climbing": 3,
    "activity_limitation": 2,
    "confidence_outdoors": 2,
    "sleep": 3,
    "energy": 2
  }
}

Exacerbation Record

{
  "id": "exace_20250215000000001",
  "date": "2025-02-15",
  "severity": "moderate",
  "triggers": ["viral_infection"],
  "symptoms": ["increased_dyspnea", "purulent_sputum"],
  "treatment": ["antibiotics", "prednisone"],
  "hospitalized": false,
  "recovery_days": 10
}

Complete schema definition: see schema.json.

Step 5: Save Data

1. Read data/copd-tracker.json
2. Update corresponding sections based on operation type
3. Update statistics
4. Write back to file

Execution Instructions

1. Identify operation type (fev1/cat/mmrc/symptom/exacerbation/medication/vaccine/status/assessment)
2. Extract parameter information
3. Check required field completeness
4. If missing, ask user to supplement
5. Generate JSON compliant with schema.json
6. Save to data/copd-tracker.json
7. Output confirmation and medical recommendations

Example Interactions

Example 1: Lung Function Record

User: fev1 1.8 65%

AI: Lung function test result recorded
FEV1: 1.8 L (65% predicted)
GOLD Grade: Grade 2 (moderate)
Interpretation: Moderate airflow limitation

Recommendation: Regular lung function recheck, at least once a year

Example 2: CAT Score

User: cat score 18

AI: CAT score recorded
Total score: 18/40
Impact: Moderate impact
Grade: Medium

Symptom control needs improvement, consult doctor for treatment adjustment

Example 3: Exacerbation Record

User: exacerbation moderate viral_infection

AI: Exacerbation event recorded
Date: 2025-06-20
Severity: Moderate
Trigger: Viral infection

This is the 1st exacerbation this year

If symptoms continue to worsen for more than 3 days, seek medical attention

Example 4: View Status

User: copd status

AI: COPD Control Status Report
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GOLD Grade: Grade 2 (moderate)
Symptom assessment: CAT 18 (moderate impact)
Lung function: FEV1 1.8L (65%)

Exacerbations: 1 this year (last: 2025-02-15)
Medication: Tiotropium 18μg qd
Vaccination: Flu vaccine (2024-10), Pneumonia vaccine (2023-05)

Control Evaluation: Symptom control suboptimal, recommend optimizing treatment

For more examples, see examples.md.

Medical Safety Boundaries

Cannot Do:

• Provide specific medication dosage adjustment recommendations
• Directly prescribe or recommend specific medications
• Replace doctor's diagnosis and treatment decisions
• Predict disease prognosis or rate of lung function decline

Can Do:

• Provide lung function monitoring records and trend analysis
• Provide symptom scoring and assessment (CAT, mMRC)
• Provide exacerbation records and trigger tracking
• Provide medication reminders and vaccination reminders
• Provide lifestyle recommendations and medical visit reminders

Emergency Medical Indications:

• Significantly worsened dyspnea, unrelieved by rest
• Purple lips or fingernails (cyanosis)
• Confusion, drowsiness, or coma
• Chest pain, suspected myocardial infarction or pneumothorax