メニュー
Guard skill for the WebRTC repo. Keep useStreamReceiver.js as a thin orchestrator. Do not add feature logic, polling, timers, Maps, DOM search helpers, or monitoring state there. Put feature logic in sub composables or services instead.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
WebRTC のローカル音声ノイズ抑制を、安全な最小差分で導入・修正するための Skill。現行の実動作 mode は standard / suppressor とし、次の拡張候補は rnnoise とする。
変更差分の妥当性と検証の正確性を担保し、実行したことと未実行のことを混同せずに完了報告するための Skill。
UI の見た目、文言、表示有無、補助説明を、既存ロジックを壊さず最小差分で修正するための Skill。
DTLN ベースの音声抑制を扱う場合だけ、適用条件と制約を明確にして誤採用を防ぐための Skill。現行では既定提案にしない。
WebRTC の音声抑制トグル変更後に、実装実態と UI 表示、フォールバック、相互音声が一致しているかを確認するための Skill。
単独 AudioWorklet + WASM 配信構成を扱う場合だけ、適用条件と制約を明確にして誤採用を防ぐための Skill。現行では既定提案にしない。
| name | webrtc-orchestrator-guard |
| description | Guard skill for the WebRTC repo. Keep useStreamReceiver.js as a thin orchestrator. Do not add feature logic, polling, timers, Maps, DOM search helpers, or monitoring state there. Put feature logic in sub composables or services instead. |
この Skill は、useStreamReceiver.js を orchestrator として維持するためのガードである。
WebRTC の機能追加や不具合修正のたびに、
が useStreamReceiver.js に流れ込みやすい。
この Skill は、それを防ぎ、
useStreamReceiver.js を「配線と順序制御」に限定することを目的とする。
次のような依頼で使う。
useStreamReceiver.js に新しい処理を足したくなった特に、次のような変更では必ず意識する。
setInterval / setTimeoutgetAudioLevel() のような定期 pollingMap / Set を使う feature stateuseStreamReceiver.js は orchestrator のまま維持するuseStreamReceiver.js の責務は次に限定する。
useStreamReceiver.js に置かない次は useStreamReceiver.js に置いてはいけない。
Map / Set / 状態テーブルによる監視管理新しい機能や復元処理の本体は、次のどれかへ置く。
判断基準は「その責務がどこに最も近いか」で決める。
useStreamReceiver.js に追加してよいのは原則として次だけである。
useStreamReceiver.js に置いてよいものuseXxxSession() の呼び出しuseXxxSession() に渡す callbackuseStreamReceiver.js に置いてはいけないものstartXxxMonitor()stopXxxMonitor()findXxxElement()applyXxxEffect()computeXxxState()readXxxLevel()setInterval(() => ...)setTimeout(() => ...)new Map()new Set()新しい処理をどこへ置くか迷ったら、次の順で考える。
useStreamReceiver.js に最小 bridge を置くuseStreamReceiver.js に本体を書き始める前に、
「これは bridge か、feature 本体か」を明示的に判定する。
feature 本体なら、useStreamReceiver.js には置かない。
話者ハイライトを戻すために useStreamReceiver.js に以下を追加する。
SPEAKING_POLL_INTERVAL_MSSPEAKING_LEVEL_THRESHOLDspeakingMonitorsfindTileContainerByMemberIdapplySpeakingHighlightstartSpeakingMonitorstopSpeakingMonitorこれは orchestrator への責務逆流である。
remote attach のたびに、useStreamReceiver.js で feature 専用 wrapper を増やし続ける。
attachRemoteWithSpeaking()attachRemoteWithBadge()attachRemoteWithSomethingElse()小さく見えても、feature ごとの橋渡し wrapper が増殖すると orchestrator が太る。
「今回は最小修正だから」という理由で、sub composable を作らずに監視本体を直書きする。
最小差分と責務逸脱は別問題である。 最小差分でも、置き場所は正しくなければならない。
話者ハイライトの監視本体を useSpeakingHighlightSession.js に置く。
useStreamReceiver.js 側では、
だけを行う。
remote publication に密接な処理なら useRemotePublications.js に寄せる。
は remote 側責務として閉じられるならその方が自然である。
編集前に必ず次を整理する。
useStreamReceiver.js に必要なのは bridge だけかuseStreamReceiver.js の差分が小さいuseStreamReceiver.js に新規定数が増えるuseStreamReceiver.js に監視 helper が増えるuseStreamReceiver.js に DOM 探索処理が入るuseStreamReceiver.js に feature 専用 state が増える変更後は次を確認する。
useStreamReceiver.js に feature 本体が入っていないか必要なら次を先頭に付ける。
useStreamReceiver.js は orchestrator のまま維持することuseStreamReceiver.js に置かないことuseStreamReceiver.js には import / 初期化 / callback配線だけを許可する完了時は必ず簡潔に次を報告する。
useStreamReceiver.js に追加したのが配線だけかどうかuseStreamReceiver.js に「とりあえず書く」を許さない。
新機能の本体は、必ず下位へ置く。