القائمة
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、文書、実測値で裏付けるべき値を追加または変更するときに使う。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| 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。hid-nintendo.c。joycontrol の実装メモと挙動。docs/hardware-test-log.md の記録。次を追加または変更する前に監査する。
監査した値ごとに次を記録する。
大きな判断は関連する spec または work unit record に記録する。
upstream 調査や外部資料の要約は spec/references/ に分けてよい。
完了判定に必要な根拠は work unit record にも残す。
小さな観測や先送り事項は spec/dev-journal.md に記録する。
実機測定値は docs/hardware-test-log.md に記録する。
vendor/btstack を直接変更しない。監査の最後には次の形式を置く。
### 根拠監査
| 項目 | 値 | 根拠 | source | status |
|---|---:|---|---|---|
### 未解決事項
- ...
swbt-daemon の TDD Test List から 1 item だけを選び、CMake/CTest/just で red、green、必要な refactor を 1 cycle 進める skill。Codex が失敗する C test を追加し、最小実装で通し、refactor-done / refactor-skipped を含む work unit record の TDD status を更新するときに使う。
swbt-daemon の source / use case から観測可能な TDD Test List を作成または更新する skill。Codex が TDD の最初の分析、テストシナリオ、expected behavior、edge case、regression、characterization、hardware-gated item を実装前に洗い出すときに使う。work unit record の起点 / ユースケースから test item を作る。
swbt-daemon の TDD green 後に、観測可能な振る舞いを変えずに小さな構造変更を行う skill。Codex が TDD one cycle の refactor phase、green 後の重複整理、命名改善、責務境界の整理、test fixture の読みやすさ改善、または refactor-done / refactor-skipped の判断を行うときに使う。
CMake、Ninja、CTest、sanitizer preset、work unit record の source / use case / TDD Test List を使う swbt-daemon の TDD orchestration skill。Codex が TDD、ユースケースからの TDD test list 作成、red/green/refactor、green 後の refactor-done / refactor-skipped 判断、tidy-first 判断、Test Desiderata review、C unit test 追加、Switch packet behavior の characterization、protocol/IPC behavior の実装を求められたときに使う。必要に応じて tdd-test-list、tdd-one-cycle、refactor-after-green、tidy-first、test-desiderata-review に分岐する。
swbt-daemon の work unit record を作成、更新、完了する。Codex が source、use case、work unit の範囲定義、関連 spec/docs の参照、TDD list、根拠監査状態、検証結果、実機実行条件、先送り事項、チェックリストを work-units/wip または work-units/complete に記録するときに使う。source には user request、roadmap TODO、journal entry、deferred item、bug、実機観測、根拠監査 finding、既存 spec の未解決事項を含む。
Kent Beck の Test Desiderata に基づいて swbt-daemon の test の価値と trade-off をレビューする skill。Codex が CTest、characterization test、hardware-gated test、TDD で追加した test の品質、脆さ、実機未検証リスクを確認するときに使う。