メニュー
自動テストの外側で実物を動かして確かめ、結果を notes/ に記録する。ホスト側は使い捨てプログラム、実機はシリアル、web はブラウザ自動化。テストが通ったあと、完了と言う前に使う。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
compound engineering のステップ。ひとつの作業のあとに短く振り返り、学んだことを CLAUDE.md・スキル・hoard に畳み込む。意味のある作業の終わりごとに使う。
実機をシリアル越しに操作して挙動を確認する。tools/deck.py で JSON Lines を投げ、人間にしかできない確認は手順書にして渡す。ビルドが通ったあと、動いたと言い切る前に使う。
arduino-cli でファームをビルド／書き込みする。ボード設定、ライブラリのバージョン固定、書き込み時の注意をまとめてある。ファームを触ったあと、実機で確かめる前に使う。
git の混乱を収拾し、履歴を手術する。コミットの取り消し・書き換え、conflict の解消、reflog からの復旧、git bisect による退行の特定。
新しく分かった小技を、動く最小例として hoard/ に保存する。非自明なことを初めて解決したあとに使う。
アルゴリズムや仕組みを、単一 HTML のインタラクティブ／アニメーション付きページで説明する。文章だけでは腑に落ちないときの認知的負債の返済に使う。
| name | manual-test |
| description | 自動テストの外側で実物を動かして確かめ、結果を notes/ に記録する。ホスト側は使い捨てプログラム、実機はシリアル、web はブラウザ自動化。テストが通ったあと、完了と言う前に使う。 |
テストが通ったことは、意図どおり動くことを証明しない。実物を動かす。 対象ごとに手段が違う。
ホスト側の純ロジック — /c/tmp に使い捨ての .cpp を書き、zig でコンパイルして
実行する。プロジェクトには置かない。
uv run python -m ziglang c++ -std=c++17 \
-I firmware/core2-deck/src/core /c/tmp/try.cpp \
firmware/core2-deck/src/core/*.cpp -o /c/tmp/try.exe && /c/tmp/try.exe
ArduinoJson を使うなら -I "$(arduino-cli config get directories.user)/libraries/ArduinoJson/src"
を足す。
実機 — /device-check を使う。シリアルで叩ける範囲は全部自分で叩き、
物理操作と目視は手順書にして人間に渡す。
設定ページ — uv run python -m http.server 8000 --directory web で配信し、
ブラウザ自動化で開く。スクリーンショットを撮って自分の目で見る。
レイアウト、崩れ、要素の重なりは HTML を読んでも分からない。
コンソールエラーも読む。
/red-green-tdd で直す。恒久的な自動テストに
落ちるところまでやって完了。notes/<topic>.md に。コマンドとその実際の出力を貼る。出力を手で
書かない（希望を書いたものは記録ではない）。uvx showboat が使える環境なら
showboat exec を使うと確実。スクリーンショットは notes/ に置いて参照する。