jetson-verify

name	jetson-verify
description	Jetson 部署驗證工具。部署後跑 smoke test、整合前做 pre-flight check、 Demo 前產出 go/no-go 報告。觸發詞："verify"、"驗證"、"健檢"、 "smoke test"、"check jetson"、"jetson 狀態"、"/verify"。 在 colcon build 成功後、WSL→Jetson sync 完成後、或使用者說 「驗證」「smoke」「健檢」「ready」時應主動建議執行。 不要在純聊天、文件摘要、或不需實際執行檢查時觸發。

jetson-verify

用途

部署後一鍵驗證 Jetson 環境健康。自動偵測執行環境 （Jetson 本機 = local_jetson，WSL = remote_jetson）， 跑完所有 checks 後輸出結構化 JSON + terminal 摘要。

使用方式

在 repo root 執行：

python3 .claude/skills/jetson-verify/scripts/verify.py --profile smoke

參數

• --profile: smoke（v0）| integration（v1 預留）| demo（v2 預留）
• --output-dir: 預設 logs/jetson-verify/

輸出約定

• stdout: 完整 JSON（一次，machine-readable）
• stderr: 人類摘要（逐行 check + summary）
• file: 同一份 JSON 落盤到 output-dir，含 latest.json symlink

結果解讀

• overall=PASS, exit 0 → 可以繼續開發/測試
• overall=FAIL, exit 1 → 有 blocking check 失敗，修完再跑
• overall=ERROR, exit 2 → 驗證本身不可信（SSH、timeout、config 問題）
• SKIP → 模組沒啟動，不計分
• WARN → 非 blocking 未通過，留意但不阻擋

新增 check

編輯 profiles/.yaml，加一條 check entry。 每個 check 至少需要：id, command, expect, blocking, timeout_sec, message_template。 系統/ROS2 基礎 check 禁止加 precondition。 只有 module-level check 可以用 precondition 做 SKIP。

Gotchas

見 references/gotchas.md（隨使用持續累積）。