メニュー
swbt-daemon の設計観測、未解決事項、先送りタスク、根拠監査メモ、report-rate finding、BTstack integration observation、実機以外の bring-up 判断を spec/dev-journal.md に記録し、後続 work unit / spec の source として扱う。Codex が memo、journal、follow-up の記録、先送り判断の記録、work unit record や spec にするほどではない小さな観測の保存、または journal entry から work unit / spec への昇格判断を求められたときに使う。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
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 の品質、脆さ、実機未検証リスクを確認するときに使う。
| name | dev-journal |
| description | swbt-daemon の設計観測、未解決事項、先送りタスク、根拠監査メモ、report-rate finding、BTstack integration observation、実機以外の bring-up 判断を spec/dev-journal.md に記録し、後続 work unit / spec の source として扱う。Codex が memo、journal、follow-up の記録、先送り判断の記録、work unit record や spec にするほどではない小さな観測の保存、または journal entry から work unit / spec への昇格判断を求められたときに使う。 |
spec/dev-journal.md に簡潔な設計観測を追記するときに、この skill を使う。
journal entry は、後続 work unit または spec の source になり得る。work unit、spec、TDD Test List の作成順序は spec/operations/work-unit-spec-tdd-flow.md に従う。
spec/dev-journal.md に書く。
ファイルが存在しない場合は次を作る。
# 開発ジャーナル
swbt-daemon の設計観測、未解決事項、先送り判断の記録。
末尾に記録を追記する。
## YYYY-MM-DD: <題名>
### 現状
<現時点で成り立っていること>
### 観測
<わかったこと、または未解決のこと>
### 判断
<判断、workaround、再検討条件>
記録は事実ベースにする。 根拠の説明に必要な場合を除き、12行以内を目安にする。
docs/hardware-test-log.md を使う。記録が実装作業になった場合は、journal entry を source として扱い、use case または観測したい振る舞いへ変換してから work-unit-record を使う。作成する work unit record には、参照元の journal entry と、source から use case へ変換した判断を残す。
複数の work unit から参照される判断になった場合は、spec-page を使って spec page を作る。作成する spec page には、参照元の journal entry を根拠として残す。