72 lines
2.8 KiB
Markdown
72 lines
2.8 KiB
Markdown
# 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.
|