القائمة
自動テストの外側で実物を動かして確かめ、結果を 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/ に置いて参照する。