homeassistant-ai/skills

解決的問題

本專案提供一組可攜帶的知識套件，稱為「Agent Skills」，用以教導 AI 編碼代理如何與 Home Assistant 協作。它可防止 AI 代理建議過時或低效率的模式，確保其遵循目前配置與自動化方面的最佳實務。

運作方式

本專案遵循 Agent Skills 標準，以 Markdown 檔案形式提供最佳實務，AI 代理（如 Claude Code、Cursor 和 Copilot）可讀取這些檔案。這些檔案為代理提供特定 Home Assistant 任務的決策工作流程、參考指南與範例，例如在內建助手與模板感測器之間選擇，或管理僅 YAML 的整合。

適用對象

使用 AI 編碼代理撰寫 Home Assistant 設定、自動化與儀表板的開發者與智慧家庭愛好者。

主要亮點

• 廣泛的代理相容性：支援 Claude Code、Cursor、Copilot、VS Code 與 Gemini CLI 等工具。
• 完整的 HA 知識：涵蓋原生結構、自動化模式、Zigbee 按鈕模式與儀表板設定。
• 詳細的參考指南：包含關於安全重構、助手選擇與藍圖撰寫的具體指南。
• 詳細的範例：提供結合多種最佳實務的複合 YAML 範例。