Haupt-README mit Inhaltsverzeichnis und Repo-Übersicht hinzufügen

2026-08-22 19:23:18 +02:00
parent 7dd5038a93
commit e695e55cca
1 changed files with 71 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Amazon Alexa Skills
+
+Sammlung eigener, privater Alexa Custom Skills. Jeder Skill liegt in einem eigenen Unterordner mit vollständiger Dokumentation.
+
+## Inhaltsverzeichnis
+
+- [Übersicht](#übersicht)
+- [Skills](#skills)
+  - [Home Assistant Skill](#home-assistant-skill)
+- [Allgemeine Voraussetzungen](#allgemeine-voraussetzungen)
+- [Repo-Struktur](#repo-struktur)
+- [Sicherheitshinweise](#sicherheitshinweise)
+
+---
+
+## Übersicht
+
+Dieses Repository enthält den Code, die Konfiguration und die Dokumentation für selbst entwickelte Alexa Skills. Alle Skills sind **privat** (nicht im Alexa Skill Store veröffentlicht) und laufen als **Alexa-hosted Skills** (Node.js) — es ist keine eigene AWS-Infrastruktur nötig.
+
+---
+
+## Skills
+
+### Home Assistant Skill
+
+📁 [`home-assistant-skill/`](home-assistant-skill/)
+
+Fragt per Sprache Werte aus Home Assistant ab, z.B. Raumtemperaturen von Heizungsthermostaten.
+
+**Beispiel:**
+> "Alexa, frag Home Assistant wie warm es im Wohnzimmer ist"
+> → "Die Temperatur im Wohnzimmer beträgt 24.4 Grad."
+
+**Status:** ✅ `GetTemperatureIntent` funktionsfähig · ⏳ `GetPowerUsageIntent` (Stromverbrauch) noch offen
+
+➡️ [Vollständige Anleitung & Dokumentation](home-assistant-skill/README.md)
+
+---
+
+## Allgemeine Voraussetzungen
+
+Für alle Skills in diesem Repo gilt:
+
+- Amazon Developer Account (ggf. mit Identitätsverifizierung — Amazon fordert bei manchen Accounts einen Ausweis-Upload unter "Verify Identity")
+- Grundkenntnisse der [Alexa Developer Console](https://developer.amazon.com/alexa/console/ask)
+- Node.js-Kenntnisse für Anpassungen am Lambda-Code
+
+Skill-spezifische Voraussetzungen (z.B. eine erreichbare Home-Assistant-Instanz) stehen jeweils in der README des Unterordners.
+
+---
+
+## Repo-Struktur
+
+```
+Amazon-Alexa-Skills/
+├── README.md                      # diese Übersicht
+└── home-assistant-skill/
+    ├── README.md                  # Step-by-Step-Anleitung
+    ├── index.js                   # Lambda-Handler
+    ├── package.json               # Node-Abhängigkeiten
+    └── .env.example               # Vorlage für Secrets
+```
+
+Neue Skills werden jeweils als eigener Unterordner mit derselben Struktur (`README.md`, Code, `.env.example`) ergänzt.
+
+---
+
+## Sicherheitshinweise
+
+- **Keine echten Secrets committen.** `.env`-Dateien mit echten Tokens gehören nicht ins Repo — nur `.env.example` mit Platzhaltern. Alexa-hosted Skills bieten keine Environment-Variables-Oberfläche in der Konsole; Secrets landen daher direkt im Skill-Code selbst (nicht in diesem Git-Repo).
+- Dieses Repository ist **privat** — das ist Voraussetzung dafür, dass die dokumentierten Vorgehensweisen (z.B. Hardcoding von Tokens im Skill-Code) vertretbar sind. Bei einer Veröffentlichung oder Freigabe für Dritte müssten Secrets vorher ausgetauscht und sauberer verwaltet werden.