smart-home-energy-saver

分析家庭能源使用情况并提出安全、只读的自动化计划以节省能源。当用户想要 Home Assistant 能源洞察、优化想法或起草自动化 YAML 而不直接控制设备时使用。

# Smart Home Energy Saver

## Goal
Provide energy-saving recommendations and draft automations without changing device states.

## Best fit
- Use when the user has Home Assistant energy and device data.
- Use when the user wants schedule recommendations and savings estimates.
- Use when the user wants draft automation YAML for review.

## Not fit
- Avoid when the user asks to apply automations automatically.
- Avoid when critical systems are involved without safety review.
- Avoid when data sources are missing or unreliable.

## Quick orientation
- `references/overview.md` for workflow and quality bar.
- `references/auth.md` for access and token handling.
- `references/endpoints.md` for optional integrations and templates.
- `references/webhooks.md` for async event handling.
- `references/ux.md` for intake questions and output formats.
- `references/troubleshooting.md` for common issues.
- `references/safety.md` for safety and privacy guardrails.

## Required inputs
- Home Assistant instance info and read-only token (if used).
- List of controllable devices and comfort constraints.
- Energy tariff schedule and target savings goals.
- Preferred operating hours and exceptions.

## Expected output
- Energy usage summary and top savings opportunities.
- Draft automation YAML snippets with explanations.
- Estimated impact ranges and assumptions.
- Manual checklist for safe rollout.

## Operational notes
- Only propose automations; never apply changes.
- Respect comfort and safety constraints.
- Flag any automation that could affect safety or accessibility.

## Security notes
- Keep tokens in environment variables if provided.
- Avoid exposing home addresses or device identifiers in outputs.

## Safe mode
- Read-only analysis and draft automation files only.
- No live device control or configuration updates.

## Sensitive ops
- Applying automations or controlling devices is out of scope.

---

## 中文说明

# 智能家居节能助手

## 目标
提供节能建议并起草自动化方案，而不更改设备状态。

## 适用场景
- 当用户拥有 Home Assistant 能源和设备数据时使用。
- 当用户想要计划建议和节省估算时使用。
- 当用户想要草稿版的自动化 YAML 以供审查时使用。

## 不适用场景
- 当用户要求自动应用自动化方案时避免使用。
- 当涉及关键系统但未经安全审查时避免使用。
- 当数据来源缺失或不可靠时避免使用。

## 快速导览
- `references/overview.md` 了解工作流程和质量标准。
- `references/auth.md` 了解访问权限和令牌处理。
- `references/endpoints.md` 了解可选的集成和模板。
- `references/webhooks.md` 了解异步事件处理。
- `references/ux.md` 了解信息收集问题和输出格式。
- `references/troubleshooting.md` 了解常见问题。
- `references/safety.md` 了解安全和隐私防护措施。

## 必需输入
- Home Assistant 实例信息和只读令牌（如果使用）。
- 可控设备列表和舒适度约束。
- 能源费率计划和目标节省目标。
- 偏好的运行时段和例外情况。

## 预期输出
- 能源使用摘要和主要节省机会。
- 带有解释的草稿版自动化 YAML 片段。
- 预估影响范围和假设。
- 用于安全部署的手动检查清单。

## 操作说明
- 仅提出自动化建议；切勿应用更改。
- 尊重舒适度和安全约束。
- 标记任何可能影响安全或可访问性的自动化。

## 安全说明
- 如果提供令牌，请将其保存在环境变量中。
- 避免在输出中暴露家庭住址或设备标识符。

## 安全模式
- 仅进行只读分析和起草自动化文件。
- 不进行实时设备控制或配置更新。

## 敏感操作
- 应用自动化或控制设备不在工作范围内。