| name | source-audit |
| description | swbt-daemon の BTstack、Nintendo Switch HID、Linux hid-nintendo、joycontrol、実機ログを監査する根拠監査ワークフロー。Switch protocol 定数、HID report、subcommand、SPI address、rumble packet、report timing、BTstack source selection、WinUSB/libusb バックエンドの挙動など、upstream code、文書、実測値で裏付けるべき値を追加または変更するときに使う。 |
根拠監査
Switch HID、BTstack、Bluetooth アダプターの挙動を swbt-daemon の事実として扱う前に、この skill を使う。
根拠の分類
根拠は次のいずれかとして記録する。
| 分類 | 意味 |
|---|
source fact | upstream source、文書、固定済み commit で直接確認した事実。 |
implementation fact | 既存の swbt code またはテストで確認した事実。 |
hardware observation | Nintendo Switch 実機または Bluetooth ドングルで測定した値。 |
inference | 事実から推論したが、直接検証していない内容。 |
unverified hypothesis | もっともらしいが、安定した契約として実装してはいけない未検証仮説。 |
これらの分類を混同しない。
reverse engineering note の値とローカル実機で測った値は、別の根拠として扱う。
優先する参照元
できるだけ次の参照元を使い、可能なら path、URL、commit、line を記録する。
- 親リポジトリが固定している
vendor/btstack の source と documentation。
- dekuNukem の Nintendo Switch reverse engineering notes。
- Linux
hid-nintendo.c。
joycontrol の実装メモと挙動。- swbt の実機検証で作成した
docs/hardware-test-log.md の記録。
- packet layout や daemon の挙動を characterise するローカル swbt test。
監査が必要な変更
次を追加または変更する前に監査する。
- HID descriptor bytes。
- input report ID、output report ID、report packing。
- subcommand ID と response payload。
- SPI flash address と返却 data。
- rumble packet layout。
- report period の default と fallback value。
- BTstack source file list と port selection。
- WinUSB/libusb バックエンドの仮定。
- daemon、BTstack、Switch protocol の境界をまたぐ magic number。
記録ルール
監査した値ごとに次を記録する。
- 値と意味。
- 根拠の分類。
- source path または URL。
- source commit、version、tag。
- 行番号。取得できる場合だけでよい。
- その値が stable、configurable、hardware-observed only のどれか。
- 根拠が不足している場合の追加確認。
大きな判断は関連する spec または work unit record に記録する。
upstream 調査や外部資料の要約は spec/references/ に分けてよい。
完了判定に必要な根拠は work unit record にも残す。
小さな観測や先送り事項は spec/dev-journal.md に記録する。
実機測定値は docs/hardware-test-log.md に記録する。
安全ルール
- work unit が submodule fork または upstream patch の必要性を明示的に判断していない限り、
vendor/btstack を直接変更しない。
- source または characterization test がない Switch protocol constant を実装に埋め込まない。
- 測定根拠と fallback behavior の記録がない限り、report rate を固定の実機事実として扱わない。
- OS、ドライバー、ドングル、Switch firmware、BTstack commit が異なる実機観測を、差分の記録なしに混ぜない。
出力
監査の最後には次の形式を置く。
### 根拠監査
| 項目 | 値 | 根拠 | source | status |
|---|---:|---|---|---|
### 未解決事項
- ...
