ヘルパー - Windows ハードウェア診断

1. スキルポジショニング

windows-hardware-doctorは、Windows PC向けのハードウェア診断およびセキュリティ処理スキルです。このスキルを使用すると、エージェントは「証拠収集、判断、および修正」のアプローチで以下の問題を処理できます。

• ハードウェアの在庫状況と簡単な状態チェック。
• デバイスに異常があります。黄色の感嘆符が表示されています。ドライバーに問題があります。
• CPU、メモリ、グラフィックカードのクラッシュ、フリーズ、ブラックスクリーン。
• HDD、SSD、NVMe、SMART、ディスクイベント、データリスク。
• ディスク容量の分析、バックアップ計画、およびクリーンアップ対象者の整理。
• USB、周辺機器、インターフェース、電源、および物理的な接続に関する問題。
  ソフトウェア認証完了後、入念な物理的検査に関する推奨事項を提供する。

これは「ワンクリックで問題を解決できるツール」ではありません。その核心的な価値は、エージェントが検証可能な証拠を収集し、リスクレベルを判断し、事実と憶測を区別し、システムやデータを変更する可能性のある操作を行う前にユーザーの明確な承認を待つことを支援することです。

2. エージェント機能の概要

3. コアとなる作業方法

エージェントは以下の閉ループに従う必要があります。

1. 症状、発症時期、発生頻度、最近のソフトウェアおよびハードウェアの変更、データが危険にさらされているかどうかについて問い合わせてください。
2. ネイティブの読み取り専用メソッドを使用して、ハードウェアとイベントのベースラインを確立します。
3. すべての情報を一度にコンテキストに詰め込むのではなく、問題の種類に応じて対応する診断データをロードします。
4. デバイスの状態、ドライバ、リソース、ストレージの信頼性、および重要なシステムイベントを同時に確認します。
5. 結論を「確認済み、可能性が高い、可能性あり、未検証」に分類する。
6. 最も小さく、可逆的な次のステップを推奨する。破壊的または不可逆的な操作は最後に行うべきである。
7. 承認を得て変更を実施した後、変更前と変更後の違いを再検討し、報告する。

このプロセスにより、単一信号の誤解釈を減らすことができます。例えば：

CPU使用率が高いということは、単に電流負荷が高いことを示しているだけであり、必ずしもCPUが損傷していることを意味するものではありません。
イベント41は異常シャットダウンが発生したことを証明するだけであり、その根本原因が電源にあることを証明するものではありません。

• SMARTが「正常」と表示されていても、それだけでディスクの問題を排除できるわけではありません。
• 温度フィールドが空欄の場合は、Windowsがセンサーを公開していないことを示しますが、温度が正常であることを意味するものではありません。
  ドライバーの日付が古いというだけでは、ドライバーのアップデートが必要であることを証明することはできません。

4. 組み込みツールと実際の出力

4.1 Get-HardwareAudit.ps1

このスクリプトは、JSON形式のハードウェア監査結果を生成します。主なフィールドは以下のとおりです。

• Meta: 収集時刻、Windows のバージョン、管理者として実行されているかどうか、イベント発生時間範囲。
• 評決：迅速な判断；
• 「注意」：注意を払う必要がある信号。
• MissingSections: 権限またはインターフェースが利用できないために欠落しているモジュール。
• CPU、MemorySummary、MemoryModules、GPU;
• DiskDrives、PhysicalDisks、Volumes;
• 問題のあるデバイス、署名されていないまたは不完全なドライバー;
• バッテリー、関連システムイベント、制限事項。

デフォルトでは、メモリモジュールのシリアル番号/部品番号、GPUおよびディスクのPnP ID、ディスクのシリアル番号は非表示になります。-IncludeIdentifiersは、デバイスの正確な一致が絶対に必要な場合にのみ使用してください。

スクリプトは現在、以下を返す可能性があります。

• HEALTHY_NO_OBVIOUS_FAULTS: スナップショットに明らかな障害は見つかりませんでした。
• 注意: 注意を要する信号が検出されました。
• 不完全: 一部のデータソースが利用できないため、この情報から完全な健康状態に関する結論を導き出すことはできません。

ATTENTION の自動ルールは現在、PnP の異常、物理ディスクの不具合、ボリュームの空き容量が 10% 未満、および WHEA/ディスク/部分的なストレージコントローラ イベントを対象としています。

4.2 Get-LargeFiles.ps1

このスクリプトは、ユーザーが明示的に指定した既存のディレクトリ内のみを再帰的に検索し、以下の機能をサポートしています。

• 最小ファイルサイズ、デフォルトは500MB。
• アイテム数を返します。デフォルトは最初の50個、最大は1000個です。
• 出力ファイルサイズ、最終更新日時、およびフルパス。
  候補となるファイルのみを一覧表示し、削除、移動、圧縮は行いません。

5. 入力と出力の例

以下の出力は、現在のスキル設計に準拠したサンプル結果であり、エージェントをどのように表現すべきかを示すために使用されます。具体的なデータは、コンピュータによって異なる場合があります。

例 1: ランダムフリーズが発生した場合、まず読み取り専用チェックを実行します

入力例

最近、Windows 11搭載のデスクトップパソコンがランダムにフリーズするようになりました。CPU、メモリ、グラフィックカード、ディスク、その他不具合のあるデバイスを速やかに確認してください。設定はまだ変更しないでください。
「`」

**出力例**

```テキスト
【Windowsホストハードウェアチェック】注意

- 確認済み：過去7日間に3回の異常シャットダウンが発生しました。異常なPnPデバイスは検出されませんでした。Cドライブの空き容量は8.4%です。
- より可能性が高いのは、システムディスクの空き容量不足がラグを悪化させている可能性ですが、イベント41自体がフリーズの根本原因であることを証明することはできません。
考えられる原因：グラフィックカードドライバのリセット、メモリの不安定性、またはストレージのタイムアウト。現時点では十分な証拠がありません。
影響：システムの不安定化やアップデートの失敗のリスクがあります。現時点では、直接検証可能なデータ破損は確認されていません。
- 直ちに行動を起こしてください。まず重要な作業を保存し、複数のストレステストを同時に実行することは避けてください。
- 次の診断：フリーズ発生の前後10分間のディスプレイ、WHEA、ディスク/stornvme、およびBugCheckイベントを確認してください。
書き込み操作は実行されませんでした。
「`」

### 例2：デバイスマネージャーに黄色の感嘆符が表示される

**入力例**

「`テキスト」
デバイスマネージャーに黄色の感嘆符が表示されています。デバイスを特定してドライバーを修正するのを手伝ってください。
「`」

**出力例**

「`テキスト」
異常なデバイスが検出されました：USBコントローラー、PnP問題コード28。これは、現在利用可能なドライバーがインストールされていないことを示しています。

現在の証拠：
- デバイスの状態: エラー
問題コード: 28
- 現在のドライバー: 有効なバージョンが見つかりません
- 正確なハードウェアID：既にローカルで収集されており、デフォルトではメッセージ内で公開されません。

正確なモデル番号、Windowsバージョン、およびハードウェアIDに基づいて、OEM/OEMの公式サポートページから署名付きドライバーを入手することをお勧めします。
ドライバをインストールするとシステムが変更されます。作業を進める前に、ソースコード、バージョン、署名、ロールバック計画、およびUSB接続の中断リスクについてご説明し、このデバイスに対する具体的な操作についてお客様のご承認をいただきます。
「`」

### 例3：ドライブDがほぼ満杯です。まずバックアップを取り、その後クリーンアップしてください。

**入力例**

「`テキスト」
Dドライブの容量がほぼいっぱいです。大きなファイルを見つけてバックアップを作成し、その後容量を空けるのを手伝ってください。ただし、直接削除しないでください。
「`」

**出力例**

「`テキスト」
Dドライブの読み取り専用領域の分析が完了し、ファイルは削除されませんでした。

主な候補者：
1. D:\VMs\dev-machine.vhdx — 82.4 GB — 仮想マシンがまだ使用されているかどうか確認してください。
2. D:\Downloads\archive.iso — 6.1 GB — ソースを確認した後、バックアップ ドライブに移動できます。
3. D:\BuildCache\old-cache.bin — 3.7 GB — 対応するアプリケーションを使用してクリーンアップすることをお勧めします。

バックアップに関する推奨事項：まず、かけがえのないデータを別の正常なディスクにコピーし、ファイル数、合計サイズ、代表的なハッシュ値、および重要なファイルのオープン性を確認してください。その後、正確なクリーンアップリスト、推定される空き容量、および復旧方法を作成し、項目ごとに承認をいただきます。
「`」

### 例4：SSDが故障寸前であると疑われる場合

**入力例**

「`テキスト」
ファイル読み込み中にパソコンがフリーズしたり、SSDが時々認識されなくなったりします。`chkdsk /f`を実行して問題を解決していただけますか？
「`」

**出力例**

```テキスト
最初にchkdsk /fを実行することは推奨されません。ディスクが認識されない、またはI/Oがフリーズする場合は、メディアまたはコントローラーの障害を示している可能性があり、書き込みの修復を試みるとリスクが高まります。

推奨される順番：
1. クリーニング、ベンチマーク、デフラグ、およびフルディスクスキャンを停止します。
2. 物理ディスク、関連ボリューム、SMART/信頼性カウンター、およびストレージイベントの読み取り専用確認。
3. かけがえのないデータを別の正常なデバイスに優先的にコピーし、バックアップが成功したことを確認します。
4. データセキュリティを確保した後、クローン/イメージに対して修復またはベンダー診断を実行します。

これまでのところ、書き込み操作は行われていません。
「`」

### 例 5: 権限制限による不完全な結果

**入力例**

```テキスト
ハードウェア監査の結果が「不完全」と表示されるのはなぜですか？私のコンピューターは故障しているのでしょうか？
「`」

**出力例**

```テキスト
いいえ。INCOMPLETEは、現在のセッションで1つ以上のWindowsデータプロバイダーが利用できないことを示します。たとえば、アクセス権限の制限、アクセスできないイベントログ、またはデータを公開しないストレージインターフェイスなどが原因です。

これは、健康状態やハードウェアの故障を意味するものではありません。まず、MissingSectionsを確認してください。必要に応じて、権限昇格によってどのようなデータを補完できるかを説明し、承認を得た後にプロセスを再実行します。センサーまたはSMARTフィールドが空の場合、「利用不可」としかマークできません。
「`」

## 6. 推奨される使用例

- 新しいコンピュータ、中古コンピュータ、または修理を行う前に、読み取り専用のハードウェアインベントリを作成する。
- Windowsがランダムにフリーズしたり、再起動したり、ブルースクリーンやブラックスクリーンが発生したり、パフォーマンスが急激に低下したりする。
- デバイス マネージャーに、不明なデバイス、黄色の感嘆符、またはコード 10/28/43/45 が表示されます。
- 外付けハードドライブ、USB、グラフィックカード、その他のデバイスが認識されません。
- SSD/HDDの動作が遅くなる、接続が切断される、またはI/Oエラーや異音が発生する。
システムディスクまたはデータディスクの空き容量が不足しています。問題箇所を特定し、クリーンアップする必要があります。
- ドライバーの更新、ロールバック、アンインストールを行う前に、リスクとロールバックの評価を実施する。
- メモリ容量認識異常、メモリエラーの疑い、またはリソース負荷。
バックアップ、移行、ディスク交換、または復旧の検証計画を策定する必要があります。
部品を分解したり交換したりする前に、ソフトウェア、ケーブル、ポート、およびドライバーの問題がないことを確認してください。

7. 一人では不適切または完了できないタスク

- 1つのスナップショットだけでは、ハードウェアが100%正常であることを証明することはできません。
- 通常、Windowsのネイティブインターフェースでは、電源ユニットの電圧、ファン速度、DIMMの温度、またはすべてのGPU/NVMeセンサーを完全に読み取ることはできません。
- 運転免許証の有効期限が切れているかどうかは、日付だけでは判断できません。
- 電源障害は、カーネル電源イベント41のみに基づいて判断することはできません。
- メーカーのオフライン診断、ブートディスクメモリテスト、オシロスコープ、または物理的な修理に代わることはできません。
- BIOS/ファームウェアのアップグレード、ドライバの変更、ディスクの修復、フォーマット、パーティション分割、削除、再起動、または分解は自動的に実行しないでください。
- macOSまたはLinuxのハードウェア診断については責任を負いません。

## 8. セキュリティとプライバシーの境界

以下の操作は、具体的な対象、影響、ロールバック方法、およびバックアップ状況を明示した上で、明確な承認を得て実行する必要があります。

- ドライバーのインストール、更新、ロールバック、またはアンインストール。
- デバイスの有効化/無効化、サービスの変更、またはレジストリの変更。
- BIOS/ファームウェアのアップグレード。
- `chkdsk /f`、`chkdsk /r`;
- パーティション分割、フォーマット、クローン作成と上書き、セキュア消去、BitLockerの変更。
- クリーンアップ項目を削除し、バックアップを上書きします。
- デバイスを再起動、シャットダウン、継続的なストレステストを実行する、または物理的に分解する。

ドライバーは、Windows Update、システム/OEMの公式ウェブサイト、またはデバイスメーカーの公式ウェブサイトからのみ入手してください。サードパーティのドライバー集約サイトや「自動ドライバー更新」ツールは使用禁止です。

デフォルトのスクリプトでは多くのハードウェア識別子が非表示になりますが、JSONにはコンピュータ名、ボリュームラベル、デバイス/モデル名、イベントメッセージの断片が含まれる場合があります。また、ファイルサイズが大きい場合は、ローカルパス全体が含まれてしまいます。レポートを外部システムに送信する前に、2段階目のデータ匿名化処理が必要です。

## 9. よくある質問

### Q1: `HEALTHY_NO_OBVIOUS_FAULTS`は、ハードウェアが完全に正常であることを示していますか？

いいえ。これは、入手可能なデータに明らかな欠陥が見つからなかったことを示すだけです。断続的な問題、未露出のセンサー、負荷がかかった状態での故障、物理的な問題などが依然として存在する可能性があります。

### Q2: 温度、摩耗レベル、またはSMARTフィールドが空欄になっているのはなぜですか？

よくある原因は、Windowsのドライバーまたはハードウェアがネイティブインターフェースにデータを公開していないことです。正しい結論は「データ利用不可」であり、「正常」ではありません。

### Q3: 管理者権限は必要ですか？

基本的なインベントリは必ずしも必要ではないかもしれませんが、一部のイベントログ、ストレージ信頼性カウンター、およびシステムインターフェースには、より高い権限が必要です。スキルによっては、承認を得る前に、権限昇格の目的と影響を説明することが求められます。

### Q4: すべてのドライバーを自動的に更新できますか？

いいえ。まず、問題のあるデバイスとコードを正確に特定し、現在のドライバを記録し、公式ソースから特定のパッケージを照合し、各デバイスごとにロールバックの手順を確立してください。

### Q5: コード43は常にハードウェアの故障を示しますか？

必ずしもそうとは限りません。これは、デバイスに不具合が発生したことを示しており、電源、インターフェース、ファームウェア、ドライバ、コールドブート、および別のポートまたは別のコンピュータからのテスト結果について、さらに確認する必要があることを意味します。

### Q6: ディスクのSMART情報が正常と表示されているのに、なぜまだチェックする必要があるのですか？

SMARTステータスには、すべてのベンダー属性が含まれていない場合や、信頼性カウンターが公開されていない場合があります。また、ディスク障害、フリーズ、I/Oエラー、コントローラのリセット、NTFSイベント、およびベンダー診断情報との相関関係も考慮する必要があります。

### Q7: 大容量ファイルのスキャンでは、ファイルは自動的に削除されますか？

いいえ。スクリプトはファイルの一覧を表示するだけです。エージェントは候補を分類し、必要な容量を見積もり、復旧方法を説明し、正確なリストを作成するために再度承認を得る必要があります。

### Q8: 大きなファイルをスキャンしたときに何も出力されないのはなぜですか?

現在のスクリプトでは、しきい値に一致するファイルがない場合、`[]`ではなく空の出力が返されることがあります。これは通常、一致するファイルが見つからなかったことを示しており、パス、しきい値、およびアクセス権限の確認が必要になる場合もあります。

### Q9: `robocopy /MIR` を直接実行してバックアップを実行できますか？

直接実行することはできません。`/MIR`はターゲット側のファイルを同期的に削除する可能性があります。まず、ソース、ターゲット、削除の仕組み、およびドリルダウンの結果を実証し、明示的な承認を得る必要があります。

### Q10: ハードウェアから異音がしたり、煙が出たりした場合でも、診断を継続すべきでしょうか？

定期テストは中止してください。直ちに個人情報とデータの安全を最優先し、使用を中止して安全に電源を切断してください。電源、モニターの高電圧部分、膨張したバッテリーには触れないでください。

## 10. 現行バージョンの実際の効果とレビュー結果

### 検証済みパフォーマンス

どちらのPowerShellスクリプトも構文解析に合格し、解析エラーはゼロでした。
- ハードウェア監査スクリプトは、権限が不十分な場合に「INCOMPLETE」を返し、データ収集の失敗を正常と誤判断しないように「MissingSections」を提供します。
デフォルトでは、`IdentifiersIncluded=false` に設定されているため、プライマリシリアル番号と PnP ID は非表示になります。
- 大容量ファイルスクリプトは、明示的なパスを厳密に必要とし、削除ロジックを含めずに、読み取りとソートのみを実行します。
- 組み込みのテストケースは、読み取り専用の完全なマシンチェック、ドライバ修復の事前承認、およびバックアップ後のクリーンアップという3つの主要なパスをカバーしています。

制御されたテストにおいて、現在のサンドボックスセッションは複数のWindowsハードウェアデータプロバイダーにアクセスできず、スクリプトは架空のハードウェア診断結果ではなく「INCOMPLETE」を返しました。これは、スクリプトの「明示的なデータ欠落」設計を検証すると同時に、実際の診断の有効性は正常なWindowsセッションと適切なアクセス許可に依存することを示しています。

### 設計上の利点

1. **明確なセキュリティ境界: 読み取り専用の優先順位、ドライバ、ディスク、再起動、および逆アセンブリに対する明確な承認しきい値。
2. 証拠に対する強い意識: 複数のシグナルが相関しており、相関関係を根本原因と誤解しないように繰り返し注意喚起が行われる。
3. **適切なストレージ処理:** ディスクに障害の疑いがある場合は、データ保護を優先し、修復書き込みの実行を最初に行わないようにしてください。
4. **合理的な段階的ロード:** メインプロセスは簡潔で、コンポーネント、ドライバ、ストレージの詳細は独立した参照ファイルに分離されています。
5. **優れたプライバシーデフォルト設定:** 機密性の高いハードウェア識別子はデフォルトでは非表示になっており、正確な照合に必要な場合にのみ有効になります。
6. **自動処理に適した出力**: 監査結果は構造化されたJSON形式で表示され、エージェントによる集計、比較、アーカイブが容易になります。
## 11. まとめ

`windows-hardware-doctor`の強みは「コンピュータの自動修復」ではなく、Windowsハードウェア診断を安全で解釈可能かつ検証可能なエージェントワークフローに変換することにあります。特に、システムクラッシュ、ドライバの不具合、ストレージのリスク、ディスク容量不足といったシナリオに適しており、ドライバの無計画な更新、故障が疑われるディスクに対する`chkdsk /f`の実行、大容量ファイルの直接削除、電源障害の診断にイベントID 41のみに頼るといった、よくある高リスクなエラーを効果的に防止します。