# Tech Detect

> Verwenden, wenn lokale Hardware, Betriebssystem-, Software- und Python-Versionen evidenzbasiert erfasst und verglichen werden sollen (z. B. 'Tech-Stack erfassen', 'Hardware und Software inventarisieren', 'Systemstand messen', /tech-detect). Erstellt einen versionierten, privaten Techshot mit Befehlsbelegen und erkennt Systemänderungen ohne Fehlinterpretationen. NICHT verwenden für CVE-Schwachstellen-Scans (dafür dev/security-tech-stack-check).

- Skill: `ellmos-ai/tech-detect` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx get-skill add ellmos-ai/tech-detect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/tech-detect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/ellmos-ai/tech-detect

---



<img src="banner.png" width="100%" alt="tech-detect banner">

# Tech Detect

## Einsatz

Nutze diesen Skill für eine belegte Istaufnahme eines **eigenen, autorisierten Hosts** oder einen Vergleich bereits vorhandener Hostaufnahmen. Eine Inventarliste ist Ausgangspunkt, kein Beweis für eine gerade installierte Version. Lies zuerst die vorhandene Inventarführung und ihre Host-Slot-Regeln. Bei `<inventory>` sind die JSON-Seeds die Eingabe; Datenbank und Tabellenexport sind Projektionen. Aktualisiere den Seed nur über dessen vorhandenen Host-Workflow, niemals beiläufig durch diesen Skill. Fremde Slots bleiben lesend.

Führe die folgenden Befehle im Skillverzeichnis oder mit aufgelöstem Skriptpfad über einen **expliziten Python-Interpreter** aus; eine `.py`-Datei nicht direkt starten.

## Ablauf

1. **Scope festlegen.** Host, eigener Slot, Inventar-Seed, private Ausgabe, Erhebungszeit in UTC, Dateisperren und Rechte prüfen. Keine Geheimnisse, vollständigen PATH-String oder Konfigurationsinhalte in Berichte kopieren.
2. **Lokale Evidenz messen.** `python -X utf8 scripts/techshot.py capture --seed <inventar>/systems/<eigener-slot>.json --slot <eigener-slot> --output <privat>/techshot-<UTC>.json` liest den Seed, lokale Plattform und installierte Pakete. Windows: Uninstall-Registry (Benutzer/Maschine, 32/64 Bit); Linux: vorhandenes `dpkg-query` oder `rpm`; macOS: vorhandenes Homebrew. Diese Quellen sind niemals eine garantierte Gesamtliste. `Win32_Product` **nicht** abfragen: Microsoft dokumentiert dabei Konsistenzprüfung und mögliche MSI-Reparatur. Andere Paketmanager und manuell kopierte Apps bleiben als Erfassungslücke sichtbar.
3. **Python getrennt belegen.** Laufender Interpreter erhält die genaue Laufzeitversion. Alle im PATH beobachteten Python-Dateien und ausdrücklich über `--python-path` benannten Installationen/Venvs erscheinen als getrennte Installationen. Ihre Version bleibt `unknown`, solange sie nicht ausdrücklich als vertrauenswürdiger Pfad mit `--probe-python <pfad>` und `-I -S --version` geprüft wurde. Effektives `sys.executable`, Venv-Kontext und PATH-Kandidaten nie zu einer einzigen Python-Version zusammenziehen.
4. **Qualität erhalten.** Jeder Komponentenbefund enthält stabile Produktidentität, Installationskennung, Version, Quelle und Qualitätsstatus `observed`, `reported`, `uncertain` oder `unknown`. Ein Seedwert wie `3.x` ist keine exakte Version. Hardware aus dem Seed bleibt mit Seedstand als gemeldet getrennt. `hardware_observations` misst OS, Architektur, CPU-Modell und logische Kerne, RAM und Kapazität des System-Dateisystems lesend; die GPU bleibt mangels portablem Sammler ausdrücklich `unknown`. Keine Seriennummern, MAC-Adressen oder vollständigen PATH-Werte erfassen. Fehlt eine Quelle, das Feld als `unknown` ausweisen.
5. **Hosts oder Zeitstände vergleichen.** `python -X utf8 scripts/techshot.py compare --left <privat>/alt-oder-host-a.json --right <privat>/neu-oder-host-b.json --output <privat>/vergleich.json` nutzt den inventargebundenen Slot als Assetkennung. Verschiedene Slots ergeben `axis=cross-host`, auch bei gleichem Hostnamen; `identity_note` nennt diese Mehrdeutigkeit. Derselbe Slot mit demselben Hostnamen und verschiedenen `captured_at_utc` ergibt `axis=same-host-time`. Eine Hostnamenänderung bei gleichem Slot erfordert einen externen Kontinuitätsbeleg und wird hier gestoppt. Die Reihenfolge steht in `chronology`. Einseitig nicht beobachtete Pakete beweisen weder Deinstallation noch fehlende Installation. Gleiche bekannte Versionen mit weiteren unbekannten Installationen erscheinen als `version-uncertain` samt Installationskennungen, statt zu verschwinden. Abweichende oder unbekannte Hardwarefelder separat lesen. Unterschiedliche Paketökosysteme oder Produktaliasse nur mit zusätzlicher Herstellerkennung zusammenführen.
6. **Rhythmus einrichten.** Nur nach Hostfreigabe den vorhandenen Scheduler/Sync-Workflow mit eigenem Slot und neuem Zeitstempel-Ausgabepfad verbinden. Ein Testlauf und der spätere Scheduler-Receipt sind getrennte Belege; aus einem Skill-Commit folgt kein aktiver Zeitplan. Techshots privat und begrenzt aufbewahren.

## Ausgabe und Übergabe

JSON-Vertrag: `ellmos.techshot.v1` mit `captured_at_utc`, `host`, Seed-SHA256, `hardware_observations`, `python_context`, `coverage` und `components[].installations[]`; Vergleich: `ellmos.techshot-comparison.v1` mit `axis`, `chronology`, `inputs.left/right`, `changes` und `hardware_changes`. Der CLI-Vergleich bindet beide Eingabedateien per SHA256 über ihre tatsächlichen Bytes und bewahrt Erfassungszeiten, Hostidentität, Seedbindung und Abdeckung. Die direkte Python-API kennzeichnet stattdessen `hash_basis=canonical-json`. Fehlende oder typdefekte Pflichtprovenienz stoppt den Vergleich; **alte vollständige Aufnahmen bleiben ausdrücklich zulässig**. `compared_at_utc` ist nur der Vergleichszeitpunkt und belegt keine frische Erhebung. Die Aufnahmen sind Beobachtungen neben der bestehenden Inventarquelle, keine konkurrierende Inventardatenbank. An `security-tech-stack-check` nur die nötigen Komponenten, exakten Versionen, Abdeckung und Hashes geben. `unknown` oder `uncertain` niemals als „verwundbar“ oder „sicher“ ausgeben.

Primärquelle zur Windows-Erfassungsgrenze: [Microsoft Learn, Working with software installations](https://learn.microsoft.com/en-us/powershell/scripting/samples/working-with-software-installations?view=powershell-7.6), am 2026-10-25 geprüft.

## Changelog

### 1.0.0 (2026-10-25)

- Lokaler Techshot-/Vergleichsvertrag und quellgebundene Versionsqualität.

