| name | dgx-update-check |
| description | DGX Spark（GX10）のアップデートをブラウザ・ダッシュボードのボタンで実行する「前」に、今なにが来ているのかを副作用ゼロ・read-onlyで覗き見るスキル。DGX OTA世代の大型更新と Ubuntu標準apt更新（noble-updates/noble-security）の両方を取得し、容量・メモリ見込みとネット調査要約（出典つき）を提示する。ユーザーが「DGXのアップデート何が来てる」「更新前に確認したい」「apt update 相当を覗きたい」「OTA来てる？」と言ったら起動する。 |
dgx-update-check — アップデート事前調査スキル
DGX Spark（GX10）のアップデートは普段ブラウザのダッシュボードのボタンから実行するが、押すと
「何が・どれだけ・どんなリスクで」入るのか分からないまま更新が始まる。過去にはダッシュボードの
アップデートで約 10GB が一気に DL され統合メモリ（大型の常駐プロセス等と共有）が圧迫されてプロセス強制終了の
事故も起きた。このスキルは ボタンを押す前に「何が来ているか」を副作用ゼロで覗く ための道具である。
あなた（判断層）は、決定的データ層スクリプト scripts/collect.sh が吐く JSON を 唯一の事実の入力 とし、
ネット調査（WebFetch / WebSearch・読取のみ）で意味づけを足し、レポート A〜F を チャットに直接提示 する。
アーキテクチャ（二層分離）: 事実の取得＝スクリプト（副作用コマンドを物理的に持たない）／
意味づけ・要約・所見＝あなた。OTA 有無・apt の中身・サイズの「事実」は必ず JSON 側を正とし、
Web は補足に留める（独自推測で OTA 有無を断定しない）。
手順
1. データ層を1回だけ実行して JSON を取得する
bash ~/.claude/skills/dgx-update-check/scripts/collect.sh
- これは read-only・sudo なし・副作用ゼロ（
apt update も DL もサービス操作もしない）。
- 出力は単一 JSON。あなたはこの JSON を唯一の事実として読む。 自分で apt や OTA コマンドを直接叩かないこと
（叩く必要があるのは collect.sh のみ。判断層がコマンドを散らかすと安全境界が崩れる）。
2. preflight を確認する（AC1）
.preflight.ok == false なら、それ以上進まず「環境前提を満たさないため中止（理由：.preflight.reason）」とだけ報告する。
collect.sh はこの場合 非0終了し apt 層を埋めない（fail-fast）。.preflight.ok == true なら続行。.preflight の arch / codename / ota_tool をレポート冒頭に出す。
3. JSON から事実を読む
- 第1層 OTA：
.ota.is_available（available / name / description / releaseNotesUrl / releaseDate）、
.ota.installed_name、.ota.torn（torn=0 が完全適用）。available=true のときは .ota.ota_versions に入るパッケージ群。
- 第2層 apt：
.apt.packages[]（name / ver_from→ver_to / repos / is_security / action / size_bytes / description）、
.apt.counts、.apt.phasing_deferred、.apt.autoremove_candidates、原文照合用の .apt.upgradable_raw。
- action:
install＝実際に入る / phasing＝更新可能だが段階展開で保留中 / remove＝削除。
- 容量・メモリ：
.estimate.download_bytes_total / download_human / size_partial_unknown /
mem_available_bytes / mem_available_human。
- 鮮度：
.freshness.apt_index_mtime / apt_index_file。
- 安全材料：
.safety.apt_lists_snapshot / .safety.dashboard_services。
- 取得失敗：
.errors[]（空でなければ該当項目を「取得できなかった」と明示する。隠さない）。
4. ネット調査（読取のみ・出典必須・security 優先）
- 必ず：
.ota.is_available.releaseNotesUrl を WebFetch してリリースノートを要約（レポート D）。出典 URL を併記。
- 必ず：
.apt.packages[] | select(.is_security == true) の各パッケージ（例 liblzma5 / xz-utils）を、
名前 + ver_to + CVE で WebSearch し、意味・既知のリスク（CVE 等）を要約。各要約に参照 URL を併記。
- security 由来が 0 件なら「security 由来の更新は今回なし」と明記すれば合格（AC7）。
- 任意：その他の主要パッケージ（phasing 中の大物等）も必要に応じて WebSearch。大規模クロール・自動リンク巡回はしない。
- 推測と事実を分離する：JSON にある値は「事実」、Web 由来は「調査（出典つき）」として書き分ける。
5. レポート A〜F をチャットに提示する（ファイル書き出しはしない）
レポート様式（A〜F）
A. サマリ
- 新 OTA 世代：来ている / 来ていない（
.ota.is_available.available）。来ていない場合は第2層 apt を主役に。
- apt 更新件数：install
.apt.counts.install / phasing 保留 .apt.counts.phasing / 削除 .apt.counts.remove。
- 総 DL サイズ目安：
.estimate.download_human（size_partial_unknown が true なら「一部サイズ不明・判明分のみ」と添える）。
B. 第1層 DGX OTA の詳細（AC2/AC3）
- 世代名・説明・公開日・リリースノート URL（
.ota.is_available の 5 項目）。
- 現在の適用状態：一致世代名
.ota.installed_name.name と torn .ota.torn.torn（0=完全適用、数値が大きいほど未適用が多い）。
- available=true のときのみ：
.ota.ota_versions の「これから入るパッケージ群」。
C. 第2層 apt の詳細（AC4/AC5）
.apt.packages[] を action 別に提示。各 install パッケージは
「名前・ver_from→ver_to・リポジトリ（updates / security）・サイズ（size_bytes を MB/KB で）・一言説明」。- phasing 保留分（
.apt.phasing_deferred）と autoremove 候補（.apt.autoremove_candidates、多ければ件数＋代表例）を区別して記載。
.apt.upgradable_raw と突き合わせ、upgradable の全パッケージが漏れていないことを確認（AC4）。
D. ネット調査の要約（AC6/AC7・出典 URL 必須）
- リリースノート要約（出典：releaseNotesUrl）。
- security パッケージの意味・リスク（CVE 等）要約（各出典 URL）。security 0 件なら「今回なし」と明記。
E. 容量・メモリ見込み（AC8）
- 「総ダウンロードサイズ目安：
.estimate.download_human」
- 「現在のメモリ空き：
.estimate.mem_available_human」
- 所見：押したら足りるか（例：DL は数百KB〜MB 規模でメモリ余力 約 X Gi に対し問題なし／大型 OTA が来ている場合は
過去の +10GB 事故を踏まえ余力を確認するよう促す）。size_partial_unknown が true なら「合算は判明分のみ」と明示。
F. 安全性の明示（必須・AC9/AC10/AC11）
- 副作用ゼロ宣言（必ず）：
このスキルは apt update・パッケージのダウンロード・サービスの起動/停止/再起動の いずれも行っていません。
取得はすべて read-only（sudo なし）で、apt のローカルインデックスもダッシュボード機構も変更していません。
- 根拠として
.safety.apt_lists_snapshot（apt インデックスの最新 mtime）と
.safety.dashboard_services（2 サービスが active のまま）を提示。
- 情報の基準日時（AC10）：
情報の基準日時：.freshness.apt_index_mtime（apt ローカルインデックス最終更新）。
これより新しい更新は反映されていない可能性があります。最新化したい場合は ダッシュボードのアップデート で行ってください
（このスキルは鮮度を表示するだけで apt update はしません）。
- 参考：実際に更新したい場合のユーザー手動コマンド（スキルは実行しない・テキスト提示のみ・AC11）：
以下はあなた（ユーザー）がターミナルで手動実行する場合の参考です。このスキルは実行しません。
通常は GX10 のダッシュボードのアップデートボタンで更新するのが正規ルートです（過去の +10GB 事故を踏まえ、
大型 OTA のときは統合メモリの空きを確認してから実行してください）。
# （参考・手動）最新インデックス取得 → 内容確認 → 適用。実行はユーザー判断で。
sudo apt update
apt list --upgradable
sudo apt full-upgrade
安全規律（あなたが守ること）
- collect.sh 以外で apt / OTA を 直接叩かない。事実取得はデータ層に一本化されている（ADR-1）。
sudo・apt update・apt upgrade|full-upgrade・ダウンロード・サービス操作を 実行しない
（F の手動コマンドは「テキストでの参考提示」のみ。実行は絶対にしない）。- ダッシュボード機構（
dgx-dashboard.service / dgx-dashboard-admin.service）は 観測（is-active）まで。停止・再起動・設定変更をしない（F2）。
- ネット調査は WebFetch / WebSearch の 読取のみ。要約には必ず出典 URL を付け、推測と事実を区別する（F6）。
- JSON が壊れていた・
.errors[] が空でない場合は、取れた範囲で報告し、取れなかった項目を「取得できなかった」と正直に明示する。
なぜ collect.sh に一本化するか：副作用コマンドをスクリプトに 物理的に存在させない ことで、
「うっかり危険コマンドを実行する」経路自体を消している（許可コマンド allowlist は scripts/config.sh に明記）。
