toppers-skills

TOPPERS系RTOS（ASP/ASP3/FMP3/HRP3 等 ITRON系）の不具合診断・動作検証のための切り分けskill（実装非依存）。ハードフォルト／ハング／タスクがディスパッチされない／優先度逆転／スタックオーバーフロー／サービスコールが想定外の `E_*` を返す、といった症状を原因へ辿るとき、カーネルのトレース/ログ機能で実行を観測するとき、GDBのOS Awareness（タスク一覧・状態）を使うとき、機械判定（TAP等）のテスト失敗を切り分けるとき、TTSP3（TOPPERSテストスイート）で適合性を確認するとき、FMP系（マルチプロセッサ/SMP）でPE間・遅延ディスパッチ枝やサブ優先度・割込みアフィニティのテスト設計やカバレッジ差を考えるとき、SMPの間欠ハング／タイミング依存レースを決定的に再現したいとき、ホストOS上で擬似実行する移植（POSIX等・タスク＝ホストスレッド）でディスパッチ窓のレース・per-PE状態の汚染・シグナル乗っ取り・lost-wakeup を切り分けるとき、適合性テストの分岐(C1)カバレッジを考えるとき・gcov が効かない手書きアセンブリ（`.S`：起動/コンテキスト切替/割込み・例外入口）の命令/分岐網羅を実行トレースで測るとき・タスクから踏めない実行時コンテキスト（アイドル＝実行中タスク無し等）の防御/復帰経路へ正規フック点を流用してカーネル無改変で到達させたいとき、実行時間分布(histogram)やサイクルカウンタでコンテキストスイッチ/サービスコールの所要時間を計測するとき・エミュレータ(QEMU等)でサイクルカウンタが0/一定になる現象を切り分けるとき、`E_CTX`/`E_PAR`/`E_ID`/`E_OBJ`/`E_RLWAI`/`E_QOVR` 等がなぜ出るかを調べるときに使う。ユーザが「ハードフォルト」「動かない」「ハングした」「間欠ハング」「タスクが動かない」「優先度逆転」「レースを再現」「POSIXシミュ」「ホストシミュレーション」「なぜこのエラー」「OS Awareness」「TTSP3」「テストが落ちる」「カバレッジ」「分岐網羅」「アセンブリのカバレッジ」「到達不能な経路」「アイドル中フック」「性能計測」「実行時間分布」「サイクルカウンタ」「QEMUでカウンタが0」、また TrustZone-M / dual-OS（Secure

TOPPERS系カーネル（ASP/ASP3/FMP3/HRP3 等 ITRON系RTOS）の「カーネル・アーキ・ターゲット側」を扱う作業の共通規約。上流TOPPERSを追従する派生カーネルを保守するとき、`arch/`・`target/`・`syssvc/` のアーキ/ボード依存部を実装・編集するとき、新ターゲットへ移植するとき、上流の新バージョンとマージするとき、静的API構造（`kernel_api.def`）やコンフィギュレータ（cfg）を扱うとき、カーネルをビルド・テストして検証するときの「やってよいこと/いけないこと」と作業順序を示す。ユーザが「TOPPERS」「カーネルを直す」「移植」「上流マージ」「ターゲット依存部」「アーキ依存部」「cfg」「静的生成」と言ったときに発動。**アプリ（タスク・セマフォ等）のCコードや`.cfg`記述を書くときは別skill `toppers-asp`。実装・トレース・テストの具体コマンドはリポジトリ固有（各リポジトリの `AGENTS.md`/`docs` や専用skill）に従う。本skillは実装非依存の共通規約。**

TOPPERS/ASPカーネル向けのアプリケーションプログラム（タスク・割込みハンドラ・周期ハンドラ・セマフォ・イベントフラグ・データキュー・ミューテックス・固定長メモリプール等）の作成・編集・レビュー時に必ず使うこと。`.cfg`（システムコンフィギュレーションファイル）を扱うとき，`CRE_TSK`/`CRE_SEM`/`CRE_FLG`/`CRE_DTQ`/`CRE_CYC`/`CRE_ALM`/`ATT_ISR`/`DEF_INH`/`ATT_INI` などの静的APIを書くとき，`act_tsk`/`wai_sem`/`set_flg`/`snd_dtq`/`loc_mtx`/`dly_tsk`/`slp_tsk` などのサービスコールを使うとき，`kernel.h`/`t_syslog.h`/`t_stdlib.h` をインクルードするとき，`syslog(LOG_NOTICE, ...)` や `SVC_PERROR()` を使うとき，ITRON仕様準拠のRTOSコードを書くときも対象。ユーザが「TOPPERS」「ASP」「ITRON」「RTOS」「リアルタイムOS」「組込み」「STM32 + ASP」「タスクを作って」「割込みを登録して」「周期実行したい」と言ったときに発動すること。FreeRTOSやZephyrからの移植，μITRON系コードのレビューもこのskillの対象。