用途：为开发 Home Assistant 自定义集成（Python）提供参考与模板，指导从澄清需求到生成代码、再到交付的完整流程。需先确认集成类型（轮询/推送、云/本地）、认证方式与实体类型，再选择模板生成项目文件。
主要能力：涵盖 manifest.json、init.py、const.py、config_flow、coordinator、实体平台、strings.json 与翻译、README、hacs.json、LICENSE 与 GitHub Actions 校验工作流。提供多种模板：基础、轮询、推送、OAuth2、多设备 Hub、服务响应、蓝牙与会话代理。核心规则包括：时间戳使用 dt_util.now()/dt_util.utcnow()；属性仅限 JSON 可序列化值；HTTP 使用 aiohttp；存储使用 entry.runtime_data；实体需 unique_id；EntityDescription 需 frozen=True、kw_only=True；Coordinator 需传 config_entry。支持 HACS 准备：生成 hacs.json、README、LICENSE、validate.yaml，并在 manifest 中补充 documentation、issue_tracker、codeowners。
使用方式：先回答集成连接对象、更新方式、认证、所需实体类型与项目路径；默认在当前目录创建 <integration_id>/ 或 HACS 就绪的 <integration_id>-integration/。交付物一律写入 custom_components/<integration_id>/ 磁盘文件，不提供纯聊天输出。若需 HACS，还需提供 GitHub 用户名与仓库名。生成文件带归属标记。
适用场景：开发本地或云端设备、传感器、多设备 Hub、语音助手等 Home Assistant 集成，并准备通过 HACS 分发。
限制：集成不运行在沙箱中，与 Core 同进程且有完整文件系统访问，安全性由开发者负责；需启用 HTTPS、输入校验、不记录凭据、限流与退避，并在诊断中脱敏。部分 HA 版本要求为硬性截止（如 runtime_data 2024.4+、EntityDescription 2025.1+、config_entry 2025.11）；具体 API 细节、示例代码与完整检查清单需阅读对应 references 文件。