clawdie-iso/skills/iso-hardware-report-ingest/SKILL.md

72 lines
2.1 KiB
Markdown

---
name: iso-hardware-report-ingest
description: Ingest real-machine live USB hw-report evidence into a structured Colibri hardware manifest without treating static inspection as hardware proof.
---
# iso-hardware-report-ingest
Use this skill after the operator or Codex ISO Builder collects live USB evidence
from real hardware. It produces a `clawdie.iso.hardware.v1` manifest for Colibri
and dashboard consumers.
## Manifest output
Write the result to:
```sh
tmp/colibri/iso-hardware/<run_id>.json
tmp/colibri/iso-hardware/latest.json
```
Schema: `clawdie.iso.hardware.v1`. See `docs/ISO-MANIFESTS.md`.
## Inputs to collect from the live USB
Prefer files copied from the live session over paraphrased observations:
```sh
hw-report > /tmp/clawdie-hw-report.txt
pciconf -lv > /tmp/clawdie-pciconf-lv.txt
ifconfig -a > /tmp/clawdie-ifconfig-a.txt
cat /var/log/clawdie-live-gpu.log > /tmp/clawdie-live-gpu.log
```
When debugging GUI/input/audio issues, also collect the relevant exact command
output named in `PLAN-OPERATOR-USB-NEXT.md`, for example:
```sh
xinput list
xfconf-query -c pointers -lv
cat /dev/sndstat
sysctl hw.snd.default_unit
mixer
```
If `hw-probe` upload is intentionally run, record only the public probe URL in
the manifest. Do not upload private operator data without approval.
## Ingest checklist
Record these as manifest checks or evidence fields:
- machine vendor/model and firmware version when available
- CPU model
- GPU PCI IDs, selected KMS module, and reason from `clawdie-live-gpu.log`
- GL renderer if collected
- SDDM login result and XFCE session result
- internal display and external display behavior if tested
- touchpad, keyboard, webcam, audio, Wi-Fi, and USB Ethernet observations
- Tailscale status if it was part of the test
- no-blank/power behavior observed during the session
- image filename or commit shown by the live build manifest
## Finish
Write a concise summary such as:
```text
AMD ASUS UX325UA: pass for SDDM/XFCE/AMD KMS/USB Ethernet/webcam; touchpad needs follow-up.
```
Attach paths to raw captured files under `logs` or `outputs`. Keep the manifest
small enough for Colibri to ingest directly.