Male Fertility

Male Fertility Health Skill

Male fertility health tracking and management, including semen analysis records, hormone level monitoring, and infertility factor assessment.

Core Flow

User Input → Identify Operation Type → Parse Information → Check Completeness → Generate JSON → Save Data
                                     |
                              [Ask when information insufficient]

Step 1: Parse User Input

Operation Type Recognition

Semen Parameter Recognition

Hormone Recognition

Step 2: Check Information Completeness

Semen Analysis (semen)

• Required: At least one parameter value
• Optional: Abstinence period, test date

Hormone Levels (hormone)

• Required: Hormone type and value
• Optional: Measurement time, test date

Varicocele (varicocele)

• Required: Presence and location
• Optional: Grade, confirmation method

Reproductive Tract Infection (infection)

• Required: Pathogen and result
• Optional: Test date

Step 3: Interactive Prompts (If Needed)

Use consultation-style dialogue, friendly and natural questioning for missing information.

Question Scenarios

Scenario A: Semen Analysis Missing Parameters

Please provide specific semen analysis parameters, such as:
- Volume (mL)
- Concentration (10^6/mL)
- Motility (PR/NP percentage)
- Morphology (normal形态%)

Scenario B: Hormone Test Missing Type

Which hormone test result is this?
Options: Testosterone, LH, FSH, Prolactin, Estradiol

Step 4: Generate JSON

Semen Analysis Data Structure

{
  "record_type": "semen_analysis",
  "date": "2025-06-20",
  "abstinence_period": "3_days",
  "volume": {
    "value": 2.5,
    "unit": "mL",
    "reference": ">=1.5",
    "result": "normal"
  },
  "concentration": {
    "value": 45,
    "unit": "10^6/mL",
    "reference": ">=15",
    "result": "normal"
  },
  "total_count": {
    "value": 112.5,
    "unit": "10^6",
    "reference": ">=39",
    "result": "normal"
  },
  "motility": {
    "pr": {"value": 35, "reference": ">=32", "result": "normal"},
    "np": {"value": 20, "reference": ">=40", "result": "normal"}
  },
  "morphology": {
    "value": 4,
    "unit": "%",
    "reference": ">=4",
    "result": "normal"
  },
  "ph": {
    "value": 7.5,
    "reference": "7.2-8.0",
    "result": "normal"
  },
  "liquefaction": {
    "value": 30,
    "unit": "minutes",
    "reference": "<=60",
    "result": "normal"
  },
  "diagnosis": "normospermia"
}

Hormone Data Structure

{
  "record_type": "hormone_test",
  "date": "2025-06-15",
  "testosterone": {
    "total": 15.5,
    "reference": "10-35",
    "unit": "nmol/L",
    "result": "normal"
  },
  "lh": {
    "value": 5.2,
    "reference": "1.7-8.6",
    "unit": "IU/L",
    "result": "normal"
  },
  "fsh": {
    "value": 8.1,
    "reference": "1.5-12.4",
    "unit": "IU/L",
    "result": "normal"
  },
  "prl": {
    "value": 12.5,
    "reference": "<15",
    "unit": "ng/mL",
    "result": "normal"
  },
  "e2": {
    "value": 35,
    "reference": "<70",
    "unit": "pg/mL",
    "result": "normal"
  }
}

Complete schema definition: see schema.json.

Step 5: Save Data

1. Generate record ID: fertility_YYYYMMDD_XXX
2. Save to data/生育记录/YYYY-MM/YYYY-MM-DD_精液分析.json
3. Update data/fertility-tracker.json
4. Update data/index.json

Semen Analysis Standards (WHO 2021)

Diagnosis Classification

Execution Instructions

1. Identify operation type (semen/hormone/varicocele/infection/status/diagnosis)
2. Parse input parameters, extract all available information
3. Check required fields, ask user if missing
4. Evaluate results against WHO standards
5. Generate JSON compliant with schema.json
6. Save to appropriate file path
7. Confirm save to user and display summary and recommendations

Example Interactions

Example 1: Record Semen Analysis

User: 精液分析 精液量2.5ml 密度45 前向35% 形态4%
AI: 解析中...
    Volume: 2.5 mL ✓ Normal
    Concentration: 45 x 10^6/mL ✓ Normal
    Progressive motility: 35% ✓ Normal
    Morphology: 4% ✓ Normal

    Diagnosis: Normospermia

    Saved to: data/生育记录/2025-06/2025-06-20_精液分析.json

Example 2: Record Hormone Levels

User: 激素检测 睾酮15.5 LH5.2 FSH8.1
AI: Record hormone test results:

    Testosterone: 15.5 nmol/L ✓ Normal (reference: 10-35)
    LH: 5.2 IU/L ✓ Normal (reference: 1.7-8.6)
    FSH: 8.1 IU/L ✓ Normal (reference: 1.5-12.4)

    Assessment: Hormone levels normal, HPTA axis function normal

    Saved to: data/生育记录/2025-06/2025-06-15_激素检测.json

Example 3: View Status

User: 生育状态
AI: Male fertility health status

    Semen analysis: Normal (last test: 2025-06-20)
    Hormone levels: Normal (last test: 2025-06-15)
    Varicocele: None
    Reproductive tract infection: Negative

    Comprehensive Assessment: Normal fertility function

    Recommendation: Continue trying natural conception, maintain healthy lifestyle

For more examples, see examples.md.

Important Notice

• This system is for fertility health tracking only, cannot replace professional medical diagnosis
• Semen analysis requires 2-3 confirmations
• Abstinence 3-7 days before testing
• Infertility assessment requires both partners to be checked
• All data is stored locally only

Seek Immediate Medical Care For

• Azoospermia
• Significantly abnormal hormones
• Grade III varicocele
• Positive reproductive tract infection