菜单
Analyze energy conservation measures — apply upgrades and compare before/after performance. Use when user asks about "retrofit", "upgrade", "ECM", "energy savings", or "what-if analysis".
用 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 | retrofit |
| description | Analyze energy conservation measures — apply upgrades and compare before/after performance. Use when user asks about "retrofit", "upgrade", "ECM", "energy savings", or "what-if analysis". |
| disable-model-invocation | true |
Apply energy conservation measures to an existing model and compare before/after performance.
Ensure a simulation has been run on the current model. If not:
save_osm_model(save_path="/runs/baseline.osm")
run_simulation(osm_path="/runs/baseline.osm", epw_path="<epw>")
get_run_status(run_id=<id>)
extract_summary_metrics(run_id=<baseline_id>)
Record baseline EUI and end-use breakdown.
Inspect the model to suggest relevant ECMs:
get_building_info()
list_model_objects(object_type="Construction")
list_air_loops()
list_zone_hvac_equipment()
Ask the user which upgrades to apply. Available ECM tools:
Envelope:
replace_window_constructions(construction_name="Triple Low-E") — bulk replace windowscreate_standard_opaque_material + create_construction + assign_construction_to_surface — upgrade walls/roofHVAC/Controls:
adjust_thermostat_setpoints(cooling_offset_f=2.0, heating_offset_f=-2.0) — widen deadbandreplace_thermostat_schedules(...) — new thermostat schedulesshift_schedule_time(shift_value_hours=1) — shift occupancy/HVAC schedulesRenewables:
add_rooftop_pv(fraction_of_roof=0.5) — rooftop solaradd_pv_to_shading(...) — PV on shading surfacesLoads:
enable_ideal_air_loads() — remove HVAC for load-only studiesadd_zone_ventilation(...) — modify ventilation ratesadd_ev_load(...) — add EV chargingModel Cleanup:
clean_unused_objects() — remove orphans before re-simulationSee ecm-catalog.md for typical savings ranges.
save_osm_model(save_path="/runs/retrofit.osm")
run_simulation(osm_path="/runs/retrofit.osm", epw_path="<epw>")
get_run_status(run_id=<id>)
extract_summary_metrics(run_id=<retrofit_id>)
extract_end_use_breakdown(run_id=<retrofit_id>)
compare_runs(baseline_run_id=<baseline_id>, retrofit_run_id=<retrofit_id>)
Returns EUI delta, per-fuel end-use breakdown, and unmet hours change.
For manual comparison, use extract_summary_metrics on both runs.
create_measure to write a custom measure (see measure-authoring skill)