--- name: male-fertility description: Male fertility health tracking including semen analysis, hormone monitoring, and infertility assessment argument-hint: allowed-tools: Read, Write schema: male-fertility/schema.json --- # 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 | Input Keywords | Operation | |----------------|-----------| | semen | Semen analysis | | hormone | Hormone levels | | varicocele | Varicocele | | infection | Reproductive tract infection | | status | View status | | diagnosis | View diagnosis | ### Semen Parameter Recognition | Parameter | Keywords | Extract | |-----------|----------|--------| | Volume | volume, ml | Number + mL | | Concentration | concentration, 10^6/mL | Number | | Progressive motility | pr, progressive | Percentage | | Non-progressive motility | np | Percentage | | Morphology | morphology, % | Percentage | | pH | ph | 7.0-8.0 | ### Hormone Recognition | Hormone | Keywords | Unit | |---------|----------|------| | Testosterone | testosterone, T | nmol/L | | LH | LH | IU/L | | FSH | FSH | IU/L | | Prolactin | PRL | ng/mL | | Estradiol | E2 | pg/mL | ## 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 ```json { "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 ```json { "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](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) | Parameter | Normal | Abnormal | |-----------|--------|----------| | Volume | >= 1.5 mL | < 1.5 mL (hypospermia) | | Concentration | >= 15 x 10^6/mL | < 15 (oligozoospermia) | | Total count | >= 39 x 10^6 | < 39 | | PR (progressive) | >= 32% | < 32% (asthenozoospermia) | | NP (total) | >= 40% | < 40% | | Normal morphology | >= 4% | < 4% (teratozoospermia) | | pH | 7.2-8.0 | < 7.2 or > 8.0 | | Liquefaction time | <= 60 minutes | > 60 minutes | ## Diagnosis Classification | Result | Diagnosis | |--------|----------| | All parameters normal | Normal semen (normospermia) | | Concentration < 15 | Oligozoospermia | | Concentration = 0 | Azoospermia | | PR < 32% | Asthenozoospermia | | Normal morphology < 4% | Teratozoospermia | | Volume < 1.5mL | Hypospermia | | Multiple abnormalities | Mixed abnormalities | ## 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](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