When to Use This Skill

Activate this skill when any of the following conditions are met:

The user sends a PDF link of a checkup report and asks to analyze or interpret it
The user provides local files (PDF or images) of a checkup report and asks to analyze them
The user says things like "help me analyze my checkup report", "look at my health report", "interpret this medical report", or similar requests (in any language)
The user mentions checkup report analysis needs and provides a PDF URL or local file paths

Note: This skill supports both publicly accessible PDF URLs and local file uploads (PDF and images). The most common usage scenario is uploading local files via binary stream (--file), as users typically have report files saved on their device rather than hosted at a public URL.

How to choose (mutually exclusive — pick one):

If the user provides a local file path (e.g. /home/user/report.pdf, C:\Users\...\report.pdf, or relative path) → use --file (binary upload). This is the primary and most common usage.
If the user provides a URL (starts with http:// or https://) → use --url
Do NOT use --url and --file together in one command

⚠️ Privacy Warning

IMPORTANT - READ BEFORE INSTALLING:

This skill uploads your checkup report to WiseDiag's cloud servers (via PDF URL or direct binary file upload) for AI-powered health analysis.

Do NOT use with sensitive or confidential medical documents unless:

You trust WiseDiag's data handling policies
You accept that file contents will be transmitted and processed remotely

For sensitive documents, use offline/local checkup report analysis tools instead.

WiseAnalyze Skill (powered by WiseDiag)

An AI-powered medical checkup report analysis tool. Submit a checkup report (via local file upload or publicly accessible PDF URL), and the system will return a structured health interpretation including abnormal items, clinical explanations, lifestyle advice, and personalized recommendations.

The analysis uses an async task model with 4 separate sub-commands. You (the Agent) must call each step and handle polling yourself.

Installation

pip install -r requirements.txt

🔑 API Key Setup (Required)

Get your API key: 👉 https://console.wisediag.com/apiKeyManage

The API key MUST be set as an environment variable. The script reads it automatically.

export WISEDIAG_API_KEY=your_api_key

How to Analyze a Report (Step-by-Step)

NEVER call any API or HTTP endpoint directly. ONLY use the script sub-commands below.

⚠️ IMPORTANT: Each command makes HTTP requests to an external API and may take 10-30 seconds to complete. Do NOT kill or interrupt a running command — wait for it to finish. The script prints progress messages so you can see it is still working.

The workflow has 4 steps. You MUST follow them in order.

Step 1: Submit local files or PDF URL

There are two ways to submit — pick one (mutually exclusive):

Option A: Upload local files (recommended) — when user provides local file paths

cd scripts
python3 wise_analyze.py submit -f "/path/to/checkup_report.pdf"
python3 wise_analyze.py submit -f "/path/to/report.pdf" -f "/path/to/scan.jpg"

Option B: Submit via URL — when user provides a public HTTP/HTTPS link

cd scripts
python3 wise_analyze.py submit -u "https://example.com/checkup_report.pdf"

With optional health questionnaire (recommended for better results):

python3 wise_analyze.py submit -f "/path/to/report.pdf" -q "occasional chest tightness, family history of hypertension, poor sleep quality"

With optional member ID to link to a health profile:

python3 wise_analyze.py submit -f "/path/to/report.pdf" -m "HR1017911158367870xxxx"

Output: The script prints TASK_ID=<id>. Save this task ID for the next steps.

How to choose (mutually exclusive — pick one):

User gives a local file path (e.g. /home/user/report.pdf, C:\Users\...\report.pdf) → use -f
User gives a URL (starts with http:// or https://) → use -u
Do NOT use -u and -f together in one command

Step 2: Start interpretation

cd scripts
python3 wise_analyze.py start -t "<task_id>"

Output: Prints confirmation that interpretation has started.

Step 3: Poll for progress (YOU must repeat this)

⚠️ CRITICAL: You MUST NOT skip this step. Do NOT jump directly to Step 4.

cd scripts
python3 wise_analyze.py query -t "<task_id>"

Output: The script prints machine-readable status:

STATUS=processing
PROGRESS=50

Polling rules:

If STATUS=queued or STATUS=processing → tell the user the current progress percentage, then wait and poll again using dynamic intervals based on progress:
- PROGRESS 0–30%: wait 10 seconds before next query
- PROGRESS 30–70%: wait 8 seconds before next query
- PROGRESS 70%+: wait 5 seconds before next query
If STATUS=finish → proceed to Step 4
If STATUS=failed → the task failed, inform the user

You MUST:

Keep calling the query command until STATUS is finish or failed. Do NOT give up after one check.
Report each polling result to the user so they can see the analysis progress (e.g. "Analysis progress: 50%..."). Do NOT silently poll without updating the user.
Never skip Step 3 and go directly to Step 4. The save command will fail if the task is not finished.

Step 4: Save the result

cd scripts
python3 wise_analyze.py save -t "<task_id>" -n "report_2025"

Output: The command saves the report and prints REPORT_PATH=<path>.

If -n is not provided, the task ID is used as the filename.

⚠️ IMPORTANT — How to present the result to the user:

After the save command completes, you MUST:

Read the saved .md file using the path printed in REPORT_PATH=
Output a brief one-sentence introduction (e.g. "以下是您的体检报告分析结果：")
Output the full report content directly as-is (rendered Markdown) — do NOT summarize, condense, reorganize, or rephrase any part of it
After the full report, append a short "关键提醒" section: extract 2-3 most critical items from the report that need immediate attention, keep each point to one sentence
Do NOT omit or shorten the report body itself — the full report must be shown in its entirety between the intro and the closing reminder

Sub-commands Reference

submit

| Flag | Description | |------|-------------| | -u, --url | Publicly accessible URL of the PDF checkup report (optional, requires --url or --file) | | -f, --file | Local file path to upload, PDF or image (optional, repeatable for multiple files) | | -q, --questionnaire | Health questionnaire text: symptoms, family history, lifestyle (optional but recommended) | | -m, --member-id | Health profile member ID to link report to existing profile (optional) |

start

| Flag | Description | |------|-------------| | -t, --task-id | Task ID returned from the submit step (required) |

query

| Flag | Description | |------|-------------| | -t, --task-id | Task ID to check status (required) |

save

| Flag | Description | |------|-------------| | -t, --task-id | Task ID to save result (required) | | -n, --name | Output filename stem (default: taskId) | | -o, --output | Output directory (default: current working directory) |

Data Privacy

What happens to your files:

When using --url: The PDF URL is sent to WiseDiag's analysis API, downloaded and processed on their servers
When using --file: Local files are uploaded directly to WiseDiag's servers via multipart/form-data
AI-powered health interpretation results are returned to you
Files are not permanently stored on WiseDiag servers