report-instructions

Health Report Generation Usage Instructions Skill

Provides /report detailed usage instructions and examples for the command.

Quick Start

Simplest Usage

/report comprehensive

Generate a comprehensive health report containing all available data, saved in reports/health-report-YYYY-MM-DD.html。

Command Format

/report <action> [date_range] [sections] [output]

Parameter Description

action (required)

Report Type	Description
comprehensive	Comprehensive report (includes all sections)
biochemical	Biochemical trend analysis
imaging	Imaging examination summary
medication	Medication analysis
custom	Custom report

date_range (optional)

Parameter	Description
all	All data (default)
last_month	Last month
last_quarter	Last quarter
last_year	Last year
YYYY-MM-DD,YYYY-MM-DD	Custom range
YYYY-MM-DD	From a certain date to present

sections (optional)

Section Code	Description
profile	Patient profile
biochemical	Biochemical tests
imaging	Imaging examinations
medication	Medication analysis
radiation	Radiation dose
allergies	Allergy summary
symptoms	Symptom history
surgeries	Surgical records
discharge	Discharge summary

output (optional)

Output file name (default: health-report-YYYY-MM-DD.html)

Execution Flow

1. Parse parameters - Understand the report type and time range
2. Collect data - Read relevant data from various data files
3. Analyze data - Calculate trends, statistics, and health scores
4. Generate insights - Identify key findings and recommendations
5. Render HTML - Generate a visual report containing charts
6. Save file - Save the report to the specified location
7. Show confirmation - Display the report location and basic information

Report Content

The generated HTML report contains:

• Title area (report name, generation time, data range)
• Patient profile (age, height, weight, BMI, body surface area)
• Executive summary (health score, key findings, core indicators)
• Data sections (based on your data)
• Disclaimer

Usage Examples

# 生成综合报告
/report comprehensive

# 生成最近季度的报告
/report comprehensive last_quarter

# 生成去年的报告
/report comprehensive last_year

# 生成自定义时间范围的报告
/report custom 2024-01-01,2024-12-31

# 生成包含特定章节的报告
/report custom 2024-01-01,2024-12-31 biochemical,medication,radiation

# 生成生化趋势分析
/report biochemical last_year

# 指定输出文件名
/report comprehensive all all my-health-report.html

Troubleshooting

Issue 1: "No data available" is displayed

Cause: There is no relevant data within the specified time range

Solution:

• Check whether the data has been entered
• Try using all as the time range
• Confirm that the data file exists in the data/ directory

Issue 2: Report generation failed

Cause: Data file format error or missing required fields

Solution:

• Check whether the data file format is correct
• Ensure read permission is available
• Check the error message and fix the related issue

Issue 3: Charts are not displayed

Cause: Network connection issue, unable to load CDN resources

Solution:

• Check the network connection
• Ensure that the following CDN can be accessed:
  • cdn.tailwindcss.com
  • cdn.jsdelivr.net
  • unpkg.com