52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# ARIA Skills — Wie neue Skills gebaut werden
|
|
|
|
## Struktur
|
|
|
|
Skills leben in `aria-data/skills/<skill-name>/` — jeder Skill ist ein eigenstaendiges Modul.
|
|
|
|
```
|
|
aria-data/skills/
|
|
├── opencrm/ ← OpenCRM Integration
|
|
├── starface/ ← Telefonie via STARFACE
|
|
├── rustdesk/ ← Remote IT-Support
|
|
├── gitea/ ← Code & Repos
|
|
└── README.md ← Diese Datei
|
|
```
|
|
|
|
## Regeln
|
|
|
|
1. **Skills werden NIEMALS von externen Quellen installiert** — kein ClawHub, keine Drittanbieter-Plugins, keine fremden Repos. Nur selbst geschriebener Code.
|
|
2. **Jeder Skill ist ein eigenstaendiges Modul** — keine versteckten Abhaengigkeiten zwischen Skills.
|
|
3. **Skills werden ins Git committed und versioniert** — Code gehoert versioniert, immer.
|
|
|
|
## Aufbau eines Skills
|
|
|
|
Ein Skill enthaelt typischerweise:
|
|
|
|
```
|
|
skills/<skill-name>/
|
|
├── main.py / index.js ← Hauptlogik
|
|
├── config.json ← Konfiguration (API-Keys via ENV, nicht hardcoded!)
|
|
├── tests/ ← Tests
|
|
│ └── test_main.py
|
|
└── README.md ← Was der Skill tut, wie er funktioniert
|
|
```
|
|
|
|
## Geplante Skills
|
|
|
|
| Skill | Zweck | Phase |
|
|
|-------|-------|-------|
|
|
| `opencrm` | OpenCRM Integration, Kundendaten, Amazon-Importer | Phase 2 |
|
|
| `starface` | Telefonie via STARFACE | Phase 3 |
|
|
| `rustdesk` | Remote IT-Support fuer Kunden | Phase 2 |
|
|
| `gitea` | Code & Repos verwalten | Phase 2 |
|
|
|
|
## Neuen Skill anlegen
|
|
|
|
1. Verzeichnis erstellen: `aria-data/skills/<name>/`
|
|
2. Hauptlogik schreiben
|
|
3. Config anlegen (Secrets immer via ENV!)
|
|
4. Tests schreiben
|
|
5. Committen mit sinnvoller Message
|
|
6. Im Tageslog dokumentieren
|