菜单
Diagnose simulation failures and unexpected results. Use when user says "simulation failed", "error", "EUI looks wrong", "unmet hours", or when get_run_status shows failure.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add custom EMS control or reporting logic (EnergyPlus Python Plugins) — setpoint resets, schedule overrides, supervisory control, custom metrics. Use when no packaged HVAC/schedule tool covers the control logic the user wants.
OpenStudio Analysis Framework (OSAF) workflows, algorithm selection, validation, submission, and result download. Use when the user asks about OSAF, OpenStudio Server analyses, sampling, sweeps, optimization, calibration, or OSA JSON configs.
Create, test, and apply custom OpenStudio measures. Use when user asks to "write a measure", "create a custom measure", "modify the model with Ruby/Python code", or needs logic beyond what existing tools provide.
Generate comprehensive energy analysis report from simulation results. Use when user asks for "energy report", "full results", or "detailed analysis".
OpenStudio model object relationships, tool dependencies, and common error patterns. Use when building or modifying models to ensure correct tool ordering.
Run model quality checks before simulation. Use when user asks to "check the model", "validate", "QA/QC", or before running a simulation.
| name | troubleshoot |
| description | Diagnose simulation failures and unexpected results. Use when user says "simulation failed", "error", "EUI looks wrong", "unmet hours", or when get_run_status shows failure. |
| user-invocable | true |
| disable-model-invocation | true |
get_run_status(run_id=...)
get_run_logs(run_id=..., log_type="stderr")
| Error pattern | Cause | Fix |
|---|---|---|
No weather file | Missing or wrong EPW path | change_building_location(weather_file="/inputs/...") |
No SizingPeriod | Missing design days | change_building_location (loads DDY automatically) |
Could not find the stat file | EPW missing companion .stat/.ddy | EPW needs .stat + .ddy files alongside with same base filename |
Node not connected | Broken HVAC loop | Check with get_air_loop_details / get_plant_loop_details |
Surface has no vertices | Bad geometry | Check list_surfaces() for degenerate surfaces |
Zone has no surfaces | Empty thermal zone | Zone needs spaces with geometry assigned |
extract_summary_metrics(run_id=...)
EUI too high:
get_schedule_details, set_thermostat_schedulesextract_hvac_sizing to check autosizinglist_model_objects(object_type="SpaceInfiltrationDesignFlowRate")EUI too low:
list_model_objects(object_type="People"), list_model_objects(object_type="Lights"), list_model_objects(object_type="ElectricEquipment")list_air_loops, list_zone_hvac_equipmentget_run_periodHigh unmet hours:
extract_component_sizingget_plant_loop_detailsextract_zone_summary(run_id=...) # per-zone temps and loads
extract_component_sizing(run_id=...) # autosized values
query_timeseries(run_id=..., variable_name="Zone Mean Air Temperature",
frequency="Hourly", key_value="Zone 1")
If a measure fails due to nonexistent API methods:
search_api("CoilCoolingFourPipeBeam") # list real setters/getters
search_api("BoilerHotWater", method_pattern="Efficiency")
| Problem | Tool |
|---|---|
| Add missing weather | change_building_location (sets EPW + DDY + climate zone) |
| Add missing HVAC | add_baseline_system |
| Remove broken objects | clean_unused_objects |
| Check model completeness | run_qaqc_checks |
| Inspect without simulating | inspect_osm_summary |