medication

name	medication
description	Manage medication plans and track medication adherence with allergy checks, pregnancy safety warnings, and drug interaction detection.
argument-hint	<operation_type(add/log/list/history/status) medication_description_natural_language>
allowed-tools	Read, Write
schema	medication/schema.json

Medication Management Skill

Manage medications and medication plans, record daily medication intake, and track medication adherence.

Core Flow

User Input -> Parse Operation Type -> [add] Parse Medication Info -> Allergy Check -> Pregnancy Safety Check -> Drug Interaction Check -> Save
                             -> [log] Record Medication Status -> Save
                             -> [list] Display Medication List
                             -> [history] Display History
                             -> [status] Display Statistics

Step 1: Parse User Input

Operation Type Recognition

Input Keywords	Operation
add	add
log	log
list	list
history	history
status	status

Step 2: Add Medication (add)

Medication Information Parsing

Extract from natural language:

• Medication Name: Generic name or brand name
• Dosage: Value + unit (mg, g, ml, IU, tablets, etc.)
• Frequency: Times per day, times per week, etc.
• Medication Time: Specific medication time points
• Special Instructions: Before meals, after meals, before bed, etc.

Frequency Mapping Rules

User Input	Frequency Type	Schedule Record Count
每天1次, 每日1次	daily	7 entries
每天2次, 早晚各一次	daily	14 entries
每天3次, 一日三次	daily	21 entries
每周1次	weekly	1 entry
隔天1次	every_other_day	4 entries
按需	as_needed	0 entries

Time Mapping Rules

User Input	Standard Time
早餐前	07:00
早餐后	08:00
午餐前	11:30
午餐后	12:30
晚餐前	17:30
晚餐后	18:30
睡前	21:00
早晚	08:00, 20:00

Step 3: Safety Checks

3.1 Medication Allergy Check

Check data/allergies.json for related allergies.

Common Drug Family Mapping:

Drug Category	Includes Drugs
Penicillins	Penicillin, Amoxicillin, Ampicillin, Mezlocillin, etc.
Cephalosporins	Cefazolin, Cefixime, Ceftriaxone, etc.
Sulfonamides	Sulfamethoxazole, Sulfadiazine, etc.
NSAIDs	Aspirin, Ibuprofen, Diclofenac, etc.

3.2 Pregnancy Safety Check

Check data/pregnancy-tracker.json and drug pregnancy categories.

Pregnancy Category	Description	Risk
A	Safe	Lowest
B	Relatively Safe	Low
C	Use with Caution	Moderate
D	Contraindicated	High
X	Absolutely Contraindicated	Very High

3.3 Drug Interaction Check

Check for interactions with current medications, classified by severity (A/B/C/D/X).

Step 4: Generate JSON

{
  "id": "med_20251231123456789",
  "name": "Aspirin",
  "generic_name": "Aspirin",
  "dosage": {
    "value": 100,
    "unit": "mg"
  },
  "frequency": {
    "type": "daily",
    "times_per_day": 1
  },
  "schedule": [
    {
      "weekday": 1,
      "time": "08:00",
      "timing_label": "After Breakfast",
      "dose": {"value": 100, "unit": "mg"}
    }
  ],
  "instructions": "Take after breakfast",
  "active": true
}

Step 5: Save Data

File path: data/medications/medications.json

Step 6: Record Medication (log)

Medication Status Recognition

Taken Keywords	Missed Keywords
已服用, 已服, 服了	忘记, 漏服, 未服

Record Data Structure

{
  "date": "2025-12-31",
  "logs": [
    {
      "id": "log_20251231080000001",
      "medication_id": "med_xxx",
      "medication_name": "Aspirin",
      "scheduled_time": "08:00",
      "actual_time": "2025-12-31T08:15:00",
      "status": "taken",
      "dose": {"value": 100, "unit": "mg"}
    }
  ]
}

File path: data/medication-logs/YYYY-MM/YYYY-MM-DD.json

Step 7: Adherence Calculation

Adherence Percentage = (Actual Doses Taken / Planned Doses) x 100%

Grade	Range
Excellent	>= 90%
Good	70-89%
Needs Improvement	< 70%

Execution Instructions

1. Parse operation type
2. [add] Parse medication info -> Safety checks -> Generate schedule -> Save
3. [log] Record medication status -> Save to log file
4. [list] Read medication list -> Format display
5. [history] Read log files -> Display by time
6. [status] Calculate adherence -> Display statistics

Example Interactions

Add Medication

User: Aspirin 100mg once daily after breakfast
-> Allergy check -> Safety check -> Save

Record Medication

User: Already took Aspirin
-> Record status taken

Missed Dose

User: Forgot to take Amlodipine
-> Record status missed, display make-up recommendation

View List

User: View medication list
-> Display all active medications and schedules