home-assistant-integration-knowledge

Umiejętność dla Claude/Copilot zawierająca pełną dokumentację struktury, szablonów i wytycznych do budowania integracji Home Assistant. Zawiera informacje o lokalizacji plików, minimalnej liście kontrolnej, standardowej strukturze katalogów oraz wymaganiach dotyczących jakości kodu. Użyj tego jako głównego źródła referencyjnego podczas pracy nad integracją — niezależnie od tego, czy budujesz nową integrację, czy przeglądasz istniejącą.

1. Załaduj umiejętność w swoim środowisku Claude lub Copilot — będzie dostępna jako referencja podczas pracy nad integracjami Home Assistant.

2. Gdy zaczynajesz nową integrację, skonsultuj się z umiejętnością, aby uzyskać standardową strukturę katalogów. Umiejętność zawiera szablon pokazujący wymagane pliki: init.py, manifest.json, const.py, config_flow.py, strings.json oraz pliki platform (sensor.py, switch.py itp.).

3. Przejrzyj minimalną listę kontrolną zawartą w umiejętności — obejmuje ona manifest.json z wymaganymi polami, async_setup_entry i async_unload_entry w init.py, obsługę interfejsu konfiguracji w config_flow.py oraz plik const.py z stałą DOMAIN.

4. Jeśli twoja integracja wymaga diagnostyki lub napraw, umiejętność wskazuje odpowiednie wytyczne platformy (platform-diagnostics.md i platform-repairs.md).

5. Podczas testowania i przeglądu kodu odwołuj się do wytycznych Quality Scale zawartych w umiejętności — określają one standardy jakości i spójności wymagane przez Home Assistant.

6. Używaj umiejętności jako głównego źródła referencyjnego — zawiera ona informacje o lokalizacji plików komponentów oraz testów, strukturze manifestu i wymaganych polach konfiguracji.